查询美国房产周边信息,可选择包含洪水相关信息

查看 美国房产与房贷数据 API 的全部接口 →

通过 GET /properties/v3/get-surroundings 请求查询单套美国住宅的周边信息。必填查询参数 property_id 应使用房源列表接口返回的 property_id,而非 listing_id。可选布尔参数 enable_flood 用于控制是否包含洪水相关信息;false 是文档示例值,并非已验证的服务端默认值。 现有资料中没有成功的实测响应,也没有可解析的 JSON 响应示例,因此响应字段名称、嵌套结构、覆盖范围及洪水信息的具体值均尚未验证。不要假定响应必定包含洪水分区、风险评分、地图几何数据或任何特定的社区指标。将可用的周边信息作为补充背景;缺少环境信息时应标记为未知,而不是安全。权威洪水判定或保险评估应另行获取。

API 功能

按房产标识查询周边背景 使用房源搜索获得的 property_id 请求单套房产的周边信息,无需输入地址,也不以挂牌标识替代房产标识。
显式控制洪水信息选项 通过可选布尔参数 enable_flood 请求包含或排除洪水相关信息,不预设响应中一定存在某个洪水字段。
选定房源后按需补充环境信息 将周边查询与房源搜索分开,让应用仅在用户选中房产后再请求相关背景信息。
周边数据缺失时保留未知状态 设计周边信息面板时,应考虑覆盖范围和响应结构尚未验证;环境数据不可用不应被解读为房产不存在隐患。

在线 API 演示

GET /api/project/realty-in-us/properties-v3-get-surroundings

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-get-surroundings?key=<API_KEY>&property_id=<property_id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

查询房产周边信息需要使用哪种标识?

将房源列表结果中的 property_id 传入必填查询参数 property_id。listing_id 是另一种标识,不能用来替代。

如何请求包含房产的洪水相关信息?

将可选查询参数 enable_flood 设为 true。文档说明该参数用于控制是否包含洪水相关信息,但现有资料尚未验证具体洪水字段或覆盖范围。

省略 enable_flood 就表示不包含洪水信息吗?

文档示例值为 false,但省略该参数时的默认行为尚未验证。如果这一选择会影响应用逻辑,请显式设置 enable_flood。

哪些周边信息响应字段已经验证?

现有资料中尚无已验证字段:该接口没有成功的实测响应,也没有可解析的 JSON 响应示例。不要根据假定的风险评分、洪水分区或地图几何数据构建固定解析结构。

缺少周边或洪水数据,能否认定房产安全?

不能。信息不可用只表示环境背景未知。此查询不属于官方洪水判定或保险评估,也不是保证完整的房产风险报告。

相关接口

相关指南

查看订阅方案 →