SDSP SERVICES

Weather Services

Weather information

This service provides weather information for the world, when you specify either a single location, or a point to point route. Weather data is provided by two different, user-specified services:

API Paths
weather/site
weather/pointToPoint
HTTP Method
POST
Input Format

All weather service requests can be performed at a site or along a point to point route, as specified in the API paths above. For the Path element below, use the JSON from the point to point route or a site location.

Weather data is provided within the time span requested, at varying increments. Data for Singapore is available in half-hour increments, and data for AviationWeather.gov is available in 1 hour increments. Route weather results will be queried for the weather based on your location along the route at each increment. 

{
    "Path": {},
    "AnalysisStart": "YYYY-MM-DDTHH:mm:ss",
    "AnalysisStop": "YYYY-MM-DDTHH:mm:ss",
    "Provider": "AviationDotGov",
    "StartSearchRadius": 30,
    "ExtendedSearchRadius": 100
}
Path
JSON object defining the location or route for which weather information be queried.
AnalysisStart
The start date and time of the weather report. Required for site paths, ignored when the Path is a route.
AnalysisStop
The stop date and time of the weather report. Required for site paths, ignored when the Path is a route.
Provider
The weather provider you want to use for your weather report. Required. Valid values are "AviationDotGov", "Singapore".
StartSearchRadius
The radius in miles, to look for an ICAO station centered on your input path location. Optional, default is 30.
ExtendedSearchRadius
The radius in miles, to search for an ICAO station centered on your input path location, if one is not found within the StartSearchRadius. Optional, default is 100.

Notes on the weather result outputs:

  1. Not all weather result values are produced by all providers. To keep our API consistent, we will place a "NaN" in any specific weather result value if that value cannot be obtained for any reason. Be sure to check for a NaN before using a particular value from the weather result.
  2. Cloud Ceiling values are calculated using data from the AviationWeather.gov provider. If you use other providers, a secondary query to aviationweather.gov will be made by this service to obtain data from which a cloud ceiling value can be calculated. The "Notes" output field in the weather result will describe which site provided this data. Additionally, if the Cloud Ceiling value is NaN, there is no ceiling specified.

Input Sample: Single Site

This sample shows the weather reports at a single site. 

{
  "Path": {
    "Location": {
      "Latitude": 39.0,
      "Longitude": -104.77,
      "Altitude": 2000.0
    }
  },
  "AnalysisStart": "2023-10-16T15:00:00",
  "AnalysisStop": "2023-10-16T16:00:00",
  "Provider": "AviationDotGov"
}
Output Sample: Single Site
[
  {
    "ResultTime": "2023-10-16T15:55:00+00:00",
    "AtmosphericPressure": 1026.2,
    "CloudCeiling": "NaN",
    "CloudCover": 0.0,
    "DewPoint": "NaN",
    "RelativeHumidity": "NaN",
    "Icon": "",
    "PrecipitationRate": "NaN",
    "PrecipitationType": "",
    "PrecipitationProbability": "NaN",
    "Temperature": 58.46,
    "TextSummary": "",
    "Visibility": 10.0,
    "WindGust": "NaN",
    "WindSpeed": 4.60312,
    "WindDirection": 30.0,
    "Notes": "Station KAFF, 3.2 mi away."
  }
]
Input Sample: Point to Point Route

This sample shows the weather reports for a point to point route. 

