查询美国房产周边信息,可选择包含洪水相关信息
查看 美国房产与房贷数据 API 的全部接口 →通过 GET /properties/v3/get-surroundings 请求查询单套美国住宅的周边信息。必填查询参数 property_id 应使用房源列表接口返回的 property_id,而非 listing_id。可选布尔参数 enable_flood 用于控制是否包含洪水相关信息;false 是文档示例值,并非已验证的服务端默认值。 现有资料中没有成功的实测响应,也没有可解析的 JSON 响应示例,因此响应字段名称、嵌套结构、覆盖范围及洪水信息的具体值均尚未验证。不要假定响应必定包含洪水分区、风险评分、地图几何数据或任何特定的社区指标。将可用的周边信息作为补充背景;缺少环境信息时应标记为未知,而不是安全。权威洪水判定或保险评估应另行获取。
API 功能
按房产标识查询周边背景 使用房源搜索获得的 property_id 请求单套房产的周边信息,无需输入地址,也不以挂牌标识替代房产标识。
显式控制洪水信息选项 通过可选布尔参数 enable_flood 请求包含或排除洪水相关信息,不预设响应中一定存在某个洪水字段。
选定房源后按需补充环境信息 将周边查询与房源搜索分开,让应用仅在用户选中房产后再请求相关背景信息。
周边数据缺失时保留未知状态 设计周边信息面板时,应考虑覆盖范围和响应结构尚未验证;环境数据不可用不应被解读为房产不存在隐患。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
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>'
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,为候选房源增加可选的周边信息面板。
- 让购房者通过 enable_flood 选择是否在周边查询中包含洪水相关信息。
- 当周边响应没有提供可用背景时,显示环境数据不可用,而不是将房产标记为安全。
- 将房产周边数据作为初步参考,再引导买家获取权威洪水判定或保险机构评估。
常见问题
查询房产周边信息需要使用哪种标识?
将房源列表结果中的 property_id 传入必填查询参数 property_id。listing_id 是另一种标识,不能用来替代。
如何请求包含房产的洪水相关信息?
将可选查询参数 enable_flood 设为 true。文档说明该参数用于控制是否包含洪水相关信息,但现有资料尚未验证具体洪水字段或覆盖范围。
省略 enable_flood 就表示不包含洪水信息吗?
文档示例值为 false,但省略该参数时的默认行为尚未验证。如果这一选择会影响应用逻辑,请显式设置 enable_flood。
哪些周边信息响应字段已经验证?
现有资料中尚无已验证字段:该接口没有成功的实测响应,也没有可解析的 JSON 响应示例。不要根据假定的风险评分、洪水分区或地图几何数据构建固定解析结构。
缺少周边或洪水数据,能否认定房产安全?
不能。信息不可用只表示环境背景未知。此查询不属于官方洪水判定或保险评估,也不是保证完整的房产风险报告。