📋 接口列表
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={城市列表}
批量查询多个城市的空域信息，适用于全国性低空物流网络规划。