Common Weather Service

Summary

Retrieve airport weather for a specific station

Request

Code snippet: URL

GET /v1/flight_operations/crew_services/COMMON_AIRPORT_WEATHER

Parameters

Name Type Description Required Schema / Format
station Query IATA station code yes

xsd:string

[A-Z]{3}

forTimeStamp Query If specified only return the forecast that is closest to the given time stamp, otherwise return all available forecasts. no

xsd:dateTime

Responses

Code Description Content-Type Schema
200 Airport weather returned successfully
application/json Common Weather Service Model
409 Invalid parameters, e.g. missing airport code
application/json Processing Errors Model
500 airport does not exist or no weather available
application/json Processing Errors Model

Common Weather Service

Code snippet: Payload

{
  "cityCode" → xsd:string
  "currentTime" → xsd:string
  "currentTemperatureC"  → xsd:integer
  "currentTemperatureF" → xsd:integer
  "conditionCode" → xsd:integer
  "humidity" → xsd:integer
  "windDirection" → xsd:string
  "windSpeed" → xsd:integer
  "forecasts" → [
      "forecastDate" → xsd:string
      "conditionCode" → xsd:integer
      "minTemperatureC" → xsd:integer
      "minTemperatureF" → xsd:integer
      "maxTemperatureC" → xsd:integer
      "maxTemperatureF" → xsd:integer
  ]
}
Name Description Required Schema / Format

cityCode

City code of requested airport yes

xsd:string

[A-Z]{3}

currentTime

Timestamp of current values no xsd:datetime
currentTemperatureC current temperature in Celsius no xsd:integer
currentTemperatureF current temperature in Fahrenheit no xsd:integer
conditionCode Weather condition code
no

xsd:string

see Condition Code Table

humidity Humidity no xsd:integer
windDirection Wind directorion
no

xsd:string

N|E|S|W|NE|NW|SE|SW

windSpeed Wind speed no xsd:integer

forecasts[]


no

forecasts[] → forecastDate

Date of forecast yes

xsd:date

forecasts[] → conditionCode

Weather condition code no

xsd:string

see Condition Code Table

forecasts[] → minTemperatureC

Minimum temperature in Celsius no

xsd:integer

forecasts[] → minTemperatureF

Minimum temperature in Fahrenheit no
xsd:integer

forecasts[] → maxTemperatureC

Maximum temperature in Celsius no
xsd:integer

forecasts[] → maxTemperatureF

Maximum temperature in Fahrenheit no
xsd:integer

Condition Code Translation (German)

{
"0"  : "sonnig",
"1"  : "leicht bewölkt",
"2"  : "wolkig",
"3"  : "bedeckt",
"4"  : "Nebel",
"45" : "Nebel",
"48" : "Nebel mit Reifbildung",
"49" : "Nebel mit Reifbildung",
"5"  : "Sprühregen",
"50" : "Sprühregen",
"51" : "leichter Sprühregen",
"53" : "Sprühregen",
"55" : "starker Sprühregen",
"56" : "leichter Sprühregen, gefrierend",
"57" : "starker Sprühregen, gefrierend",
"6"  : "Regen",
"60" : "leichter Regen",
"61" : "leichter Regen",
"63" : "mäßiger Regen",
"65" : "starker Regen",
"66" : "leichter Regen, gefrierend",
"67" : "mäßiger od. starker Regen, gefrierend",
"68" : "leichter Schnee-Regen",
"69" : "starker Schnee-Regen",
"7"  : "Schnee",
"70" : "leichter Schneefall",
"71" : "leichter Schneefall",
"73" : "mäßiger Schneefall",
"75" : "starker Schneefall",
"8"  : "Schauer",
"80" : "leichter Regenschauer",
"81" : "Regenschauer",
"82" : "starker Regenschauer",
"83" : "leichter Schnee/Regen-Schauer",
"84" : "starker Schnee/Regen-Schauer",
"85" : "leichter Schneeschauer",
"86" : "mäßiger od. starker Schneeschauer",
"9"  : "Gewitter",
"95" : "leichtes od. mäßiges Gewitter",
"96" : "starkes Gewitter (od. Gewitter mit Graupel/Hagel)"
}

Example

Request

Code snippet: Get request
GET /v1/flight_operations/crew_services/COMMON_AIRPORT_WEATHER?station=JFK

Response

Code snippet: Json
{
  "cityCode": "NYC",
  "currentTime": "2020-03-02Z",
  "currentTemperatureC": 12,
  "currentTemperatureF": 54,
  "conditionCode": 2,
  "humidity": 43,
  "windDirection": "S",
  "windSpeed": 18,
  "forecasts": [
    {
      "forecastDate": "2020-03-02Z",
      "conditionCode": 20,
      "minTemperatureC": 9,
      "minTemperatureF": 48,
      "maxTemperatureC": 13,
      "maxTemperatureF": 55
    },
    {
      "forecastDate": "2020-03-03Z",
      "conditionCode": 10,
      "minTemperatureC": 8,
      "minTemperatureF": 46,
      "maxTemperatureC": 13,
      "maxTemperatureF": 55
    },
    {
      "forecastDate": "2020-03-04Z",
      "conditionCode": 10,
      "minTemperatureC": 6,
      "minTemperatureF": 43,
      "maxTemperatureC": 12,
      "maxTemperatureF": 54
    },
    {
      "forecastDate": "2020-03-05Z",
      "conditionCode": 10,
      "minTemperatureC": 6,
      "minTemperatureF": 43,
      "maxTemperatureC": 10,
      "maxTemperatureF": 50
    },
    {
      "forecastDate": "2020-03-06Z",
      "conditionCode": 10,
      "minTemperatureC": 2,
      "minTemperatureF": 36,
      "maxTemperatureC": 6,
      "maxTemperatureF": 43
    },
    {
      "forecastDate": "2020-03-07Z",
      "conditionCode": 10,
      "minTemperatureC": 1,
      "minTemperatureF": 34,
      "maxTemperatureC": 8,
      "maxTemperatureF": 46
    },
    {
      "forecastDate": "2020-03-08Z",
      "conditionCode": 10,
      "minTemperatureC": 4,
      "minTemperatureF": 39,
      "maxTemperatureC": 11,
      "maxTemperatureF": 52
    }
  ]
}