联想目的地并获取可复用的 placeId
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →在 query 中输入部分目的地文字,可选 languageCode 和 1 至 5 的 limit。巴黎实测返回 status:true、message:Successful 和 data 建议数组;每条建议含 display_name、explore_search_params.place_id,以及 location 内的 countryCode 和 bounding_box。选中的巴黎 place_id 已成功原样用于住宿和体验搜索。请完整保留该值,不要与独立的 location.google_place_id 混用。目的地建议仅供只读发现,不会预订住宿或活动。
API 功能
可复用的 explore 地点标识 实测 explore_search_params.place_id 无需修改即可用于后续住宿和体验搜索。
有名称的目的地候选 通过 display_name 区分城市、地标和附近行政区域。
目的地边界与国家信息 使用 location.bounding_box 和 countryCode 初始化地图范围及地理上下文。
小批量地点联想建议 limit 可选 1 至 5;巴黎实测 limit=3 返回了三条建议。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/common-auto-complete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/common-auto-complete?key=<API_KEY>&query=Paris&languageCode=en-US&limit=3'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/common-auto-complete?key=<API_KEY>&query=Paris&languageCode=en-US&limit=3'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 为目的地选择器同时保存选中的显示名称和可复用地点标识。
- 在搜索住宿前,用选中建议的边界初始化目的地地图。
- 区分部分名称相同的城市、地标与城区,减少地点误选。
- 让住宿发现和本地体验搜索表单共用同一个已选目的地。
常见问题
应将哪个标识传给 stays-search 或 experiences-search?
复制选中建议的 explore_search_params.place_id。不要替换成 location.google_place_id、建议本身的 id 或显示名称;实测流程原样复用了返回的 place_id。
第一次可以用什么安全的目的地查询?
实测请求为 query=Paris、languageCode=en-US、limit=3,返回 Paris, France 及相关地点。你可以更换目的地文字;此查询只读取建议,不会创建预订。