空域点位查询

GET/v1/airspace/query
认证方式：所有请求需在请求头中携带试用密钥（API Key），详情请查看认证。空域查询按频率限流（60 次/分钟），不占 AI 每日额度。
「不在禁飞区」不等于「可飞」
当前数据只覆盖禁飞区。坐标未落入禁飞区时返回 unknown，而不是 flyable——限高区、警示区、管制空域尚未核查（见响应的 coverage 字段）。适飞区能力在权威数据源与责任边界确定前不开放，请求对应路径会得到 404。

请求参数

参数名位置类型必填说明
Authorizationheaderstring是试用密钥，格式 Bearer <API Key>。
lonquerynumber是经度（WGS-84）。
latquerynumber是纬度（WGS-84）。

请求示例

cURL
curl --request GET '/v1/airspace/query?lon=116.397&lat=39.908' \
  --header 'Authorization: Bearer <your_api_key>'

返回数据

{
  "status": "unknown",
  "zones": [],
  "disclaimer": "未落在已接入的禁飞区内。这不等于此处可飞……",
  "coverage": {
    "checked": ["no_fly_zone"],
    "not_checked": ["height_limit", "warning_zone", "controlled"]
  }
}
字段说明
statusenumno_fly 表示落入禁飞区；unknown 表示未落入已接入的禁飞区——不是「可飞」的肯定答案。
zonesarray命中的禁飞区列表；未命中时为空数组。
disclaimerstring结果免责声明，请随结果一并展示给最终用户。
coverageobject本次查询核查了哪些空域类型（checked）、没核查哪些（not_checked）。

错误码

错误码HTTP 状态说明
OP-AIRSPACE-REQUEST-INVALID400查询参数有误（lon/lat 缺失或非法）
OP-QUOTA-RATE-LIMITED429请求过于频繁（60 次/分钟），请稍后重试
OP-AIRSPACE-UPSTREAM-DOWN503空域服务暂时不可用，请稍后重试

完整错误码表见错误码。