Sân bay API

Tra 12.000 sân bay theo mã IATA / ICAO, tên hoặc thành phố, tìm sân bay gần một toạ độ, tính khoảng cách đường tròn lớn và hướng bay giữa hai sân bay.

GEThttps://apibox.io.vn/v1/airports
Dữ liệu & JSON▶ Dùng thử online

/v1/airports/SGN (hoặc iata=, icao=, code=) trả về một sân bay: tên, loại, thành phố, quốc gia, vùng, toạ độ, độ cao, có chuyến bay thường lệ không, các mã và, với sân bay lớn và vừa, các đường băng đang mở (đầu băng, chiều dài, chiều rộng, mặt đường, đèn). q tìm theo tên, thành phố và các tên gọi khác, không cần dấu (saigon ra Tân Sơn Nhất); lọc bằng country, type (large, medium, small, seaplane) và scheduled=true.

lat + lon liệt kê các sân bay gần nhất (mặc định sân bay lớn, vừa và sân bay nhỏ có mã IATA) kèm khoảng cách; from + to trả về khoảng cách đường tròn lớn theo km, dặm và hải lý cùng hướng bay ban đầu và lúc đến.

Dữ liệu: OurAirports (public domain), cập nhật hàng tuần: mọi sân bay lớn và vừa, cùng sân bay nhỏ và bến thuỷ phi cơ có mã IATA hoặc ICAO; bỏ sân bay đã đóng và sân đỗ trực thăng. Khoảng cách tính trên mặt cầu, lệch khoảng 0,5 % so với ellipsoid – đủ cho hiển thị và ước tính, không dùng lập kế hoạch bay.

Tham số

TênVị tríKiểuBắt buộcMặc định
codepathstringkhôngMã IATA (3 chữ) hoặc ICAO (4 chữ): /v1/airports/HAN. Hoặc iata=, icao=, code=.
qquerystringkhôngTên, thành phố hoặc mã cần tìm.
latquerynumberkhôngVĩ độ để tìm sân bay gần nhất (cùng lon).
lonquerynumberkhôngKinh độ.
fromquerystringkhôngMã sân bay đi để tính khoảng cách (cùng to).
toquerystringkhôngMã sân bay đến.
countryquerystringkhôngLọc theo mã quốc gia ISO, ví dụ VN.
typequerystringkhônglarge, medium, small, seaplane (phân tách bằng dấu phẩy).
scheduledquerybooleankhôngChỉ sân bay có (true) hoặc không có (false) chuyến bay thường lệ.
limitquerynumberkhông10Số kết quả (1–50).

Ví dụ

curl "https://apibox.io.vn/v1/airports?from=SGN&to=NRT" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "from": {
    "iata": "SGN",
    "icao": "VVTS",
    "ident": "VVTS",
    "name": "Tan Son Nhat International Airport",
    "type": "large_airport",
    "municipality": "Ho Chi Minh City",
    "country_code": "VN",
    "country": "Vietnam",
    "region_code": "VN-SE",
    "lat": 10.8188,
    "lon": 106.652,
    "elevation_ft": 33,
    "elevation_m": 10,
    "scheduled_service": true
  },
  "to": {
    "iata": "NRT",
    "icao": "RJAA",
    "ident": "RJAA",
    "name": "Narita International Airport",
    "type": "large_airport",
    "municipality": "Narita",
    "country_code": "JP",
    "country": "Japan",
    "region_code": "JP-12",
    "lat": 35.76858,
    "lon": 140.38871,
    "elevation_ft": 141,
    "elevation_m": 43,
    "scheduled_service": true
  },
  "distance": {
    "km": 4383.7,
    "mi": 2723.9,
    "nmi": 2367
  },
  "initial_bearing": 45.2,
  "initial_bearing_compass": "NE",
  "final_bearing": 59.2,
  "method": "great-circle (haversine) distance on a sphere of radius 6371.0088 km; bearings in degrees from true north",
  "attribution": "Data: OurAirports (ourairports.com), public domain",
  "data_version": "2026-11-11"
}

Ứng dụng

  • Ô chọn sân bay có mã IATA trong form đặt vé, du lịch
  • Tìm sân bay gần khách sạn hoặc địa điểm sự kiện nhất
  • Hiển thị khoảng cách bay giữa hai sân bay để tính dặm thưởng hoặc CO₂
  • Kiểm tra chiều dài đường băng khi nhận yêu cầu thuê chuyến

Hỏi đáp

Dữ liệu có được dùng lại tự do không?

Có. OurAirports phát hành dữ liệu vào public domain; ghi nguồn là nên làm nhưng không bắt buộc.

Vì sao không thấy một sân bay nhỏ?

Sân bay nhỏ chỉ được giữ khi có mã IATA hoặc ICAO. Sân đỗ trực thăng và sân bay đã đóng bị loại.

Khoảng cách có phải quãng đường bay thực tế?

Không. Đó là khoảng cách đường tròn lớn ngắn nhất giữa hai sân bay; đường bay thật dài hơn do đường hàng không và thời tiết.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →