按 restaurantsId 获取餐厅详情(旧版路径)
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →通过已弃用的餐厅详情路径,获取一家已知 Tripadvisor 餐厅的详情记录。必填的 restaurantsId 字符串按文档说明应取自餐厅搜索结果,可选的 currencyCode 字符串按文档说明应取自货币参考查询,示例值为 USD。已有客户端可以沿用这种请求形式,同时规划迁移到 V2 详情操作;新接入请直接从 V2 开始。该查询只返回单家餐厅的详情,不负责搜索餐厅、列出菜单或受理预订。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。可见部分显示一个包含 hours 和 location 的 data 对象。hours 对象包含 allOpenHours(星期与时间)、currentHoursText、hoursTodayText、openStatus、openStatusText 和 addHoursLink。location 对象包含 address、address_obj(street1、street2、city、state、postalcode、country)、ancestors、category、cuisine、dietary_restrictions、description、display_hours、内嵌的 hours 对象(含 timezone 和由 open_time、close_time 组成的 week_ranges)、latitude、longitude、location_id、location_string、name、neighborhood_info、num_reviews、awards、open_now_text,以及带有多种图片规格的 photo 对象。latitude、longitude、location_id 和 num_reviews 在示例中为字符串。示例在中途被截断,其余字段、错误响应以及 currencyCode 的实际作用均无法确定。可见部分与 V2 示例一致;两者在结构或状态行为上是否存在差异,文档中没有说明,因此切换路径之前请先对比真实响应。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/get-restaurant-details-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-restaurant-details-deprecated?key=<API_KEY>'
查询结果
使用场景
- 盘点仍在调用已弃用餐厅详情路径的现有客户端,列出各自实际读取的响应字段,再规划迁移到 V2。
- 针对一批已知的 restaurantsId,并排对比旧路径与 V2 的响应,记录你观察到的字段、状态或错误差异。
- 在迁移窗口期内保持旧版餐饮指南页面可用,缓存其已在展示的菜系、地址和营业时间字段。
- 在下线旧集成之前,检查已保存的 restaurantsId 是否仍能解析,并显式处理失败,而不是假设两条路径行为一致。
- 用旧路径的返回结果编写回归测试数据,以便用同样的营业时间、地址和菜系字段来测试替代客户端。
常见问题
新接入应该使用这个已弃用的路径吗?
不应该。该操作已标记为弃用,新开发请从 V2 餐厅详情操作开始,它使用相同的 restaurantsId 和 currencyCode 输入。仅在需要维持现有客户端运行,或在迁移期间对比响应时才使用这条旧路径。
restaurantsId 从哪里获取?
参数文档说明 restaurantsId 应取自餐厅搜索结果。本操作不负责发现餐厅,也没有提供示例值,所以请传入你已获得的标识,保持原样并以字符串形式传递。
currencyCode 会改变什么?
currencyCode 是可选参数,按文档说明取自货币参考查询,示例值为 USD。源示例的可见部分没有价格字段,因此它对响应的影响尚未验证。请分别带参数和不带参数测试,并查看实际返回内容。
文档记载了哪些响应字段?
被截断的源示例显示 data.hours 和 data.location。可见字段包括营业状态文本、每周营业时间、地址数据、菜系与饮食标签、坐标、location_id、name、neighborhood_info、num_reviews,以及含多种尺寸的 photo 对象。这些都是未经验证的源示例字段,示例在记录结束之前就被截断。
响应与 V2 操作完全相同吗?
两条路径的源示例可见部分一致,但示例被截断,也没有提供探测响应,所以结构、限制或错误行为是否存在差异无法确定。在用一条路径替换另一条之前,请用你的 restaurantsId 对比真实响应。
经纬度和评价数量是数字吗?
在源示例中,latitude、longitude、location_id 和 num_reviews 都是字符串。请在核对实际响应之后在你自己的代码里解析,并容忍 null 值,因为示例中 bearing、distance 和 street2 等字段就是 null。