查询某个谷歌地图商家的照片分类(相册标签),每个分类返回名称和哈希值。

查看 谷歌地图数据 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 功能

一个商家的相册标签 一次 GET 请求即可返回商家拥有的全部照片分类,测试调用返回 12 个条目,客户端无需先请求照片,就能知道相册的整体结构。
每个条目带名称和哈希 每个分类都有可读的 name 和一个 hash。接口文档指出,这个 hash 就是商家照片接口 category 参数所需的取值。
分类名称因商家而异 测试的餐厅除了 Menu、Vibe、By owner、Videos 等通用分类,还列出了 Chimichanga、Cobb salad、Margarita 等菜品标签,说明不同地点的分类并不相同。
只需一个必填参数 只有 business_id 必填,可传谷歌地图 ID、CID 或 place ID。测试调用使用的是 0x...:0x... 格式,另外两种格式依据接口文档说明。
可选的地区与语言参数 请求中可以加上 country 和 lang。测试调用两者都没有传,因此它们对返回分类名称的影响尚未验证。
轻量的探测型调用 响应只包含 name 与 hash 配对,外层是 status、request_id、data、request_params 结构,体量很小,适合按商家缓存。

在线 API 演示

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

使用场景

常见问题

照片分类接口返回什么内容?

返回一个 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 数组。这一结构来自公开文档,并非测试调用的结果,我们也没有探测过失败请求。

相关接口

相关指南

查看订阅方案 →