{
  "Path": {
    "Waypoints": [
      {
        "Position": {
          "Latitude": 39.07096,
          "Longitude": -104.78509,
          "Altitude": 2000
        },
        "Time": "2023-10-15T14:30:00"
      },
      {
        "Position": {
          "Latitude": 39.743635,
          "Longitude": -104.607925,
          "Altitude": 1800
        },
        "Time": "2023-10-15T16:30:00"
      }
    ],
    "IncludeWaypointsInRoute": true,
    "OutputSettings": {
      "Step": 900,
      "TimeFormat": "Epoch",
      "CoordinateFormat": {
        "Coord": "LLA"
      }
    }
  },
  "Provider": "AviationDotGov",
  "StartSearchRadius": 50,
  "ExtendedSearchRadius": 200
}
Output Sample: Point to Point Route
[
  {
    "Location": {
      "Latitude": 39.070960000000014,
      "Longitude": -104.78509,
      "Altitude": 1999.9999999992813
    },
    "ResultTime": "2023-10-15T14:35:00+00:00",
    "AtmosphericPressure": "NaN",
    "CloudCeiling": "NaN",
    "CloudCover": 0.0,
    "DewPoint": "NaN",
    "RelativeHumidity": "NaN",
    "Icon": "",
    "PrecipitationRate": "NaN",
    "PrecipitationType": "",
    "PrecipitationProbability": "NaN",
    "Temperature": 44.6,
    "TextSummary": "",
    "Visibility": 10.0,
    "WindGust": "NaN",
    "WindSpeed": 4.60312,
    "WindDirection": 250.0,
    "Notes": "Station KMNH, 13.0 mi away."
  },
  {
    "Location": {
      "Latitude": 39.239155786014244,
      "Longitude": -104.74111819753959,
      "Altitude": 1864.3569008019758
    },
    "ResultTime": "2023-10-15T14:55:00+00:00",
    "AtmosphericPressure": "NaN",
    "CloudCeiling": "NaN",
    "CloudCover": 0.0,
    "DewPoint": "NaN",
    "RelativeHumidity": "NaN",
    "Icon": "",
    "PrecipitationRate": "NaN",
    "PrecipitationType": "",
    "PrecipitationProbability": "NaN",
    "Temperature": 46.4,
    "TextSummary": "",
    "Visibility": 10.0,
    "WindGust": "NaN",
    "WindSpeed": 4.60312,
    "WindDirection": 270.0,
    "Notes": "Station KMNH, 5.4 mi away."
  },
  {
    "Location": {
      "Latitude": 39.407335684450139,
      "Longitude": -104.69693442131424,
      "Altitude": 1785.8091506777123
    },
    "ResultTime": "2023-10-15T15:35:00+00:00",
    "AtmosphericPressure": "NaN",
    "CloudCeiling": "NaN",
    "CloudCover": 0.0,
    "DewPoint": "NaN",
    "RelativeHumidity": "NaN",
    "Icon": "",
    "PrecipitationRate": "NaN",
    "PrecipitationType": "",
    "PrecipitationProbability": "NaN",
    "Temperature": 51.8,
    "TextSummary": "",
    "Visibility": 10.0,
    "WindGust": "NaN",
    "WindSpeed": 8.05546,
    "WindDirection": 340.0,
    "Notes": "Station KMNH, 13.0 mi away."
  },
  {
    "Location": {
      "Latitude": 39.57549649079818,
      "Longitude": -104.65253718776773,
      "Altitude": 1764.357209844
    },
    "ResultTime": "2023-10-15T15:53:00+00:00",
    "AtmosphericPressure": 1030.0,
    "CloudCeiling": "NaN",
    "CloudCover": 0.25,
    "DewPoint": "NaN",
    "RelativeHumidity": "NaN",
    "Icon": "",
    "PrecipitationRate": "NaN",
    "PrecipitationType": "",
    "PrecipitationProbability": "NaN",
    "Temperature": 53.96,
    "TextSummary": "",
    "Visibility": 10.0,
    "WindGust": "NaN",
    "WindSpeed": 3.45234,
    "WindDirection": 330.0,
    "Notes": "Station KAPA, 10.5 mi away."
  },
  {
    "Location": {
      "Latitude": 39.743635,
      "Longitude": -104.607925,
      "Altitude": 1800.0000000010818
    },
    "ResultTime": "2023-10-15T16:45:00+00:00",
    "AtmosphericPressure": "NaN",
    "CloudCeiling": "NaN",
    "CloudCover": 0.0,
    "DewPoint": "NaN",
    "RelativeHumidity": "NaN",
    "Icon": "",
    "PrecipitationRate": "NaN",
    "PrecipitationType": "",
    "PrecipitationProbability": "NaN",
    "Temperature": 57.2,
    "TextSummary": "",
    "Visibility": 10.0,
    "WindGust": "NaN",
    "WindSpeed": 5.75389957,
    "WindDirection": "NaN",
    "Notes": "Station KBJC, 28.5 mi away."
  }
]