按经纬度查询附近学校(旧版接口,已弃用)

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

旧版经纬度参数核对 记录现有请求中必填的数值型 lat、lon 参数,在迁移审查时保留纬度与经度各自的含义。
仅见于示例的学校距离 未验证示例的学校记录含 distance_in_miles 字段,但尚未确认固定搜索半径、排序方式或当前数据覆盖情况。
学校列表可见字段清单 梳理截断示例中可见的学校、学区、位置、年级范围及教育阶段字段,不将其视为已验证的响应结构。
旧版学校评分空值处理 示例同时展示 parent_rating 和值为 null 的 ratings.great_schools_rating,旧版页面不得把缺失评分转换为零分。
学校边界示例解读限制 示例含 boundary_trimmed 几何数据,但这些边界数据和地理距离均不能证明某套房产的学校分配关系。
替代方案覆盖范围验收 以独立验证的替代方案规划旧版功能退役,不推荐继续使用本已弃用接口,也不依赖不可用的学校搜索接口。

在线 API 演示

GET /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,分别表示十进制度形式的纬度和经度。文档示例为 lat=35.129431、lon=-117.937021,请勿将两个值颠倒。

旧版示例中可以看到哪些响应字段?

截断示例展示了 districts、meta.build 和 schools。其中一条完整学校记录包含标识、名称、坐标、distance_in_miles、学区和位置详情、教育阶段、年级范围、电话、评分、学生人数、师生比、relevance 以及 boundary_trimmed 几何数据。这些都只是示例字段,并非已通过在线验证的返回内容。

学校评分是否一定是数值?

没有这样的保证。示例中的 ratings.great_schools_rating 为 null。请保留评分缺失状态,不要假定评分量表,也不要把缺失值转换为零分。

附近学校或示例边界能否证明入学资格?

不能。地理距离以及未验证示例中的 boundary_trimmed 都不能证明房产对应的分配学校或学生入学资格。请向学校或学区官方核实当前规则。

能否设置搜索半径,或用学校搜索接口替代?

文档未列出半径参数,示例也不足以确定固定搜索半径或结果排序。所引用的学校搜索接口不可作为替代依赖;在承诺继续提供附近学校数据前,须独立验证其他方案。

相关接口

相关指南

查看订阅方案 →