查找酒店目的地及其 geoId
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →用必填的字符串查询参数把输入的酒店目的地解析为 Tripadvisor 地点建议。用返回的地点信息让出行者选择目的地,然后把其 geoId 与任何单个酒店 id 分开保存。该操作只查找地点,不搜索酒店库存,也不返回单个住宿的详情记录。 一次以 query=New York 发起的成功探测返回 HTTP 200,响应为 JSON 对象,包含布尔值 status、字符串 message、整数 timestamp,以及由地点对象组成的 data 数组。声明的地点字段为 documentId、secondaryText、title 与 trackingItems,出现时均为字符串。该观测响应还额外包含整型 geoId 值。请直接从 data 读取建议,而不是 data.data。未经验证的源示例展示了这些声明字段以及 title 中的 HTML 式加粗标记,但并未确立 geoId;geoId 由观测到的探测结果支持。请把结果标签当作展示内容处理,对有歧义的目的地要求明确选择,并容忍缺失的可选字段。时间戳单位与最大结果数量均未文档化。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/search-location API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-location?key=<API_KEY>&query=<query>'
查询结果
使用场景
- 构建酒店目的地自动补全,把输入的城市名转换为可选择的地点建议。
- 当目的地名称相近时,用 title 与 secondaryText 让出行者自行选择,而不是静默取第一条结果。
- 把所选的整型 geoId 持久化到目的地模型中,供后续酒店搜索请求使用,并与住宿级标识分开存放。
- 编写地点选择适配层,把 data 当作数组读取,并优雅处理缺失的可选标签或空的建议列表。
- 当标签含有源示例所示的加粗标记时,把目的地标题渲染为安全文本或净化后的内容。
常见问题
query 里应该传什么?
以字符串传入目的地名称。记录到的成功探测使用了 New York。该参数为必填;此查询不接受入住日期或坐标。
地点建议在响应的什么位置?
观测到的响应把它们直接放在顶层 data 数组中。不要去找 data.data。同一响应还包含 status、message 与一个整数时间戳。
geoId 是实际观测到的,还是只出现在示例里?
成功探测中观测到了整型 geoId。未经验证的源示例把 documentId、secondaryText、title 与 trackingItems 记录为字符串,但示例本身并未确立 geoId。
返回的 geoId 与酒店 id 或 documentId 是同一个东西吗?
没有证据表明它们等价。请把 geoId 用作基于目的地的酒店搜索的目的地标识,单独保存 documentId,并在请求酒店详情前从住宿结果中取得单个酒店 id。
如何处理有歧义的名称与带格式的标题?
展示可用的 title 与 secondaryText 标签,并在多个目的地可能匹配时要求明确选择。源示例的 title 含有加粗标记,请安全渲染,不要作为不受信任的 HTML 直接插入。
这个接口会返回酒店可订情况或确认预订吗?
不会。它只把目的地查询解析为地点建议。酒店搜索、住宿详情以及任何预订或库存确认都是独立的事项。