根据不完整的搜索词,获取 Google 地图的地点和地址联想建议。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →针对用户输入到一半的文字,返回最相关的 Google 地图搜索补全结果,适合用在位置搜索框的输入联想场景。必填参数 query 为搜索文本(例如“los ange”),可选参数包括 country、lang 以及 lat/lng 搜索中心。接口返回 JSON 对象,包含 status(成功时为 true)、request_id、存放联想结果的 data 数组,以及原样回显的 request_params。实测中,查询“los ange”返回了五条联想,每条都带有 title、description、google_id、place_id、latitude、longitude、country 和 type;出现过的 type 取值有 locality、establishment 和 geocode。接口文档还提到 street_address、administrative_area_level_1、route、transit_station 和 political 等类型,但实测中没有出现,而且接口没有 type 参数,因此按类型筛选需要在客户端完成。google_id 和 place_id 的格式分别是 0x...:0x... 与 ChIJ...,与商家类接口接受的 business_id 格式一致。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/autocomplete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/autocomplete?key=<API_KEY>&query=los+ange'
查询结果
使用场景
- 在预订、外卖或线索收集表单中做城市或场所联想选择器,并以访客的 lat/lng 作为搜索中心
- 只保留 locality、street_address 或 administrative_area_level_1 这类结果,在客户端搭建仅选地址或仅选城市的选择器
- 把表格里手写的地名先规范成标准联想文本,再解析为坐标或商家 ID
- 为本地黄页或目录站的搜索框提供拼写纠错式提示,用户输入时配合防抖请求展示靠前的补全
- 为区域性电商平台在每次请求中同时带上 country 和 lang,让联想结果贴近目标市场
常见问题
自动补全接口会返回什么?
返回一个 JSON 对象,包含 status、request_id、存放联想结果的 data 数组以及回显的 request_params。实测中查询“los ange”返回了五行结果,每行都有 title、description、google_id、place_id、latitude、longitude、country 和 type。
哪些参数是必填的?
只有 query 是必填项,示例表单使用的值是“los ange”。country、lang、lat 和 lng 都是可选的提示参数,接口文档没有列出它们可接受的取值范围。
能按 locality 或 street_address 这类 type 过滤联想结果吗?
接口没有 type 参数,过滤需要在你自己的代码里完成。每一行都包含 type 字段;实测中出现了 locality、establishment 和 geocode,文档中还提到 street_address 和 administrative_area_level_1。
联想结果怎样配合商家类接口使用?
把该行的 google_id 或 place_id 作为 business_id 传给商家详情或商家照片接口即可,格式与这些接口文档中的说明一致,但实测并未把两次请求串起来,请在你的流程里自行验证。若是城市类结果,则改用其 latitude 和 longitude。
结果只会限定在一个国家吗?
默认不会。实测中美国的洛杉矶和智利的洛杉矶同时出现,所以请读取每行的 country 字段;如果想让结果偏向某个市场,可以传入 country 参数。
每次调用会返回多少条联想?
实测返回了五条。接口没有 limit 参数,所以不要假定固定条数,下拉框按较短的列表设计即可。