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 three different, user-specified services:

Data from the DarkSky network is Powered By DarkSky, and provides a wealth of weather information worldwide. Aviationweather.gov provides measured weather information from weather stations around the world. Realtime weather data from the Singaporean government is also available for locations close to Singapore.

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 half hour increments. If you request weather data at a site over a two hour span, you will receive five weather reports - one at the beginning of the time span, and one every half hour after that. If you request weather along a route that takes two hours to traverse, you will also receive five weather results at half hour increments. The difference with route weather results is that the weather service will be queried for the weather based on your location along the route at each half hour increment.

{
    "Path": {},
    "AnalysisStart": "YYYY-MM-DDTHH:mm:ss",
    "AnalysisStop": "YYYY-MM-DDTHH:mm:ss",
    "Provider": "DarkSky"
}
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 "DarkSky", "AviationDotGov", "Singapore".

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": "2019-04-16T15:00:00",
    "AnalysisStop": "2019-04-16T16:00:00",
    "Provider": "DarkSky"
}
Output Sample: Single Site
[
    {
        "ResultTime": "2019-04-16T15:00:00+00:00",
        "AtmosphericPressure": 1006.08,
        "CloudCeiling": "NaN",
        "CloudCover": 0.13,
        "DewPoint": 25.16,
        "RelativeHumidity": 0.38,
        "Icon": "clear-day",
        "PrecipitationRate": 0,
        "PrecipitationType": null,
        "PrecipitationProbability": 0,
        "Temperature": 49.99,
        "TextSummary": "Clear",
        "Visibility": 10,
        "WindGust": 10.16,
        "WindSpeed": 2.45,
        "WindDirection": 144,
        "Notes": "Cloud ceiling reported from: Station KAFF, 3.4 mi away."
    },
    {
        "ResultTime": "2019-04-16T15:30:00+00:00",
        "AtmosphericPressure": 1005.72,
        "CloudCeiling": "NaN",
        "CloudCover": 0.07,
        "DewPoint": 26.93,
        "RelativeHumidity": 0.38,
        "Icon": "clear-day",
        "PrecipitationRate": 0,
        "PrecipitationType": null,
        "PrecipitationProbability": 0,
        "Temperature": 51.94,
        "TextSummary": "Clear",
        "Visibility": 10,
        "WindGust": 9.46,
        "WindSpeed": 4.3,
        "WindDirection": 161,
        "Notes": "Cloud ceiling reported from: Station KFLY, 11.3 mi away."
    },
    {
        "ResultTime": "2019-04-16T16:00:00+00:00",
        "AtmosphericPressure": 1005.36,
        "CloudCeiling": "NaN",
        "CloudCover": 0,
        "DewPoint": 28.71,
        "RelativeHumidity": 0.38,
        "Icon": "clear-day",
        "PrecipitationRate": 0,
        "PrecipitationType": null,
        "PrecipitationProbability": 0,
        "Temperature": 53.89,
        "TextSummary": "Clear",
        "Visibility": 10,
        "WindGust": 8.77,
        "WindSpeed": 6.31,
        "WindDirection": 168,
        "Notes": "Cloud ceiling reported from: Station KAFF, 3.4 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": "2019-04-16T14:30:00"
            },
            {
                "Position": {
                    "Latitude": 39.743635,
                    "Longitude": -104.607925,
                    "Altitude": 1800
                },
                "Time": "2019-04-16T16:30:00"
            }
        ],
        "IncludeWaypointsInRoute": true,
        "OutputSettings": {
            "Step": 900,
            "TimeFormat": "Epoch",
            "CoordinateFormat": {
                "Coord": "LLA"
            }
        }
    },
    "Provider": "AviationDotGov"
}
Output Sample: Point to Point Route
[
    {
        "Location": {
            "Latitude": 39.070960000000014,
            "Longitude": -104.78509,
            "Altitude": 1999.9999999992813
        },
        "ResultTime": "2019-04-16T14:30:00+00:00",
        "AtmosphericPressure": "NaN",
        "CloudCeiling": "NaN",
        "CloudCover": 0,
        "DewPoint": "NaN",
        "RelativeHumidity": "NaN",
        "Icon": "",
        "PrecipitationRate": "NaN",
        "PrecipitationType": "",
        "PrecipitationProbability": "NaN",
        "Temperature": 41,
        "TextSummary": "",
        "Visibility": 10,
        "WindGust": "NaN",
        "WindSpeed": 4.60312,
        "WindDirection": 260,
        "Notes": "Station KMNH, 12.6 mi away."
    },
    {
        "Location": {
            "Latitude": 39.239155786014237,
            "Longitude": -104.74111819753959,
            "Altitude": 1864.3569008019754
        },
        "ResultTime": "2019-04-16T14:54:00+00:00",
        "AtmosphericPressure": "NaN",
        "CloudCeiling": "NaN",
        "CloudCover": 0,
        "DewPoint": "NaN",
        "RelativeHumidity": "NaN",
        "Icon": "",
        "PrecipitationRate": "NaN",
        "PrecipitationType": "",
        "PrecipitationProbability": "NaN",
        "Temperature": 41,
        "TextSummary": "",
        "Visibility": 10,
        "WindGust": "NaN",
        "WindSpeed": 5.75389957,
        "WindDirection": 10,
        "Notes": "Station KMNH, 5.1 mi away."
    },
    {
        "Location": {
            "Latitude": 39.407335684450139,
            "Longitude": -104.69693442131424,
            "Altitude": 1785.8091506763794
        },
        "ResultTime": "2019-04-16T15:30:00+00:00",
        "AtmosphericPressure": "NaN",
        "CloudCeiling": "NaN",
        "CloudCover": 0,
        "DewPoint": "NaN",
        "RelativeHumidity": "NaN",
        "Icon": "",
        "PrecipitationRate": "NaN",
        "PrecipitationType": "",
        "PrecipitationProbability": "NaN",
        "Temperature": 42.8,
        "TextSummary": "",
        "Visibility": 10,
        "WindGust": "NaN",
        "WindSpeed": 3.45234,
        "WindDirection": 290,
        "Notes": "Station KMNH, 13.2 mi away."
    },
    {
        "Location": {
            "Latitude": 39.575496490798173,
            "Longitude": -104.65253718776773,
            "Altitude": 1764.3572098426666
        },
        "ResultTime": "2019-04-16T15:53:00+00:00",
        "AtmosphericPressure": 1008,
        "CloudCeiling": 22000,
        "CloudCover": 0.25,
        "DewPoint": "NaN",
        "RelativeHumidity": "NaN",
        "Icon": "",
        "PrecipitationRate": "NaN",
        "PrecipitationType": "",
        "PrecipitationProbability": "NaN",
        "Temperature": 50,
        "TextSummary": "",
        "Visibility": 10,
        "WindGust": "NaN",
        "WindSpeed": 0,
        "WindDirection": 0,
        "Notes": "Station KAPA, 10.5 mi away."
    },
    {
        "Location": {
            "Latitude": 39.743634999999983,
            "Longitude": -104.607925,
            "Altitude": 1800.0000000003433
        },
        "ResultTime": "2019-04-16T16:18:00+00:00",
        "AtmosphericPressure": "NaN",
        "CloudCeiling": "NaN",
        "CloudCover": 0,
        "DewPoint": "NaN",
        "RelativeHumidity": "NaN",
        "Icon": "",
        "PrecipitationRate": "NaN",
        "PrecipitationType": "",
        "PrecipitationProbability": "NaN",
        "Temperature": 54.86,
        "TextSummary": "",
        "Visibility": 10,
        "WindGust": "NaN",
        "WindSpeed": 0,
        "WindDirection": 0,
        "Notes": "Station KEIK, 30.3 mi away."
    },
    {
        "Location": {
            "Latitude": 39.743634999999983,
            "Longitude": -104.607925,
            "Altitude": 1800.0000000003433
        },
        "ResultTime": "2019-04-16T16:18:00+00:00",
        "AtmosphericPressure": "NaN",
        "CloudCeiling": "NaN",
        "CloudCover": 0,
        "DewPoint": "NaN",
        "RelativeHumidity": "NaN",
        "Icon": "",
        "PrecipitationRate": "NaN",
        "PrecipitationType": "",
        "PrecipitationProbability": "NaN",
        "Temperature": 54.86,
        "TextSummary": "",
        "Visibility": 10,
        "WindGust": "NaN",
        "WindSpeed": 0,
        "WindDirection": 0,
        "Notes": "Station KEIK, 30.3 mi away."
    }
]