把城市或“行业+地点”这类 Google 地图文本查询解析为纬度、经度和缩放级别。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →根据一段查询文字,返回与之最相关的 GPS 坐标,结果是单个位置对象。必填参数 query 可以是宽泛的说法,例如“restaurant in New York City”,也可以是精确的写法,例如“New York City, NY, USA”;另可选填 country、language、lat、lng 和 zoom(按接口文档,缩放范围为 3 到 21,数字越大越放大)。接口文档说明,像“restaurant in New York”这样的查询会解析为纽约本身的坐标,所以返回的是查询所指地点的那个点,而不是商家列表。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、location 位置对象以及原样回显的 request_params。实测中只设置 query 为“attorney in Philadelphia, PA, USA”,location 里包含 id 和 name(均为 null)、altitude(97787.43,文档未说明单位)、latitude(39.9525839)、longitude(-75.1652215)和 zoom(7),request_params 只回显了 query。接口文档称失败时 status 为 false,但没有捕获到失败调用。接口文档附带的响应示例是空对象,因此上述字段都来自实测调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/query-locate API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/query-locate?key=<API_KEY>&query=attorney+in+Philadelphia%2C+PA%2C+USA'
查询结果
使用场景
- 把“coffee shops in Lisbon”这样的说法解析成一个中心点并缓存起来,之后的多次附近搜索都复用同一组坐标
- 在花费一次商家搜索之前先校验用户输入的城市或地区,并把解析出的位置回显给用户确认
- 以解析出的中心点为基准做偏移,生成环形或网格状的搜索中心,对某一类目做覆盖式扫描
- 把 CRM 里杂乱的城市名称列规范成坐标,便于按线索到销售办公室的距离排序
- 根据访客在搜索框里输入的地名,为嵌入式地图设置初始中心点和缩放级别
常见问题
查询定位接口会返回什么?
返回一个 JSON 对象,包含 status、request_id、location 位置对象以及回显的 request_params。实测中 location 里有 id 和 name(均为 null)、altitude、latitude、longitude 和 zoom。它对应的是查询的一个点,而不是商家列表。
哪些参数是必填的?
只有 query 是必填项,示例表单使用的值是“attorney in Philadelphia, PA, USA”。country、language、lat、lng 和 zoom 都是可选的。zoom 在文档中的范围是 3(缩小)到 21(放大),其余可选参数的取值文档没有列举。
它会返回商家吗?
不会。它只返回与查询相关的坐标,例如查询里所指的城市。如果要列出商家,请用这些坐标调用附近搜索,或者使用一次请求就能完成两步的“定位并搜索”接口。
为什么 location 里的 id 和 name 是 null?
实测中两者都是 null,文档也没有说明什么时候会有值。请以 latitude、longitude 和 zoom 为准,id 与 name 要在你自己的查询上再验证。
lat、lng 和 zoom 有什么作用?
文档将它们描述为查询位置的纬度、经度,以及 3 到 21 的地图缩放级别。它们会怎样改变返回的点,实测并未覆盖。注意,即使没有传 zoom,响应里仍然包含了 zoom(7)。
怎样把结果用于附近搜索?
把返回的 latitude 和 longitude 作为 lat 和 lng 传入,再配上“attorney”这样的 query 即可。实测没有把两次调用串成一条链,但“attorney in Philadelphia, PA, USA”返回的坐标与附近搜索表单预填的那一对相同。
失败时会怎样返回?
文档称失败时 status 为 false,并列出了 422 校验响应,其 detail 数组由 loc、msg 和 type 条目组成。实测调用成功,两种形式都没有观察到,请在客户端里同时处理。