按经纬度搜索周边酒店

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

围绕一对经纬度坐标搜索 Tripadvisor 酒店列表,并指定入住区间。必填查询参数是以字符串传入的纬度与经度,以及 YYYY-MM-DD 格式的入住日期与离店日期。可选参数覆盖成人数、房间数、儿童年龄、页码、货币代码、最低价、最高价、评分、排序,以及以数组形式传入的酒店筛选条件。文档标注的默认页码为 1;可接受的筛选标识、评分含义、排序键与距离单位均未说明。经纬度请传入坐标,不要传入目的地 geoId。 该操作在所提供的证据中没有已观测的探测响应。其未经验证且被截断的源示例在 data.data 中展示酒店卡片,包含字符串形式的 id 与 title、布尔值 isSponsored 与 accentedLabel、含字符串 count 与数值 rating 的 bubbleRating,以及带有 maxHeight、maxWidth 与 urlTemplate 尺寸对象的 cardPhotos 条目。示例中还出现 badge、provider、secondaryInfo 以及可为空的展示字段。该示例里 priceForDisplay、priceDetails、priceSummary、strikethroughPrice 与 primaryInfo 均为空。完整响应信封尚未确立,与其他酒店搜索操作的响应兼容性、实时价格、可预订库存以及明确的搜索半径均不保证。

API 功能

以坐标为中心的酒店发现 用必填的纬度与经度字符串围绕地图上的一个点或场地搜索,不要用目的地 geoId 替代。
入住区间与同行人数控制 以 YYYY-MM-DD 格式提供入住与离店日期,并可选用成人数、房间数与儿童年龄描述本次入住。
面向酒店的筛选数组 请求可接受设施、品牌、档次、优惠、健康安全、街区、风格与类型数组;可接受的标识未在文档中说明。
价格、货币与分页控制 可选用最低价、最高价、货币代码与页码。页码默认从 1 开始,但数值价格结果并不保证返回。
酒店卡片字段的示例参考 一份未经验证的源示例展示了嵌套在 data.data 中的卡片,含评分、图片尺寸元数据与可为空的价格字段;它不是已验证的响应契约。

在线 API 演示

GET /api/project/tripadvisor-data/search-hotels-by-location

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

基于坐标的酒店搜索需要哪些必填输入?

以坐标字符串提供纬度与经度,并以 YYYY-MM-DD 格式提供入住日期与离店日期。该操作不需要目的地 geoId 参数。

可以把目的地 geoId 当作纬度传入吗?

不可以。坐标示例与该操作的纬度/经度组合表明这是基于坐标的搜索。请把目的地 geoId 单独保存,改为传入纬度与经度坐标。

分页、货币与酒店筛选如何使用?

pageNumber 可选,文档标注的默认值为 1。currencyCode 可使用货币查询得到的值,例如 USD。数组筛选、评分与排序均可使用,但其可接受的标识、量纲与排序规则在此未说明。

distFromMaxDistance 的值以公里还是英里为单位?

所提供的证据中没有说明距离单位,也没有说明 distFrom 的含义。在验证这些输入之前,不要假设其中任何一种单位,也不要承诺固定半径。

酒店响应格式或价格可用性是否已验证?

该操作没有记录到探测响应。一份未经验证且不完整的源示例展示了 data.data 中带评分与图片元数据的酒店卡片,但多个价格字段为空。请把这些字段视为示意,而不是已确认的实时报价或完整结构。

相关接口

相关指南

查看订阅方案 →