Dubhe Nexus Data Service

Dubhe Nexus Data API

API JSON Public

Providing RESTful interfaces for airport information and real-time aviation weather data, along with embeddable service pages for third-party integration.

Endpoints
Base URL https://data.dubhenexus.org/api
Airport codes in API request URLs only support ICAO codes (e.g., VHHH). IATA codes are not accepted.
Airport Information
GET /airport/:icao Basic Airport Info
Parameter Type Description
:icao string Required 4-letter ICAO code, e.g., VHHH. Only ICAO is accepted.
Response · 200 OK
{
  "icao": "VHHH",
  "data": {
    "icaoId":    "VHHH",
    "iataId":    "HKG",
    "faaId":     null,
    "name":      "HONG KONG INTERNATIONAL AIRPORT",
    "state":     "HK",
    "country":   "CN",
    "lat":       22.3116,
    "lon":       113.9225,
    "elev":      9,
    "magdec":    "3W",
    "owner":     "P",
    "rwyNum":    "3",
    "rwyLength": "L",
    "runways": [
      {
        "id":         "07C/25C",
        "lengthM":   3800,
        "widthM":    60,
        "dimension":  "3800x60",
        "surface":   "HARD",
        "alignment": 74
      }
    ],
    "rawMETAR": "METAR VHHH 060930Z 20014KT 9999 FEW008 SCT022 28/23 Q1005 NOSIG",
    "rawTAF":   "TAF VHHH 060800Z 0609/0715 20010KT 9999 FEW010 SCT025 TX30/0706Z TN26/0622Z"
  }
}
Field Description
Field Type Description
icaoId string ICAO code
iataId string IATA code
faaId string | null FAA identifier (US airports only, others null)
name string Full name of the airport (Uppercase English)
state string State / Province / Region code
country string Country code (ISO 3166-1 alpha-2)
lat / lon number Airport coordinates (Decimal degrees)
elev number Airport elevation (Meters)
magdec string Magnetic declination, e.g., 3W for 3° West
owner string Ownership type (P = Public, R = Military, etc.)
rwyNum string Number of runways
rwyLength string Longest runway class (L = Long, M = Medium, S = Short)
runways array Runway list including id / lengthM / widthM / surface / alignment
runways[].alignment number Magnetic runway heading (Degrees)
rawMETAR string Current raw METAR report
rawTAF string Current raw TAF report
Real-time Weather
GET /airport/metar/:icao Real-time METAR
Parameter Type Description
:icao string Required ICAO code
Response · 200 OK
{
  "icao": "VHHH",
  "metar": {
    "icaoId":    "VHHH",
    "iataId":    "HKG",
    "name":      "HONG KONG INTERNATIONAL AIRPORT",
    "obsTime":   1775467800,
    "temp":      28,
    "dewp":      23,
    "wdir":      200,
    "wspd":      14,
    "wspdMps":   7.2,
    "wgst":      null,
    "wgstMps":   0,
    "windUnit":  "KT",
    "visib":     ">10 km",
    "altim":     1005,
    "metarType": "METAR",
    "rawMETAR":  "METAR VHHH 060930Z 20014KT 170V230 9999 FEW008 SCT022 28/23 Q1005 NOSIG",
    "cover":     "SCT",
    "clouds": [
      { "cover": "FEW", "base": 800 },
      { "cover": "SCT", "base": 2200 }
    ],
    "fltCat":    "VFR"
  }
}
Field Description
Field Type Description
obsTime number Observation time (Unix timestamp, seconds)
temp number Temperature (°C)
dewp number Dew point (°C)
wdir number Wind direction (°, True North; VRB for variable)
wspd number Wind speed (unit defined in windUnit)
wspdMps number Converted wind speed (m/s)
wgst number | null Wind gust (unit defined in windUnit), null if no gust
wgstMps number Converted gust speed (m/s), 0 if no gust
windUnit string Wind speed unit: KT (Knots) or MPS (Meters per second)
visib string Visibility, e.g., ">10 km" or "1.2 km"
altim number Altimeter setting QNH (hPa)
metarType string Report type: METAR or SPECI
rawMETAR string Full raw METAR report
cover string Primary cloud cover code (CLR / FEW / SCT / BKN / OVC)
clouds[].cover string Cloud cover code for this layer
clouds[].base number Cloud base height (Feet AGL)
fltCat string Flight Category: VFR / MVFR / IFR / LIFR
GET /airport/taf/:icao Real-time TAF
Parameter Type Description
:icao string Required ICAO code
Response · 200 OK
{
  "icao": "VHHH",
  "taf": {
    "icaoId":        "VHHH",
    "iataId":        "HKG",
    "name":          "HONG KONG INTERNATIONAL AIRPORT",
    "issueTime":     "2026-04-06T08:00:00.000Z",
    "validTimeFrom": 1775466000,
    "validTimeTo":   1775574000,
    "rawTAF":        "TAF VHHH 060800Z 0609/0715 20010KT 9999 FEW010 SCT025 TX30/0706Z TN26/0622Z",
    "fcsts": [
      {
        "timeFrom":   1775466000,
        "timeTo":     1775574000,
        "fcstChange": null,
        "wdir":       200,
        "wspd":       10,
        "wgst":       null,
        "wspdMps":    5.1,
        "wgstMps":    0,
        "windUnit":   "KT",
        "visib":      ">10 km",
        "wxString":   null,
        "clouds": [
          { "cover": "FEW", "base": 1000 },
          { "cover": "SCT", "base": 2500 }
        ]
      }
    ]
  }
}
Field Description
Field Type Description
issueTime string TAF issuance time (ISO 8601, UTC)
validTimeFrom number Forecast validity start (Unix timestamp, seconds)
validTimeTo number Forecast validity end (Unix timestamp, seconds)
rawTAF string Full raw TAF report
fcsts array List of forecasts for different time periods
fcsts[].timeFrom / timeTo number Period start / end time (Unix timestamp, seconds)
fcsts[].fcstChange string | null Change group type (BECMG / TEMPO etc.), null for base forecast
fcsts[].wxString string | null Weather phenomena codes (e.g., -RA, TSRA), null if none
fcsts[].clouds array Forecast cloud layers, same structure as METAR
fcsts[].wgst number | null Forecast wind gust, null if none
Embed Pages

All embeddable pages support the ?embed=true parameter. When enabled, the navbar and footer will be hidden, making it ideal for iframe integration.

The search box on embed pages supports both ICAO codes and IATA codes, which differs from the API URL constraints.
Airport Info Search
Chinese
https://efb.dubhenexus.org/info?embed=true
English
https://efb.dubhenexus.org/en/info?embed=true
Chinese · Preset Airport
https://efb.dubhenexus.org/info?icao=:icao&embed=true
English · Preset Airport
https://efb.dubhenexus.org/en/info?icao=:icao&embed=true
Real-time Weather Search
Chinese
https://efb.dubhenexus.org/weather?embed=true
English
https://efb.dubhenexus.org/en/weather?embed=true
Chinese · Preset Airport
https://efb.dubhenexus.org/weather?icao=:icao&embed=true
English · Preset Airport
https://efb.dubhenexus.org/en/weather?icao=:icao&embed=true
iframe Integration Example
<iframe src="https://efb.dubhenexus.org/weather?icao=VHHH&embed=true" width="100%" height="600" frameborder="0" style="border-radius:10px;"></iframe>