LitescrapeLitescrape

Google 地图搜索

/google_maps

搜索 Google 地图地点,或按 ID 获取一个地点。

最近 7 天完成的调用
0

统计不包含取消的调用。执行时间仅统计成功调用。

通过你的 Agent 使用

请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 Litescrape 的 /google_maps 接口。

输入参数

q选填
要搜索的商家、分类、地址或自然语言查询。type 为 search 时必填。例如 coffee shops in Austin、dentist near Denver。
ll选填
完整视口,包含纬度、经度及缩放级别或半径。格式为 @lat,lon,14z 或 @lat,lon,5000m。
location选填
由 API 解析的具名地区,不能与 ll 或 lat/lon 同时使用。必须提供 z 或 m。
lat选填
坐标视口的纬度,必须与 lon 及 z 或 m 一起提供。
lon选填
坐标视口的经度,必须与 lat 及 z 或 m 一起提供。
z选填
location 或 lat/lon 地理参数的 Google Maps 缩放级别。接受 3 至 30,不能与 m 同时使用。
m选填
location 或 lat/lon 地理参数的搜索半径,单位为米。接受 1 至 15,028,132,不能与 z 同时使用。
nearby选填
将所提供的地理参数用于附近搜索范围。必须提供 ll、location 或 lat/lon 对。
data选填
用于搜索筛选或精确地点的 Google Maps protobuf 参数序列。最多 8,192 个字符。精确地点数据要求 type=place。
place_id选填
用于解析精确地点或请求实时客流的 Google 地点标识符。在主 Maps 接口中不能与 data_cid 或精确地点 data 同时使用。在 /api/google/maps/popular-times 中,此项是唯一必填参数。每次响应均实时获取;地点无公开繁忙时段时返回 HTTP 404 not_found,不计费。
data_cid选填
用于解析精确地点的十进制 Google CID。不能与 place_id 或精确地点 data 同时使用。
type选填
选择搜索结果或精确地点响应。查询和筛选搜索时必填。发送精确地点 data 序列时使用 place。
hl选填
Google Maps 标签和返回文本使用的语言,例如 en、es、fr、de。
gl选填
用于结果地区本地化的两位字母国家代码,例如 us、gb、ca、au。
google_domain选填
请求使用的已验证 Google 域名,例如 google.com、google.co.uk、google.ca。
start选填
原生 Maps 结果偏移量:0、20、40 等。每次请求最多返回 20 个地点,每次成功请求消耗一个积分。有 pagination.next 时请使用它,避免手工构造下一请求。
min_price选填
返回地点的最低价格等级。必须非负,且不超过 max_price。
max_price选填
返回地点的最高价格等级。必须非负,且不低于 min_price。
min_rating选填
偏好的最低 Google 评分,Google 将其作为相关性偏好。
open_state选填
按当前营业状态筛选,不能与 open_on_day 或 open_at_hour 同时使用。
open_on_day选填
筛选在指定日期营业的地点。
open_at_hour选填
按 24 小时制筛选在指定小时营业的地点。接受 0 至 23,必须提供 open_on_day。

输入示例

{
  "q": "787 Coffee New York",
  "type": "search",
  "hl": "en",
  "gl": "us"
}

输出

原生 JSON 响应,包含结果分组、分页信息和计费凭据。每次续页请求都是单独一次调用。