按经纬度和搜索词(如行业)列出周边的 Google 地图商家,返回地址、联系方式和评分等字段。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →在给定的搜索中心附近查找地点。必填参数 query 为要找的内容(例如“attorney”),可选的 lat 和 lng 用来指定中心点(示例表单使用 39.9525839 和 -75.1652215),另有 country 和 language 两个代码参数。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、地点数组 data 以及回显的 request_params。实测以 query=attorney 加示例坐标调用,data 中有 20 个地点,每个地点 37 个字段:google_id、google_mid、place_id、cid、name、status(20 个全部为 OPEN)、address、full_address、detailed_address 对象(district、street、city、zip_code、state、country)、main_category、category_id、categories、latitude、longitude、time_zone、phone、full_phone、website_url、website_domain、reservation_url、reservation_domain、按星期给出的 working_hours、rating、reviews_count、featured_photo、about 属性分组、can_claim,以及 owner_name、owner_id 和 owner_profile_url。在抽样的 20 家律师事务所中,hotel_about、hotel_descriptions、hotel_stars、order_online_url、about_descriptions、price_range 和 price_breakdown 全部为 null,reservation_url 在 20 家中有 8 家有值。回显的 request_params 里,lat、lng 和 query 都是字符串。该接口没有 limit、offset、zoom 或 radius 参数,因此返回行数不由调用方控制,实测返回的是 20 条。接口文档称失败时 status 为 false,但没有捕获到失败调用。接口文档附带的响应示例是空对象,因此上述字段都来自实测调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/search-nearby API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/search-nearby?key=<API_KEY>&lat=39.9525839&lng=-75.1652215&query=attorney'
查询结果
使用场景
- 围绕固定中心点按类目扫描(牙医、药房、汽配批发商等),建立本地潜在客户名单,每次调用最多得到 20 个地点
- 为选址工具生成竞争密度面板:统计候选地址周边同类商家的数量
- 本地 SEO 快照:同一个关键词从多个偏移中心点各查一次并记录返回列表,观察结果在街区之间如何变化
- 为房产页面计算周边配套得分,统计同一搜索中心附近的咖啡馆、健身房和诊所数量
- 门店查找器的兜底方案:根据访客坐标列出附近的合作门店或竞争对手门店
常见问题
附近搜索接口会返回什么?
返回一个 JSON 对象,包含 status、request_id、地点数组 data 以及回显的 request_params。实测以查询词“attorney”和示例的费城坐标调用,data 中有 20 个地点,每个有 37 个字段,包括 google_id、place_id、name、address、rating、reviews_count、phone 和 website_url。
哪些参数是必填的?
只有 query 是必填项。lat 和 lng 标为可选,示例表单预填了 39.9525839 和 -75.1652215,但省略它们会怎样文档没有说明也没有测试过,所以请两个都传。country 和 language 是可选代码,可接受的取值没有列举。
会返回多少个地点?怎样获取更多?
实测返回了 20 个地点。接口没有 limit、offset 或 next_token 参数,所以列表长度不由调用方控制。要覆盖更大范围,可以从不同的 lat、lng 中心点重复调用,或者换用不同的 query;该接口的翻页方式文档没有说明。
能设置搜索半径吗?
不能。该接口没有文档化的半径或缩放参数,文档也没有说明会从中心点向外搜索多远。如果需要缩放输入,可以使用查询定位以及“定位并搜索”接口,它们支持 zoom。
怎样获取某个城市的坐标?
用“Philadelphia, PA, USA”这样的文字调用查询定位接口,再把返回的 latitude 和 longitude 作为 lat 和 lng 传入。也可以直接用“定位并搜索”接口,一次请求就完成文字解析和商家列表。实测没有把这条链路完整跑通。
为什么有些字段是 null,比如 hotel_stars 或 price_range?
在抽样的 20 家律师事务所中,hotel_about、hotel_descriptions、hotel_stars、order_online_url、about_descriptions、price_range 和 price_breakdown 全部为 null,reservation_url 有 12 家为空。这些字段很可能会在酒店或餐厅等其他类型的商家上有值,但没有测试过。
返回的 ID 能用于商家类接口吗?
每个地点都有 google_id(0x...:0x... 格式)、place_id(ChIJ... 格式)、google_mid 和 cid。google_id 和 place_id 的格式与商家类接口文档中的 business_id 一致,但实测没有把调用串起来,请在自己的数据上验证这一步交接。
回显的 lat 和 lng 是数字吗?
实测中 request_params 里的 lat、lng 和 query 都是字符串,例如“39.9525839”,尽管 lat 和 lng 声明的是数字。记录日志或做比较时,请按需自行解析。