Global Airport Database API

Global airport database with 70,000+ airports. Search by IATA/ICAO code, country, region, type, or geolocation. JSON responses, REST API.

原始信息汇总

数据集概述

名称: Global Airport Database API
提供商: Jxancestral 17
类别: Travel
定价模式: Freemium（提供 BASIC、PRO、ULTRA、MEGA 四种订阅计划）

---

数据集规模与范围

• 包含全球 70,000 多个机场的详细记录，涵盖从国际大型枢纽到区域跑道、直升机停机坪、水上飞机基地等所有类型。
• 数据根据国际航空标准定期更新。

---

每条机场记录包含的字段

字段	说明
id	内部数字标识符
ident	唯一机场标识字符串
name	机场全名
type	机场类别（参见下方类型列表）
iata_code	3 字母 IATA 代码（如 MXP）
icao_code	4 字母 ICAO 代码（如 LIML）
gps_code	GPS 标识符
local_code	地方当局代码
latitude	十进制纬度
longitude	十进制经度
elevation_ft	海平面以上海拔（英尺）
continent	2 字母大洲代码
iso_country	ISO 3166-1 alpha-2 国家代码
iso_region	ISO 3166-2 区域代码
municipality	城市或自治市名称
scheduled_service	是否提供定期服务（yes 或 no）
wikipedia_link	维基百科文章 URL（如可用）
keywords	额外的搜索关键词

机场类型: large_airport, medium_airport, small_airport, heliport, seaplane_base, closed

---

API 端点列表

1. GET /{id} - 根据内部数字 ID 获取单个机场。
2. GET /iata/{code} - 根据 IATA 代码（3 字母）获取单个机场。
3. GET /icao/{code} - 根据 ICAO 代码（4 字母）获取单个机场。
4. GET /search - 按机场名称进行部分匹配搜索。
   • 参数：q（必填，最少 2 字符）、limit（1-100，默认 20）
5. GET /nearby - 查找指定坐标周围一定范围内的机场（按距离排序）。
   • 参数：lat、lng（必填）、delta（边界框半大小，单位度，默认 1.0 ≈ 111 km）、limit（1-100，默认 20）
6. GET /countries - 返回数据集中所有国家按机场总数排名的列表。
7. GET /types - 返回整个数据集中按机场类型分布的统计。
8. GET / - 返回机场列表（支持分页和多重筛选）。
   • 可选筛选参数：country、continent、type、scheduled_service、region、municipality
   • 分页参数：limit（每页数量，1-500，默认 50）、offset（偏移量，默认 0）

---

关键特性

• 数据格式: 所有响应均为 JSON 格式。
• 认证方式: 基于 RapidAPI 标准 API Key，通过 X-RapidAPI-Key 请求头传递。
• 分页: 列表端点支持 limit 和 offset 参数进行分页（limit 最大 500）。
• 错误响应: 状态码 200（成功）、404（未找到）、422（参数验证错误）。
• 主要用例: 航班搜索工具的机场自动填充、飞行路线规划及距离计算、物流与供应链路由、航空教育与模拟软件、需要机场元数据的数据丰富管道。