旧版城市与地址联想查询(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此接口为现有集成保留,通过唯一必填的 input 查询字符串获取地点候选项。文档说明支持城市、行政区和地点名称,接口介绍还提到街道名称检索及从地址查找房产标识符,用例输入为 new york。该接口已弃用,适合用于梳理旧系统的迁移需求,不建议用于新建地点选择器;新项目应评估 /locations/v2/auto-complete。 文档示例包含 autocomplete 数组,候选项示例字段包括标识候选项的 _id、表示相关度的 _score、地点类别 area_type、坐标 centroid.lat 和 centroid.lon,以及 city、state_code、country 等地理信息。示例中的 counties 条目包含 fips、name、state_code。其他随地点类别而变化的示例字段包括 geo_id、slug_id、county_needed_for_uniq、city_slug_id、line、postal_code、has_catchment、school 和 school_id。不能假定每条建议都包含这些字段,也不能将城市标识符混同于房产标识符。 现有测试未记录此旧版接口的成功响应。上述字段来自未经验证且被截断的文档示例,并非已观测到的响应。从地址查找房产标识符只是文档描述的用途,不能保证某个地址一定返回房产标识符。迁移前应核实候选项类别、可选字段及后续房产接口接受的输入,不能假定新版接口具有完全相同的响应约定。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/locations-auto-complete-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/locations-auto-complete-deprecated?key=<API_KEY>&input=<input>'
查询结果
使用场景
- 盘点仅发送 input 的旧版房产搜索表单,记录各表单如何处理城市、行政区和地址候选项。
- 根据旧版文档示例制作解析测试样本,将可选地理字段标为未经验证,避免当作生产环境保证。
- 检查现有地址查询流程是否误将城市候选项的标识符传给房产详情接口。
- 规划地点查询接口迁移,在替换旧请求前明确测试候选项类别与字段缺失情况。
常见问题
新建地点选择器应该使用此已弃用接口吗?
不建议。此文档用于维护现有 /locations/auto-complete 集成;新项目应评估 /locations/v2/auto-complete。应验证替代接口的响应与参数约定,不能假定无需调整就能直接替换。
此旧版接口支持哪些查询参数?
现有接口约定仅提供必填的字符串参数 input,示例为 new york。文档没有为此接口说明 limit 参数。
输入地址后一定能获得房产标识符吗?
不能保证。接口介绍提到从地址查找房产标识符,但现有资料没有记录此接口的成功测试。地点候选项的标识符不能自动当作房产标识符使用。
文档中的 autocomplete 字段已经在此接口上验证过吗?
没有。_id、area_type、centroid、city、state_code、counties 等字段仅出现在被截断的文档示例中。应将其作为迁移参考,处理随地点类别变化的字段缺失情况,并在依赖这些字段前验证接口约定。