为文字房源搜索联想目的地名称
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →必须提供 query、currency 和 locale，为按文字搜索房源的流程获取地点建议。币种标识来自 get-currency，语言区域标识来自 get-languages。文档响应含 status、message，以及 data 内的 country_code、display_name 建议，例如住宿或体验地点名称。与 common-auto-complete 不同，此示例未提供 stays-search 和 experiences-search 所需的可复用 placeId。此文字联想接口未纳入本次实测。
API 功能
文字搜索的建议入口 将部分目的地文字转换为 display_name 候选，供房源搜索的 query 使用。
国家代码辅助区分地名 文档中的建议项包含 country_code，便于识别同名目的地。
联想必填语言区域与币种 此接口要求 locale、currency，与文字房源系列的参数命名一致。
名称联想与地点标识分开 此精简名称响应不同于通用目的地选择器，不据此假定存在 placeId。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/properties-auto-complete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-auto-complete?key=<API_KEY>&query=<query>¤cy=USD&locale=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-auto-complete?key=<API_KEY>&query=<query>¤cy=USD&locale=en-US'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 在最终提交 query 文字的房源表单中提供城市名称建议。
- 为文字目的地候选显示国家信息，避免同名城市混淆。
- 用户切换房源表单语言区域时，按需重新查询名称建议。
- 把选中的目的地名称送入文字搜索界面，而不依赖编码地点标识。
常见问题
这个响应可以提供 stays-search 所需的 placeId 吗？
文档中的文字联想示例仅含 display_name 和 country_code。住宿或体验系列需要 explore_search_params.place_id 时，请使用 common-auto-complete。
为什么这个联想接口必须填写 currency 和 locale？
它们是此接口声明的必填入参。请随部分地点 query 一同提供 get-currency 返回的币种标识和 get-languages 返回的语言区域标识；这里的参数名不同于 currencyCode 和 languageCode。