补全地点并查询 Zillow 区域 ID
查看 Zillow 美国房产与市场数据 API 的全部接口 →query 至少输入 2 个字符；limit 可选，默认 10。此只读查询用于在房源或市场研究前展示地点选择器，不应自动采用第一条文本匹配。 已保存的 Seattle、limit=3 请求返回 success:true 和 data.suggestions 中的 3 条建议。每条含 type、region_type、display、region_id、sub_type、city、state、county、latitude、longitude，响应另有 meta。Seattle, WA 为 city，region_id 为 16037；West Seattle 为 flex_region，Capitol Hill 为 neighborhood，建议中的两项坐标均为空。请把所选区域类型、显示名称与 ID 保存为请求来源；后续市场响应仍可能区域身份为空，地点补全并不证明市场数据已确认该地区。
API 功能
保留区域类型 城市、flex_region 与社区是不同候选类型，不能压平成可互换的地名。
明确选择区域 ID Seattle 样本提供城市 region_id 16037，并附显示名称、州和县，供用户主动选择。
限制建议请求量 用 limit 控制请求的建议数量；已验证 limit=3 时返回 3 条建议。
坐标允许为空 已保存建议的经纬度字段存在但为 null；识别区域不等于保证完成地址地理编码。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/zillow-real-estate/autocomplete-location API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/zillow-real-estate/autocomplete-location?key=<API_KEY>&query=<query>&limit=10'
curl -X GET 'https://api.opendata-api.com/api/project/zillow-real-estate/autocomplete-location?key=<API_KEY>&query=<query>&limit=10'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 城市与社区选择器：在候选名称旁展示区域类型，再由用户选择市场。
- 市场请求溯源：独立保存所选显示名称、区域 ID 和类型，不与市场返回身份混淆。
- 搜索框辅助：用户明确输入后读取少量建议，不把每条建议自动解析为房产详情。
- 歧义地点复核：帮助搬迁研究者区分 Seattle 城市、West Seattle 与 Capitol Hill，而非静默选中一项。
常见问题
能否当作地址地理编码接口使用？
不能假设一定有坐标。实测 Seattle 建议虽有区域 ID 和名称，latitude、longitude 都为 null。
Seattle 和 West Seattle 是同一种区域吗？
不是。样本将 Seattle 标为 city、West Seattle 标为 flex_region、Capitol Hill 标为 neighborhood。应保留类型并让调用者明确选择。
选好区域 ID 后，市场响应一定会有区域身份吗？
不一定。应把选择保存为请求来源。已验证的市场请求虽有有效数值，但 data.region 各字段为空；尚未证实传 region_id 能修复该对象。