获取目的地与入住日期对应的酒店筛选元数据
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 取值关联保存,任何一个值变化时都要让已选的筛选项失效。只展示那些你已检查过返回值及其与酒店搜索映射关系的选项。
这个操作会返回酒店列表或保证可订吗?
不会。这里没有文档化的酒店结果列表。该操作用于获取搜索控件元数据;如需列表请使用酒店搜索。无论筛选元数据还是示例中的日期选择器限制,都不能保证有可预订的库存。