按 restaurantsId 获取餐厅详情(V2)
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →通过 V2 餐厅详情路径,获取一家已知 Tripadvisor 餐厅的详情记录。必填的 restaurantsId 字符串按文档说明应取自餐厅搜索结果,可选的 currencyCode 字符串按文档说明应取自货币参考查询,示例值为 USD。适合为已确定的餐厅补全地址、菜系、营业状态和照片数据。它不负责搜索餐厅,也不返回菜单、评价文本或预订功能。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。可见部分显示一个包含 hours 和 location 的 data 对象。hours 对象包含 openStatus、openStatusText、currentHoursText、hoursTodayText、allOpenHours(星期与时间)和 addHoursLink。location 对象包含 name、description、address、address_obj(street1、street2、city、state、postalcode、country)、ancestors、category、cuisine、dietary_restrictions、display_hours、内嵌的 hours 对象(含 timezone 和由 open_time、close_time 组成的 week_ranges)、latitude、longitude、location_id、location_string、neighborhood_info、num_reviews、awards、parent_display_name,以及含 large、medium、original、small、thumbnail 多种规格的 photo 对象。latitude、longitude、location_id 和 num_reviews 在示例中为字符串,另有若干字段在示例中为 null。示例在中途被截断,其余字段、错误响应以及 currencyCode 的实际作用均无法确定。在决定展示或存储哪些字段之前,请先检查实际返回结果。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/get-restaurant-details-v2 API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-restaurant-details-v2?key=<API_KEY>'
查询结果
使用场景
- 为精选的旅行餐饮指南补全地址、菜系标签和营业状态,对象是你已持有 restaurantsId 的餐厅,并在核对实际返回内容后再选择展示字段。
- 根据返回的状态文本,在餐厅卡片上显示营业中标识和今日营业时间,并把这些值当作某一时刻的快照,而非预订信号。
- 根据已知餐厅的 latitude 和 longitude 把它标注在地图上,确认两个字段都存在后再将字符串转换为数字。
- 当记录返回了 Vegetarian Friendly、Vegan Options、Halal 或 Gluten Free Options 等饮食标签时,据此筛选已保存的餐厅候选清单。
- 把旧版详情客户端迁移到 V2:沿用相同的 restaurantsId 和 currencyCode 输入,只映射已确认的字段,并显式处理错误。
常见问题
这个 V2 操作会返回餐厅的哪些内容?
被截断的源示例显示一个包含 hours 和 location 的 data 对象。可见字段涵盖营业状态与时间、地址数据、菜系与饮食标签、坐标、标识、周边区域信息、评价数量和照片规格。由于没有提供探测响应,这些字段尚未验证,示例也在完整记录之前就结束了。
restaurantsId 从哪里获取?
参数文档说明 restaurantsId 应取自餐厅搜索结果。本操作不负责发现餐厅,也没有提供示例值,所以请传入你已获得的标识,保持原样并以字符串形式传递。
currencyCode 是必填的吗?它有什么作用?
不是,currencyCode 是可选参数。按文档说明它取自货币参考查询,示例值为 USD。源示例的可见部分没有价格字段,因此它对响应的影响尚未验证。依赖它之前,请对比带参数和不带参数的请求结果。
这个接口能提供菜单、评价文本或预订吗?
现有证据中没有任何菜单、评价文本或预订功能。示例只提供评价数量(num_reviews)和 addHoursLink,没有单条评价。请把本操作当作已知餐厅的资料查询,其他字段都要在真实响应中核实。
应该从已弃用的餐厅详情路径迁移过来吗?
新开发应该使用 V2。旧操作已标记为弃用且输入相同,但两条路径的可见源示例都被截断,也都没有探测响应。切换之前,请用你的 restaurantsId 对比真实响应和错误行为,不要假定两者结构相同。
如何处理字符串形式的数字和 null 字段?
在源示例中,latitude、longitude、location_id 和 num_reviews 都是字符串,而 bearing、distance 和 street2 等字段为 null。请以防御式方式解析数值,标识符保持字符串形式,并确保每个可选字段缺失时也能安全渲染。