通过商家 ID、CID 或 place ID 获取单个商家完整的 Google 地图详情记录。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →返回单个 Google 地图商家的详情记录。必填参数 business_id 可以是 Google 地图 ID(0x...:0x... 形式)、数字 CID 或 ChIJ... 形式的 place ID,还可以选择性设置 country 和 language。接口返回 JSON 对象,包含 status(成功时为 true)、request_id、data 对象以及回显的 request_params。实测中(用 0x...:0x... ID 查询一家酒店),data 包含:标识字段 google_id、google_mid、place_id 和 cid;name、status、address、full_address 以及 detailed_address 明细(district、street、city、zip_code、state、country);main_category、category_id 和 categories;latitude、longitude、global_plus_code、compound_plus_code 和 time_zone;owner_name、owner_id 和 place_url;website_url、website_domain、phone 和 full_phone;以及 rating、reviews_count、reviews_per_rating、reviews_top_terms、reviews_sample、photos_sample 和 featured_photo。这家酒店的 working_hours、popular_times、menu_url、reservation_url、order_online_url、price_range、competitors 和 posts_sample 均为 null,而 hotel_about、hotel_descriptions 和 hotel_stars 有值,因此其他类型的商家也要预期与类别相关的字段可能为 null 或缺失。CID 和 place ID 这两种输入形式来自接口文档,实测中并未使用。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/business-details API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/business-details?key=<API_KEY>&business_id=0x89c25990830633d3%3A0x3ec3c57e2a2fe39a'
查询结果
使用场景
- 对已通过前置筛选的候选名单,只为入围商家补全电话、网站和类别信息,控制调用量
- 在目录站或平台上线某个场所之前,核对其地址、营业状态和坐标是否准确
- 按月刷新已存储的商家档案,及时发现联系方式、类别或营业状态的变化
- 做竞品监控:对比竞争对手在两个日期的评分、评论数和档案字段差异
- 以搜索或联想结果中的商家 ID 为起点,填充 CRM 记录或门店查找数据库
常见问题
business_id 可以传哪些格式的 ID?
文档列出了三种:Google 地图 ID,如 0x89c2585500e85589:0x18f39d1f8ee2a312;数字 CID,如 3132777853886366741;以及 place ID,如 ChIJiVXoAFVYwokREqPijh-d8xg。实测调用使用的是 0x...:0x... 形式,另外两种没有实际验证。
商家 ID 从哪里获取?
搜索和自动补全返回的结果行里带有 google_id 和 place_id,格式与此处一致。详情响应本身也会回显你所查询商家的 google_id、google_mid、place_id 和 cid。
为什么 working_hours、price_range 等字段是 null?
实测中,一家酒店返回的 working_hours、popular_times、menu_url、reservation_url、order_online_url、price_range、competitors 和 posts_sample 都是 null。字段取决于商家类型以及档案公开了什么内容,所以解析代码需要处理 null 值。
这个接口会返回全部评论和照片吗?
不会。reviews_sample 和 photos_sample 只是小样本(实测分别是五条评论和四张照片)。需要完整的、按游标分页的列表,请使用商家评论和商家照片接口。
country 和 language 有什么作用?
二者都是可选的代码参数,例如 us 和 en,文档没有列出可接受的取值。注意本接口把第二个参数拼写为 language,而自动补全和照片接口用的是 lang。
响应外壳是什么样的?
是一个 JSON 对象,包含 status(成功时为 true)、request_id、存放商家字段的 data 对象,以及回显你所发送 business_id 的 request_params。