获取目的地与入住日期对应的酒店筛选元数据

查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →

使用必填的 geoId,加上 YYYY-MM-DD 格式的 checkIn 与 checkOut 日期,请求酒店搜索的筛选元数据。geoId 应取自酒店地点搜索操作返回的结果,并在这里保持为必填的字符串输入。该操作没有提供探测观测记录。被截断的文档示例显示 data 对象中包含 datePicker 和 filters 数组;这些是仅来自文档的字段,并非已验证的探测结果。示例中的 datePicker 包含 maxAdultsPerRoom、maxChildrenPerRoom、maxRooms、maxStayLength 等配置字段,以及 lastSelectableDate 和 timeZoneOffset。示例中的筛选条目包含 name 和 title、嵌套的 filters,部分条目还带有 minValue、maxValue、selectedRangeStart 和 selectedRangeEnd。在展示筛选控件或把取值映射到酒店搜索参数之前,请先检查实际返回的结构。不要根据示例硬编码通用的筛选维度列表、数值上限、可选日期或取值编码。当目的地或任一住宿日期变化时,应刷新或作废已缓存的选项。本接口描述的是搜索控件,不返回酒店结果列表,也不能确认房间可以预订。

API 功能

按目的地发现筛选维度 使用地点搜索得到的 geoId 和两个住宿日期,请求该搜索场景下的筛选元数据。该操作没有提供成功的探测记录。
文档中的日期选择器设置 未经验证的示例包含 datePicker.configuration 的各项上限,以及 lastSelectableDate 和 timeZoneOffset,可以让日期选择器的集成基于已检查的字段来设计,而不是依赖固定假设。
检查嵌套筛选分组 文档示例中的 data.filters 条目带有名称、标题和嵌套的 filters。在把任何分组接入酒店搜索控件之前,请先检查返回的取值。
按场景缓存筛选结果 以 geoId、checkIn、checkOut 组合作为筛选缓存的键。场景变化时丢弃已选的筛选项,不要把另一次住宿的控件拿来复用。

在线 API 演示

GET /api/project/tripadvisor-data/get-hotels-filter

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-hotels-filter?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&geoId=<geoId>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

获取酒店筛选元数据需要哪些输入?

geoId、checkIn 和 checkOut 都是必填字符串。请通过酒店地点搜索获取 geoId,并以 YYYY-MM-DD 格式提供两个日期。该操作没有声明成人、房间或货币参数。

筛选响应有没有经过已保存的探测验证?

没有。该操作没有提供探测观测记录。其响应字段说明来自一份被截断的文档示例,集成之前应对照实际响应进行核实。

文档示例中展示了哪些响应字段?

示例显示了 data.datePicker 和 data.filters。datePicker 包含 configuration、lastSelectableDate 和 timeZoneOffset。筛选条目包含 name、title、嵌套的 filters,部分条目还有区间相关字段。这并不是经过验证的完整响应结构。

所有目的地和日期范围可以复用同一组筛选项吗?

不要这样假设。请把元数据与其 geoId、checkIn、checkOut 取值关联保存,任何一个值变化时都要让已选的筛选项失效。只展示那些你已检查过返回值及其与酒店搜索映射关系的选项。

这个操作会返回酒店列表或保证可订吗?

不会。这里没有文档化的酒店结果列表。该操作用于获取搜索控件元数据;如需列表请使用酒店搜索。无论筛选元数据还是示例中的日期选择器限制,都不能保证有可预订的库存。

相关接口

相关指南

查看订阅方案 →