按类别筛选并通过游标分页,列出 Google 地图商家的照片和视频。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →返回某个 Google 地图商家下的一页照片和视频。必填参数 business_id 为 Google 地图 ID、CID 或 place ID,可选参数包括 category(来自商家照片类别接口的类别哈希)、country、lang、limit(默认 20)和 next_page_token。接口返回 JSON 对象,包含 status(成功时为 true)、request_id、data 数组、指向下一页的 next_token 以及回显的 request_params。实测中设置 limit=5,data 仍返回了 14 条(10 条 photo、4 条 video),每条都带有 id、url、type、label、max_size(宽和高)、aspect_ratio、video_url、video_duration_ms、user_name、user_id、user_profile_url、user_avatar 和 upload_date_text;部分条目的 label 为 null,video_url 和 video_duration_ms 只有视频才有值。由于实测返回的条数超过了请求的 limit,请把 limit 当作每页条数的参考值,如需精确条数请在客户端截取。获取下一页时,把返回的 next_token 值作为 next_page_token 传入即可。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/business-photos API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/business-photos?key=<API_KEY>&business_id=0x863f7e635e3bc389%3A0xfd99687094131d65&limit=20'
查询结果
使用场景
- 把菜单类别的照片送入 OCR 流程,提取菜品名称和价格
- 为旅游或餐厅页面搭建场所图集,用 next_token 一直翻页,直到取完或达到数量上限
- 按类别逐项对比客户与竞争对手的图片覆盖情况
- 以照片类别作为标签,整理出用于分类模型的带标注图片集(餐食、室内、室外)
- 批量抽查商家档案质量:对一批商家各取第一页照片做抽样检查
常见问题
怎样获取下一页照片?
读取响应中的 next_token,在下一次请求里把它作为 next_page_token 参数传入,同时保持相同的 business_id 和 category。注意响应字段叫 next_token,而请求参数叫 next_page_token。
category 的值从哪里获取?
category 是同一商家在商家照片类别接口(/business_photos_categories)中返回的哈希值。实测时该参数留空,仍然返回了照片和视频混合的结果。
limit 能严格限制返回条数吗?
文档称最多返回 limit 张照片,但实测设置 limit=5 却返回了 14 条,所以请把 limit 当作每页条数的参考值,需要精确条数时在客户端截取。默认值为 20。
列表里会包含视频吗?
会。实测的 14 条中有 4 条的 type 是 video。视频条目会填充 video_url 和 video_duration_ms,照片条目则为 null。
每个照片条目包含哪些内容?
包含 id、url、type、label、以宽高成对形式给出的 max_size、aspect_ratio、video_url、video_duration_ms、user_name、user_id、user_profile_url、user_avatar,以及 upload_date_text(例如“2 years ago”)。
business_id 支持哪些格式?
文档列出 Google 地图 ID(0x...:0x...)、数字 CID 或 ChIJ... place ID。实测调用使用的是 0x...:0x... 形式。