按地名搜索度假民宿目的地
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 原型开发度假民宿目的地选择器,把 localizedName 与 localizedAdditionalNames 并排展示,让旅客分清城市和同名的州或国家。
- 在民宿落地页中按 placeType 对联想结果分组,在下拉框里把城市、州和国家匹配项分段呈现。
- 确认实际响应同时包含 latitude 和 longitude 后,将建议的目的地标注在地图上做预览。
- 为目的地卡片配图时,把每条缩略图 urlTemplate 里的 {width} 和 {height} 替换成版式所需的尺寸。
- 在对接其他请求之前,保存每次选择所返回的标识,用来核查有歧义的地名在民宿目录中是如何解析的。
常见问题
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 国家并列出现。请同时展示地点类型和附加名称文本,让用户选择想要的层级,并处理无匹配时返回空列表的情况。