按经纬度查询附近学校(旧版接口,已弃用)
查看 美国房产与房贷数据 API 的全部接口 →已弃用:GET /schools/list-nearby 仅供审查或迁移现有集成,不建议用于新开发。文档说明此接口用于列出房产位置附近的学校。请求必须同时提供两个数值型查询参数:lat 为纬度,lon 为经度,均使用十进制度坐标。文档示例为 lat=35.129431、lon=-117.937021。未列出房产 ID、地址、搜索半径、分页、年级筛选或入学分配相关输入。 本接口未提供实际在线验证的响应。资料中有一份标注为 HTTP 200 的未验证示例,但内容已截断,既不是完整有效的 JSON 响应,也不能证明接口当前仍可用。可见的顶层字段包括 districts(示例中为空数组)、meta.build 和 schools。其中一条完整的学校记录包含 id、name、greatschools_id、nces_id、funding_type、education_levels、grades.range.low、grades.range.high、lat、lon 和 distance_in_miles;还展示了 district.id、district.name,location 下的 city、city_slug_id、county、postal_code、state、street,以及 phone、ratings.great_schools_rating、ratings.parent_rating、relevance、student_count、student_teacher_ratio、boundary_trimmed.type 和嵌套的 boundary_trimmed.coordinates。 这些仅是示例中可见的字段,并非当前已验证或保证返回的内容。示例中的 ratings.great_schools_rating 值为 null,空的 districts 数组也不足以确认学区列表的记录结构。不能据此假定结果排序固定、学校覆盖完整、搜索半径稳定、评分采用某一固定量表,或在校人数等统计数据及时更新。地理距离和示例中的边界几何数据都不能证明学校分配关系或入学资格。 此接口只应用于梳理现有的附近学校查询依赖及其可空字段。在承诺继续提供附近学校数据前,请独立验证替代方案;不要将不可用的学校搜索接口当作替代方案或获取 ID 的前置步骤。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/schools-list-nearby-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/schools-list-nearby-deprecated?key=<API_KEY>&lat=<lat>&lon=<lon>'
查询结果
使用场景
- 盘点发送 lat、lon 的旧版房产页面,明确附近学校查询依赖,以便有计划地移除或迁移。
- 将未验证示例作为审查清单,检查旧版学校卡片对 distance_in_miles、年级范围和地址字段的假设。
- 测试现有展示组件对学校评分缺失和 districts 空数组的处理,但不把截断示例当作当前响应规范。
- 制定旧版功能退役验收标准,独立核实替代方案的附近学校覆盖能力,并避免在附近学校标签中暗示入学分配关系。
常见问题
新应用是否应该接入这个附近学校接口?
不应该。该接口已弃用,仅作为旧版集成迁移的参考。现有资料没有提供实际在线验证结果来确认其当前可用性,任何替代方案也都需要独立验证。
旧版请求必须提供哪些坐标参数?
必须同时提供数值型查询参数 lat 和 lon,分别表示十进制度形式的纬度和经度。文档示例为 lat=35.129431、lon=-117.937021,请勿将两个值颠倒。
旧版示例中可以看到哪些响应字段?
截断示例展示了 districts、meta.build 和 schools。其中一条完整学校记录包含标识、名称、坐标、distance_in_miles、学区和位置详情、教育阶段、年级范围、电话、评分、学生人数、师生比、relevance 以及 boundary_trimmed 几何数据。这些都只是示例字段,并非已通过在线验证的返回内容。
学校评分是否一定是数值?
没有这样的保证。示例中的 ratings.great_schools_rating 为 null。请保留评分缺失状态,不要假定评分量表,也不要把缺失值转换为零分。
附近学校或示例边界能否证明入学资格?
不能。地理距离以及未验证示例中的 boundary_trimmed 都不能证明房产对应的分配学校或学生入学资格。请向学校或学区官方核实当前规则。
能否设置搜索半径,或用学校搜索接口替代?
文档未列出半径参数,示例也不足以确定固定搜索半径或结果排序。所引用的学校搜索接口不可作为替代依赖;在承诺继续提供附近学校数据前,须独立验证其他方案。