根据不完整的搜索词,获取 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 功能

不完整关键词也能补全 一次 GET 请求即可把“los ange”这样的片段转成按相关度排序的地点、城市和地址联想。
每条结果自带坐标和 ID 每条联想都带有 latitude、longitude、google_id 和 place_id,选中后可直接上图,或不经二次查询就交给商家类接口使用。
联想类型标签 每行都有 type 字段(实测出现 locality、establishment 和 geocode)以及国家代码,客户端可据此做只选城市、只选场所或只选地址的选择器。
国家、语言与中心点提示 可选的 country、lang、lat 和 lng 参数会影响返回哪些补全结果,实测返回的是五条左右的短列表。
可追踪的响应外壳 data 数组之外还会返回 status、request_id 和回显的 request_params,方便给高频的逐键输入请求打日志并与输入一一对应。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

自动补全接口会返回什么?

返回一个 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 参数,所以不要假定固定条数,下拉框按较短的列表设计即可。

相关接口

相关指南

查看订阅方案 →