旧版城市与地址联想查询(已弃用)

查看 美国房产与房贷数据 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 功能

保留旧版单参数检索约定 梳理旧搜索表单时,可按现有 GET 请求及必填 input 字符串核对城市、行政区或地点名称的查询方式。
整理文档示例中的候选字段 参考示例中的 autocomplete 数组、候选标识符、地点类别、坐标和地理字段,同时明确截断的文档示例并非已验证响应。
核对地点与房产标识的区别 将选中项传入房产查询之前,先区分城市等地点标识符与可能存在的房产标识符,避免混用。
明确旧接口的迁移边界 用此接口梳理现有集成,再单独验证新版地点接口,不能将两者的参数与响应约定视为可直接互换。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

新建地点选择器应该使用此已弃用接口吗?

不建议。此文档用于维护现有 /locations/auto-complete 集成;新项目应评估 /locations/v2/auto-complete。应验证替代接口的响应与参数约定,不能假定无需调整就能直接替换。

此旧版接口支持哪些查询参数?

现有接口约定仅提供必填的字符串参数 input,示例为 new york。文档没有为此接口说明 limit 参数。

输入地址后一定能获得房产标识符吗?

不能保证。接口介绍提到从地址查找房产标识符,但现有资料没有记录此接口的成功测试。地点候选项的标识符不能自动当作房产标识符使用。

文档中的 autocomplete 字段已经在此接口上验证过吗?

没有。_id、area_type、centroid、city、state_code、counties 等字段仅出现在被截断的文档示例中。应将其作为迁移参考,处理随地点类别变化的字段缺失情况,并在依赖这些字段前验证接口约定。

相关接口

相关指南

查看订阅方案 →