UAM.CITY空域数据API提供哪些接口？

提供城市空域分类查询、航线规划、实时空域状态查询、空域数据批量查询四类接口，当前为v0.8 Beta原型阶段，返回示例数据。

如何申请空域数据API Key？

访问 uam.city/tools 填写申请表格，或邮件联系 UAM.CITY 团队，审核通过后将在2个工作日内发放API Key。原型阶段所有接口免费开放。

空域数据API的数据来源是什么？

空域分类来自民航局《低空空域分类管理办法》，城市空域细则来自各城市低空办公开文件，禁飞区数据基于OpenStreetMap与政府公告整理，天气数据来自中国气象局公开API。

空域数据API — UAM.CITY 开发者文档

uam.city 空域数据查询接口，为低空经济应用提供空域分类、航线规划、天气影响等数据服务。

📋 接口列表

1. 查询城市空域分类

基础接口v0.8

GET /api/airspace?city={城市}&type={机型}

查询指定城市的空域分类信息，包括可用空域类型、高度限制、禁飞区等。

参数	类型	必填	说明
city	string	✅	城市名称，如 shenzhen / guangzhou / beijing
type	string	❌	机型：evtol / delivery-drone / inspection-drone，默认全部

// 请求示例
GET https://api.uam.city/airspace?city=shenzhen&type=evtol

// 响应示例（2026-07-02）
{
  "city": "shenzhen",
  "city_cn": "深圳",
  "update_time": "2026-07-02T10:00:00+08:00",
  "airspace": {
    "class": "G类监视空域（部分开放）",
    "altitude_limit": "120m（人口密集区）/ 300m（非密集区）",
    "required_license": "轻型民用无人机操控员证书",
    "approval_required": true,
    "approval_authority": "中南民航管理局 + 深圳低空办"
  },
  "restrictions": [
    { "type": "机场净空区", "radius_km": 5, "note": "宝安机场周边5km严格禁飞" },
    { "type": "政府机关", "level": "禁飞", "note": "市委、市政府、军事设施周边" },
    { "type": "人口密集区", "limit": "需提前报备", "note": "商圈、体育场、火车站等" }
  ],
  "approved_routes": 148,
  "weather_status": "良好（适飞）",
  "next_review": "2026-10-01"
}

2. 航线规划接口

规划工具v0.5

POST /api/route/plan

输入起点和终点，返回推荐低空航线方案（含高度层、途经航点、备用降落场）。

// 请求示例
POST https://api.uam.city/api/route/plan
Content-Type: application/json
{
  "origin": { "lat": 22.5431, "lng": 114.0579, "name": "深圳湾" },
  "destination": { "lat": 22.6085, "lng": 114.0537, "name": "龙岗大运" },
  "vehicle_type": "evtol",
  "preferences": { "avoid_airports": true, "max_altitude": 300 }
}

// 响应示例
{
  "route_id": "RT-20260702-001",
  "distance_km": 28.5,
  "estimated_time_min": 18,
  "recommended_altitude_m": 150,
  "waypoints": [
    { "name": "深圳湾起降点", "lat": 22.5431, "lng": 114.0579, "altitude": 0 },
    { "name": "塘朗山南侧", "lat": 22.5876, "lng": 114.0321, "altitude": 150 },
    { "name": "龙岗大运起降点", "lat": 22.6085, "lng": 114.0537, "altitude": 0 }
  ],
  "restrictions_on_route": [
    { "segment": 2, "type": "临时管制", "note": "每周一09:00-11:00 军事训练" }
  ],
  "backup_landing_sites": [
    { "name": "深圳北站起降点", "distance_from_route_km": 3.2 }
  ],
  "cost_estimate": { "energy_kwh": 18.5, "estimated_cost_cny": 45 }
}

3. 实时空域状态查询

实时监控v0.3

GET /api/airspace/status?city={城市}

查询指定城市当前空域开放状态、天气影响、临时管制等信息。

// 请求示例
GET https://api.uam.city/api/airspace/status?city=guangzhou

// 响应示例
{
  "city": "guangzhou",
  "query_time": "2026-07-02T14:30:00+08:00",
  "overall_status": "部分开放",
  "weather": {
    "condition": "晴",
    "wind_speed_ms": 5.2,
    "visibility_km": 15,
    "suitable_for_flight": true
  },
  "temporary_restrictions": [
    {
      "reason": "大型活动",
      "area": "天河体育中心周边3km",
      "valid_until": "2026-07-02T22:00:00+08:00"
    }
  ],
  "available_routes": 89,
  "active_flights": 23
}

4. 空域数据批量查询

数据分析v0.2

GET /api/airspace/batch?cities={城市列表}

批量查询多个城市的空域信息，适用于全国性低空物流网络规划。

📊 数据源说明

数据项	来源	更新频率	准确度
空域分类	民航局《低空空域分类管理办法》（征求意见稿）	政策更新时	⭐⭐⭐⭐⭐
城市空域细则	各城市低空办公开文件	每月	⭐⭐⭐⭐
禁飞区数据	OpenStreetMap + 政府公告整理	每周	⭐⭐⭐
天气数据	中国气象局公开API	每小时	⭐⭐⭐⭐⭐
航线审批状态	各企业公开数据 + 政府公示	每日	⭐⭐⭐

⚠️ 注：当前为原型阶段，部分数据基于公开资料整理，正式接入后将对接民航局实时数据源。

🔧 快速接入指南

Step 1：申请 API Key

访问 uam.city/tools 填写申请表格，或邮件至 [email protected]。审核通过后将在2个工作日内发放 API Key。

Step 2：调用接口

// JavaScript 示例
const response = await fetch(
  'https://api.uam.city/airspace?city=shenzhen&type=evtol',
  { headers: { 'X-API-Key': 'your_api_key_here' } }
);
const data = await response.json();
console.log(data.airspace);

Step 3：处理响应

所有接口返回标准 JSON 格式，HTTP 状态码说明：

状态码	说明
200	请求成功
400	参数错误（检查 city / type 格式）
401	API Key 无效或已过期
429	请求频率超限（免费版：100次/天）
503	数据源暂时不可用（如遇政策调整）

套餐	价格	请求额度	适用对象
免费版	¥0/月	100次/天	个人开发者、研究用途
基础版	¥99/月	10,000次/月	小型创业公司
专业版	¥499/月	100,000次/月	中型企业、物流运营商
企业版	议价	不限	大型物流企业、政府部门

📡 空域数据 API 文档

⚠️ API 状态说明

📋 接口列表

1. 查询城市空域分类

2. 航线规划接口

3. 实时空域状态查询

4. 空域数据批量查询

📊 数据源说明

🔧 快速接入指南

Step 1：申请 API Key

Step 2：调用接口

Step 3：处理响应

💰 收费标准（预计2026年Q4执行）

常见问题