This API returns a 10 day forecast in 1 hour intervals for any point on the planet. Forecast spatial resolution ranges from 1 KM to 13 KM depending on region.

Coverage:

Global

Variables:

Local time
UTC Time
Temperature (Celsius)
Dew Point Temperature (Celsius)
Apparent Temperature (Celsius)
Relative Humidity (%)
Pressure (millibar)
Sea Level Pressure (millibar)
Wind Speed (m/s)
Wind Gust (m/s)
Wind Direction (degrees)
Weather condition (Description)
Sky cloud cover - Low / Mid / High / Avg (%)
Solar -> Solar Radiation, GHI, DHI, DNI (W/m^2)
UV Index (0-11+)
Visibility (KM)
Precipitation Probability (%)
Precipitation (mm)
Snowfall (mm)

Request

Users may provide either a latitude and longitude, or postal code (zip code) and country code. Most country postal codes are supported. If using a postal code, please specify the "top-level" or "outward" postal code only. For the US that is the first 5 digits of the postal code.

Examples (latitude/longitude):
"lat=35.75&lon=-78.55"
"lat=-33.871473&lon=151.028290"

Examples (postal/zip code):
"postal_code=27601&country=US"
"postal_code=01067&country=DE"
"postal_code=BD7&country=UK"

Quota

This plan allows for 150,000 requests per day. For higher quota/usage - please see:

https://aws.amazon.com/marketplace/pp/prodview-vnhxgojd7p3nk

Response

{  
             "data":[  
                {  
                   "timestamp_local": "2018-04-02T00:00:00",
                   "timestamp_utc": "2018-04-03T04:00:00",
                   "ts":1503954000,
                   "datetime":"2017-04-03:04",
                   "wind_gust_spd":16.7,
                   "wind_spd":6.4,
                   "wind_dir":45,
                   "wind_cdir":"NE",
                   "wind_cdir_full":"northeast",
                   "temp":25,
                   "app_temp":23,
                   "pop":0,
                   "precip":0,
                   "snow":0,
                   "snow_depth":0,
                   "slp":1017,
                   "pres":1003.5,
                   "dewpt":17.8,
                   "rh":64.3,
                   "weather":{  
                      "icon":"c04d",
                      "code":"804",
                      "description":"Overcast clouds"
                   },
                   "pod":"d",
                   "clouds_low":25,
                   "clouds_mid":100,
                   "clouds_hi":50,
                   "clouds":100,
                   "vis":10,
                   "dhi":178,
                   "dni":3,
                   "ghi":200,
                   "solar_rad":75.8,
                   "uv":2,
                   "ozone":384.5
                }, ...
             ],
             "city_name":"Raleigh",
             "lon":"-78.63861",
             "timezone":"America\/New_York",
             "lat":"35.7721",
             "country_code":"US",
             "state_code":"NC"
          }

Field Description

lat: Latitude (Degrees).
lon: Longitude (Degrees).
timezone: Local IANA Timezone.
city_name: City name.
country_code: Country abbreviation.
state_code: State abbreviation/code.
data: [
    ts: Unix Timestamp at UTC time.
    timestamp_local: Timestamp at local time.
    timestamp_utc: Timestamp at UTC time.
    wind_gust_spd: Wind gust speed (Default m/s).
    wind_spd: Wind speed (Default m/s).
    wind_dir: Wind direction (degrees).
    wind_cdir: Abbreviated wind direction.
    wind_cdir_full: Verbal wind direction.
    temp: Temperature (default Celcius).
    app_temp: Apparent/"Feels Like" temperature (default Celcius).
    pop: Probability of Precipitation (%).
    precip: Accumulated liquid equivalent precipitation (default mm).
    snow: Accumulated snowfall (default mm).
    snow_depth: Snow Depth (default mm).
    slp: Sea level pressure (mb).
    pres: Pressure (mb).
    dewpt: Dew point (default Celcius).
    rh: Relative humidity (%).
    clouds_low: Low-level (~0-3km AGL) cloud coverage (%).
    clouds_mid: Mid-level (~3-5km AGL) cloud coverage (%).
    clouds_hi: High-level (>5km AGL) cloud coverage (%).
    clouds: Cloud coverage (%).
    weather: {
        icon:Weather icon code.
        code:Weather code.
        description: Text weather description.
    }
    pod: Part of the day (d = day / n = night).
    uv: UV Index (0-11+).
    dhi: Diffuse horizontal solar irradiance (W/m^2) [Clear Sky]
    dni: Direct normal solar irradiance (W/m^2) [Clear Sky]
    ghi: Global horizontal solar irradiance (W/m^2) [Clear Sky]
    solar_rad: Estimated Solar Radiation (W/m^2).
    vis: Visibility (default KM).
    ozone: Average Ozone (Dobson units).
... ]

URL Parameters (Options)

Default units are in Metric. Users may specify the "units" URL parameter to change from metric to imperial via "&units=imperial". Units will be converted as follows:

Celsius -> Fahrenheit
KM -> Miles
mm/hr -> inches / hr
m/s -> mph (miles/hr)

Example:

"lat=-33.871473&lon=151.028290&units=imperial"

CLI Request Syntax

The following is the syntax to use if you wish to use the aws CLI tool to submit a request to this API.

aws dataexchange send-api-asset --data-set-id <DATA_SET_ID> --revision-id <REVISION_ID> --asset-id <ASSET_ID> --method GET --path "/hourly-forecast" --query-string-parameters 'lat=<LATITUDE>&lon=<LONGITUDE>'

OR

aws dataexchange send-api-asset --data-set-id <DATA_SET_ID> --revision-id <REVISION_ID> --asset-id <ASSET_ID> --method GET --path "/hourly-forecast" --query-string-parameters 'postal_code=<POSTAL_CODE>'

*The values between "<>" should be replaced with the appropriate values for your subscription which you can find in the AWS Console.

Example request

Retrieve the current weather conditions for New York City, NY (lat: 40.745680, lon: -73.990922) with imperial units.

aws dataexchange send-api-asset --data-set-id <DATA_SET_ID> --revision-id <REVISION_ID> --asset-id <ASSET_ID> --method GET --path "/hourly-forecast" --query-string-parameters 'lat=40.745680&lon=-73.990922&units=imperial'