查找酒店目的地及其 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 功能

单查询参数的目的地解析 提交必填的查询字符串查找酒店目的地的地点建议,无需提供坐标或入住日期。
观测到的整型目的地标识 成功探测包含整型 geoId 值,可保留下来用于另一次基于目的地的酒店搜索请求。
用于消歧的地点标签 在存在时使用声明的 title 与 secondaryText 字符串,为名称相近的目的地呈现可区分的选项。
直接读取建议数组 观测到的响应把地点对象直接放在顶层 data 数组中,与 status、message 和 timestamp 并列。
酒店流程中的标识分离 把 geoId 作为目的地标识、documentId 作为单独返回的字符串保存;两者都不应被假定为单个酒店的标识。

在线 API 演示

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

使用场景

常见问题

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 直接插入。

这个接口会返回酒店可订情况或确认预订吗?

不会。它只把目的地查询解析为地点建议。酒店搜索、住宿详情以及任何预订或库存确认都是独立的事项。

相关接口

相关指南

查看订阅方案 →