按类别筛选并通过游标分页,列出 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 功能

照片与视频同一列表 每条结果的 type 为 photo 或 video,仅视频带有 video_url 和 video_duration_ms,一次响应即可同时供图片图集和视频片段使用。
按类别提取图集 传入商家照片类别接口返回的类别哈希,即可只拉取该商家的某一类照片,而不是默认的混合集合。
next_token 游标翻页 每次响应都会返回 next_token 游标,把它作为 next_page_token 回传即可继续翻阅体量较大的图集。
上传者署名字段 条目带有 user_name、user_id、user_profile_url、user_avatar 和 upload_date_text,方便标注来源署名并判断照片的新旧。
用于排版的图片尺寸 max_size 给出宽和高,aspect_ratio 已预先算好,网格或瀑布流布局可在图片加载前就预留好位置。
逐条图片标签 许多照片带有简短的 label(实测中是菜品或饮品名称),没有可用标签时为 null。

在线 API 演示

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

使用场景

常见问题

怎样获取下一页照片?

读取响应中的 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... 形式。

相关接口

相关指南

查看订阅方案 →