把城市或“行业+地点”这类 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 功能

查询文字变成一个地图点 针对查询返回单个包含纬度和经度的位置对象,而不是候选地点列表,一次 GET 请求就能得到可以保存或重复使用的坐标点。
宽泛或精确的查询都能处理 既接受“restaurant in New York City”这样的宽泛说法,也接受“New York City, NY, USA”这样的精确写法;按接口文档,宽泛写法会解析为其中所指的地点。
结果附带缩放级别和海拔值 location 对象还带有 zoom(实测未传 zoom 时也返回了 7)和 altitude 数值,地图客户端可以据此设定初始视野。
可选的区域、语言与中心点输入 country、language、lat、lng 和 zoom 都是可选参数。文档没有详细说明它们对排序的影响,正式依赖之前请先用自己的查询做测试。
回显输入便于对账 request_params 会重复本次调用使用的参数值(实测中只有 query),方便把存下来的坐标与产生它的查询文字一一对应。
输出可直接接入附近搜索 实测返回的 39.9525839、-75.1652215 与附近搜索表单预填的坐标完全一致,因此 latitude 和 longitude 可以直接作为 lat 与 lng 继续传递。

在线 API 演示

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

使用场景

常见问题

查询定位接口会返回什么?

返回一个 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 条目组成。实测调用成功,两种形式都没有观察到,请在客户端里同时处理。

相关接口

相关指南

查看订阅方案 →