按 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 功能

面向新接入的当前详情路径 V2 是未被弃用的餐厅详情操作,接受一个必填的 restaurantsId 和一个可选的 currencyCode,是新集成的首选起点。
营业状态文本字段 源示例包含 openStatus、openStatusText、currentHoursText 和 hoursTodayText,另有 allOpenHours 的星期与时间字符串,适合做营业中标识和营业时间面板。
字符串形式的坐标与地点 ID 示例中的 latitude、longitude 和 location_id 以字符串返回,并附带 name、location_string 和 parent_display_name,核对实际数据后再在代码里转换类型。
多规格照片地址 示例的 photo 对象包含 caption、id 以及 images 映射,其中有 large、medium、original、small 和 thumbnail,各自给出 url、width 和 height,便于做响应式卡片。
周边区域与评价数量背景 示例中的 neighborhood_info 列出附近区域名称,num_reviews 给出评价总数,可为已知餐厅补充本地背景,但它并不是评价文本数据流。

在线 API 演示

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

使用场景

常见问题

这个 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。请以防御式方式解析数值,标识符保持字符串形式,并确保每个可选字段缺失时也能安全渲染。

相关接口

相关指南

查看订阅方案 →