按经纬度和搜索词(如行业)列出周边的 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 功能

围绕中心点搜索商家 一个 query 加上 lat 和 lng,一次 GET 请求就能返回该点周边找到的地点,无需自己维护地图会话,也不用浏览器自动化。
37 个字段的地点记录 实测中每一行都带有 37 个字段,涵盖标识、名称、地址、类目、营业时间、联系方式、评分和归属信息,整理线索名单时基本信息无需二次查询。
结构化的地址对象 detailed_address 把每个地点拆成 district、street、city、zip_code、state 和 country,同时还提供 address、full_address 以及用于地图标注的经纬度。
按星期给出的营业时间 working_hours 以周一到周日为键,每天包含一个 working_hours 列表和 usual_working_hours 标记,可直接用于门店查找器里的“正在营业”判断。
评分与评论量一并返回 每个地点都带有 rating 和 reviews_count(实测评分在 4 到 5 之间,评论数从 36 到 7854),可用来按口碑排序或筛选。
每个地点四种标识符 每行都返回 google_id、google_mid、place_id 和 cid,选中的地点可以保存下来再次查询,也能用于商家类接口。
归属人与认领标记 owner_name、owner_id、owner_profile_url 和 can_claim 说明谁在管理该商家页面,以及它是否可被认领(抽样的 20 家全部为 false)。

在线 API 演示

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

使用场景

常见问题

附近搜索接口会返回什么?

返回一个 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 声明的是数字。记录日志或做比较时,请按需自行解析。

相关接口

相关指南

查看订阅方案 →