按地名搜索度假民宿目的地

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

根据用户输入的地名,通过必填的 query 字符串参数查询度假民宿目的地建议。传入城市、地区或国家名称,即可获得候选地点记录,方便民宿类界面让用户选定目的地。该操作只负责解析目的地:不返回民宿房源、价格、可订状态或评价,也不接受日期、入住人数和页码。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。示例中的 data 数组由地点对象组成,字段包括 geoId、locationId、isGeo、localizedName、localizedAdditionalNames、locationV2、placeType、latitude、longitude,以及 thumbnail.photoSizeDynamic 对象(含 maxHeight、maxWidth 和带有 {width}、{height} 占位符的 urlTemplate)。示例中的 placeType 取值有 CITY、STATE、COUNTRY 和 MUNICIPALITY,示例地点包括 New York City、New Orleans、Newport 和 New Zealand。data 之外的外层字段、最大返回条数、排序方式和错误行为,现有证据均无法确定。使用任何字段之前,请先检查实际返回结果,把名称标签当作展示文本;若要把返回的标识传给其他操作,请先在该操作的文档中确认它是否接受这个标识。

API 功能

单一自由文本地名查询 只需一个必填的 query 字符串即可发起查询,没有日期、人数或分页输入,请求体量很小,适合做民宿目的地输入框的实时联想。
地点标识与经纬度 源示例中每条建议都带有 geoId、locationId、latitude 和 longitude。在把它们存为目的地键或地图坐标之前,请先在实际响应中确认这些字段。
按地点类型区分重名 示例条目带有 CITY、STATE、COUNTRY、MUNICIPALITY 等 placeType,以及 localizedAdditionalNames 和 locationV2,有助于区分纽约市与纽约州这类相近名称。
可调尺寸的缩略图模板 每条示例建议都有 thumbnail.photoSizeDynamic,内含 maxWidth、maxHeight 和带 {width}、{height} 占位符的 urlTemplate,调用方按需要的尺寸自行填入即可。
仅限目的地范围 该操作建议的是地点而非房源,不返回民宿列表、房价、可订日历或评价文本,因此只能作为民宿界面的第一步,而不是完整流程。

在线 API 演示

GET /api/project/tripadvisor-data/search-vacation-rental-location

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

query 参数应该传什么?

传入你想作为度假民宿目的地搜索的地名,例如 New York 这样的城市名。该参数是必填字符串。此操作没有其他输入,因此不支持日期、入住人数、筛选条件和分页。

这个接口会返回民宿房源或可订状态吗?

不会。它只是目的地查询。文档记载的用途是为民宿搜索找到地点,源示例中也只有地点记录。如需房源详情、房价或可订信息,请使用度假民宿分类下的其他操作,并查看它们各自的输入要求。

文档记载了哪些响应字段?

被截断的源示例显示 data 数组,其中的对象包含 geoId、locationId、isGeo、localizedName、localizedAdditionalNames、locationV2、placeType、latitude、longitude 和 thumbnail.photoSizeDynamic。由于没有提供探测响应,这些字段尚未验证,示例在可见条目之后也被截断。

返回的 geoId 能直接用于酒店搜索或其他民宿操作吗?

不要想当然。示例中确实有名为 geoId 的字段,但现有证据没有表明每个操作都接受这里返回的标识。在围绕它搭建流程之前,请查阅目标操作的输入文档,并用一个返回值实际测试。

如何把缩略图的 urlTemplate 变成可用的图片地址?

示例中的 urlTemplate 含有字面的 {width} 和 {height} 占位符。请把它们替换成适合版式的像素尺寸,并保持在模板旁 maxWidth 与 maxHeight 的范围内。生成的地址只是可选的展示内容,请兼容没有缩略图的建议项。

为什么结果里除了城市,还可能出现州或国家?

源示例中的条目 placeType 包括 CITY、STATE、COUNTRY 和 MUNICIPALITY,例如 New York City 与纽约州、New Zealand 国家并列出现。请同时展示地点类型和附加名称文本,让用户选择想要的层级,并处理无匹配时返回空列表的情况。

相关接口

相关指南

查看订阅方案 →