查询目的地酒店，准备位置比较数据
查看 Skyscanner 天巡机票与酒店查询 的全部接口 →以酒店目的地 entityId 和未来、有先后顺序的 checkIn/checkOut 发起面向位置展示的酒店查询，可选 adults 与 currency。虽然接口名称带有地图含义，但输入没有任意经纬度、半径或边界框。酒店搜索已观察到 coordinates.lat/lng，但这个独立接口的实际字段与覆盖尚未单独核实，使用前应确认返回是否有坐标。与景点或交通站点的距离由应用自行计算，不把文本街区 distance 当作米数；返回候选也不保证包含周边全部住宿库存。
API 功能
位置查询围绕已选住宿目的地 entityId 指向酒店目的地区域，不是任意坐标点或手机当前位置。
地理候选保留入住日期条件 checkIn/checkOut 与可选成人数、币种对应旅行计划，不将候选当无日期可用库存。
地理展示前确认坐标字段 先核实本接口实际返回的坐标属性，不能只因酒店搜索有坐标便默认本接口同结构。
景点邻近程度由应用计算 当前没有半径过滤，地标距离需另算，文本 distance 不作为数值米数使用。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/skyscanner/hotels-get-nearby-map API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/hotels-get-nearby-map?key=<API_KEY>&entityId=<entityId>&checkIn=<checkIn>&checkOut=<checkOut>¤cy=USD'
curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/hotels-get-nearby-map?key=<API_KEY>&entityId=<entityId>&checkIn=<checkIn>&checkOut=<checkOut>¤cy=USD'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 住宿选址坐标准备：核实实际响应后，整理目的地候选酒店的可用地理位置。
- 酒店与交通位置比较：结合另行获得的站点数据，在应用侧计算候选酒店邻近程度。
- 带入住期的位置候选保存：让住宿坐标和查询日期一起进入旅行计划，避免无条件可用的误解。
- 地标附近住宿筛选：使用独立地理逻辑选候选，不向本接口添加虚构的半径或边界框参数。
常见问题
能用任意经纬度和半径查附近酒店吗？
当前输入仅有目的地 entityId、入住退房日及可选成人数和币种，没有经纬度、半径或边界框参数。应先选定酒店目的地，不因接口名称就假定支持任意坐标范围搜索。
怎样获取酒店坐标并计算到景点的距离？
酒店搜索已测试到 coordinates.lat/lng，但本独立接口的实际字段尚未单独核实，先检查返回坐标再使用。获取景点或交通站点坐标后，由应用计算距离；不要把酒店的文字街区描述 distance 解释为米数，也不要假定候选覆盖附近所有酒店。