Google 地图搜索
Google Maps 本地搜索 SERP，覆盖地点查询、坐标定位和地区定向参数。
本页给出 Google 地图搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | Google 地图搜索 |
| 原始名称 | Google Map Search |
| 内部标识（scraper） | google_map |
| 接口标识（engine） | google_map_search |
| 网站 | |
| 网站地址 | Google.com |
| 输出格式 | json |
| 版本 | 1.0.0 |
| 参数数量 | 6 |
| 参数分组 | 搜索词 (1), 地区与语言 (3), 地理位置 (1), 请求控制 (1) |
必填参数
以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。
| 参数 | 类型 | 分组 | 说明 |
|---|---|---|---|
q | string | 搜索词 | 你想让搜索引擎检索的关键词或短语。 |
可用参数
以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。
搜索词
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 你想让搜索引擎检索的关键词或短语。 |
地区与语言
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
gl | string | 否 | 用于本地化搜索结果的国家或地区代码。 |
hl | string | 否 | 用于控制搜索界面和结果标签语言的参数。 |
google_domain | string | 否 | 要请求的 Google 域名，例如 google.com 或 google.co.uk。 |
附加约束
gl：可选值：244 个可选值，例如：af、al、dz、as、adhl：可选值：157 个可选值，例如：af、ak、sq、ws、amgoogle_domain：可选值：185 个可选值，例如：google.com、google.ad、google.ae、google.com.af、google.com.ag
地理位置
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ll | string | 否 | 地图中心点坐标，通常由经纬度组成。 |
附加约束
ll：默认值：@40.7455096,-74.0083012,14z
请求控制
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
no_cache | boolean | 否 | 跳过缓存结果并强制重新抓取。 |
附加约束
no_cache：默认值：false