Providing RESTful interfaces for airport information and real-time aviation weather data, along with embeddable service pages for third-party integration.
VHHH). IATA
codes are not accepted.
| Parameter | Type | Description |
|---|---|---|
| :icao | string Required | 4-letter ICAO code, e.g., VHHH. Only ICAO is
accepted. |
{
"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 | 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 |
| Parameter | Type | Description |
|---|---|---|
| :icao | string Required | ICAO code |
{
"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 | 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 |
| Parameter | Type | Description |
|---|---|---|
| :icao | string Required | ICAO code |
{
"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 | 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 |
All embeddable pages support the ?embed=true
parameter. When enabled, the navbar and footer will be hidden, making it ideal for iframe integration.
<iframe src="https://efb.dubhenexus.org/weather?icao=VHHH&embed=true" width="100%" height="600" frameborder="0" style="border-radius:10px;"></iframe>