查询某个谷歌地图商家的照片分类(相册标签),每个分类返回名称和哈希值。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →返回某个谷歌地图商家相册中的全部照片分类。必填参数 business_id 支持谷歌地图 ID(形如 0x...:0x...)、数字 CID 或 ChIJ... 格式的 place ID,另可选填 country 和 lang。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、data 数组以及回显的 request_params。在只传 business_id 的实际测试调用中,data 返回了 12 个条目,每个条目都有 name 和 hash。测试中出现的分类名称有 All、Menu、Food & drink、Vibe,五个菜品标签(Chimichanga、Cobb salad、Quesadilla、Egg roll、Margarita),以及 By owner、Street View & 360 degrees 和 Videos,可见分类列表因商家而异,并不是固定集合。接口文档说明,hash 可作为商家照片接口 category 参数的取值;本次测试没有把两个请求串联起来验证。该接口只返回分类,不返回任何照片。接口文档中公布的响应示例是空对象(422 时为带 detail 条目的校验错误结构),因此上述字段均来自实际测试调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/business-photos-categories API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/business-photos-categories?key=<API_KEY>&business_id=0x863f7e635e3bc389%3A0xfd99687094131d65'
查询结果
使用场景
- 在请求照片之前先确认商家实际有哪些相册标签,避免对空分类发起无意义的调用
- 根据返回的分类名称,在商家页面上渲染照片分类筛选按钮
- 判断一家餐厅是否有 Menu 分类,决定是否值得把菜单图片送去 OCR,提取菜品名称和价格
- 审计客户的商家资料,找出缺少 Videos、Vibe 或 By owner 等分类、而周边竞争对手已具备的门店
- 为每个商家一次性建立名称到哈希的映射表,之后每次请求照片时直接复用
常见问题
照片分类接口返回什么内容?
返回一个 JSON 对象,包含 status、request_id、data 数组以及回显的 request_params。在实际测试调用中,data 有 12 个条目,每个条目都有 name 和 hash。该接口只列出分类,不返回任何照片链接。
哪些参数是必填的?
只有 business_id 必填,示例值为 0x863f7e635e3bc389:0xfd99687094131d65。country 和 lang 为可选参数,接口文档没有列出它们的可接受取值。
business_id 支持哪些格式?
文档列出了谷歌地图 ID(0x...:0x...)、数字 CID 和 ChIJ... 格式的 place ID。测试调用只用了谷歌地图 ID 格式,建议先用你自己的 CID 或 place ID 在一个样本商家上试一试。
如何用分类哈希获取照片?
文档说明该哈希是商家照片接口 category 参数的取值,所以请带上同一个 business_id,把哈希传给照片接口即可。本接口的测试调用没有串联两个请求,建议用你自己的商家验证整个流程。
每个商家的分类列表都一样吗?
不一样。测试的餐厅既有通用标签(All、Menu、Food & drink、Vibe、By owner、Videos),也有以菜品命名的标签,说明列表是按商家生成的。目前只探测了一个商家,请不要假定存在固定集合。
business_id 缺失或无效时会怎样?
接口文档给出的是 422 校验错误,带有由 loc、msg、type 组成的 detail 数组。这一结构来自公开文档,并非测试调用的结果,我们也没有探测过失败请求。