通过商家 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 功能

一次请求拿到完整档案 一次 GET 请求就能在 data 对象里拿到某个 Google 地图商家的标识、地址、类别、联系方式、评分和样本等字段。
支持三种 ID 格式 business_id 接受 Google 地图 ID(0x...:0x...)、数字 CID 或 ChIJ... place ID,不同来源的 ID 无需转换即可直接使用。
结构化地址与地理字段 返回 address、full_address 和包含 district、street、city、zip_code、state、country 的 detailed_address 对象,另有 latitude、longitude、plus code 和 time_zone。
联系方式与网络存在字段 包含 phone、full_phone、website_url 和 website_domain,以及 menu_url、reservation_url 和 order_online_url;商家没有对应信息时这些字段为 null。
评分与评论快照 附带 rating、reviews_count、按星级统计的 reviews_per_rating、reviews_top_terms 和少量 reviews_sample,可快速评估商家口碑。
类别专属字段块 酒店类商家会多出 hotel_about、hotel_descriptions 和 hotel_stars,不适用于该商家类型的字段则返回 null。

在线 API 演示

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

使用场景

常见问题

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。

相关接口

相关指南

查看订阅方案 →