面向本地商家和地点数据的 Maps API
向 POST /maps 发送搜索词（可选附带坐标），即可拿到一页 Google Maps 结果，最多 20 个地点，结构化 JSON 返回。
接口
传入 "coffee shops" 这样的搜索词，可选再加一个地图坐标，就能拿回一页结构化 JSON 地点数据，直接用于筛选、上地图或交给 Agent。
名称、place ID、地图链接、地址、电话、网站。
评分、评论数、营业时间、当前营业状态。
用经纬度和缩放级别指定搜索范围。
适合用于
本地商家线索 / 门店查找 / Agent 出行规划
不用自己写爬虫就能拿到 Google Maps 结果
地图页面是给人看的，用程序采集很麻烦。Maps endpoint 为每个地点返回名称、place ID 和公开的 Google Maps 链接；Google Maps 上有展示时，还会返回地址、电话、网站、类别、评分、评论数、坐标、营业时间和价格区间。没有的字段直接省略，不需要处理占位值。
结构化地点数据
每个地点包含名称、place ID 和地图链接，并在有数据时返回地址、电话、网站、类别、评分、评论数、坐标和营业时间。
按位置搜索
传入经纬度和缩放级别即可围绕某个位置搜索，并可设置国家和语言获取本地结果。
每页最多 20 个地点
每次请求返回一页 Google Maps 结果，最多 20 个地点；带上同一位置即可继续翻页。
按页计费
每个完成的页面消耗 3 积分，包括确认为空的页面；请求失败不扣费。
什么是 Maps API？
Maps API 把 "涩谷 拉面" 这样的地图搜索变成代码能直接用的结构化数据。不用打开 Google Maps 手动复制信息，只需发送搜索词和可选的位置，就能拿回带联系方式、评分和坐标的地点列表。Search1API 每次请求返回一页 Google Maps 结果，取几页、花多少由你决定。
Maps API 价格
每个完成的请求获取一页 Google Maps 结果（最多 20 个地点），消耗 3 积分，确认为空的页面同样计费。技术故障会返回错误且不扣费。max_results 只会截断返回的数量，不会降低价格。新账户赠送 100 免费积分。
每页最多 20 个地点，3 积分。
请求失败不扣费。
每个搜索最多 6 页；第 2 页起需要提供位置。
注册即送 100 免费积分，无需信用卡。
典型流程
向 POST /maps 发送搜索词（可选附带坐标），即可拿到一页 Google Maps 结果，最多 20 个地点，结构化 JSON 返回。
发送搜索词并设置国家和语言；要围绕某个点搜索时，加上纬度、经度和缩放级别。
拿回最多 20 个地点，包含名称、地图链接，以及 Google Maps 上展示的各项详情。
还需要更多？用相同的查询和位置请求下一页，每页都是单独的请求。
适合场景
在 Google Maps 上查找本地商家和地点，以结构化 JSON 返回地址、电话、评分、坐标和营业时间
销售线索：按类别和城市收集商家的电话和网站。
需要地址、坐标和营业时间的门店查找和本地目录。
帮用户规划行程、比较附近选择、回答 "哪里可以……" 的 AI Agent。
常见问题
Maps API 返回哪些数据？
每个地点都有排名、名称、place ID 和公开的 Google Maps 链接。有数据时，还会返回地址、电话、网站、缩略图、类别、评分、评论数、坐标、按星期的营业时间、当前营业状态、价格区间和简短描述。
Maps API 消耗多少积分？
每个完成的页面消耗 3 积分，最多包含 20 个地点，确认为空的页面同样计费。技术故障不扣费。调小 max_results 不会降低价格。
怎么围绕某个位置搜索？
传入包含 latitude、longitude 和可选 zoom（默认 14）的 location 对象。不传 location 时，由 Google Maps 根据搜索词判断范围，所以 "pizza in Brooklyn" 这样的查询也可以。
怎么获取超过 20 个地点？
用相同的 query、country、language 和 location，把 page 设为 2 或更大（最多 6）请求下一页。第 2 页起必须提供 location，每页单独计费。
Maps API 和 Search API 有什么区别？
Search 返回网页，Maps 返回地点，也就是带地址、评分和坐标的商家和兴趣点。如果还要读取商家网站，可以接着用 Crawl。