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

Coverage:

Global

Variables:

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

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":[  
                {  
                  "valid_date":"2017-04-01",
                   "ts":1503954000,
                   "datetime":"2017-04-01",
                   "wind_gust_spd":16.7,
                   "wind_spd":6.4,
                   "wind_dir":45,
                   "wind_cdir":"NE",
                   "wind_cdir_full":"northeast",
                   "temp":25,
                   "max_temp":30,
                   "min_temp":26,
                   "high_temp":30,
                   "low_temp":24.5,
                   "app_max_temp":30.64,
                   "app_min_temp":23.64,
                   "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"
                   },
                   "clouds_low":25,
                   "clouds_mid":100,
                   "clouds_hi":50,
                   "clouds":100,
                   "vis":10,
                   "max_dhi":178,
                   "uv":2,
                   "moon_phase":0.99,
                   "moon_phase_lunation":0.48,
                   "moonrise_ts":1530341260,
                   "moonset_ts":1530351260,
                   "sunrise_ts":1530321260,
                   "sunset_ts":1530391260
                }, ...
             ],
             "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: Nearest city name
country_code: Country abbreviation
state_code: State abbreviation/code
data: [
    valid_date:Local date the forecast is valid for in format YYYY-MM-DD
    ts: Forecast period start unix timestamp (UTC)
    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: Average Temperature (default Celcius)
    max_temp: Maximum Temperature - Calculated from Midnight to Midnight local time (default Celcius)
    min_temp: Minimum Temperature - Calculated from Midnight to Midnight local time (default Celcius)
    high_temp: High Temperature "Day-time High" - Calculated from 7 AM to 7 PM local time (default Celcius)
    low_temp: Low Temperature "Night-time Low" - Calculated from 7 PM to 7 AM local (default Celcius)
    app_max_temp: Apparent/"Feels Like" temperature at max_temp time (default Celcius)
    app_min_temp: Apparent/"Feels Like" temperature at min_temp time (default Celcius)
    pop: Probability of Precipitation (%)
    precip: Accumulated liquid equivalent precipitation (default mm)
    snow: Accumulated snowfall (default mm)
    snow_depth: Snow Depth (default mm)
    pres: Average pressure (mb)
    slp: Average sea level pressure (mb)
    dewpt: Average dew point (default Celcius)
    rh: Average relative humidity (%)
    weather: {
        icon:Weather icon code
        code:Weather code
        description: Text weather description
    }
    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: Average total cloud coverage (%)
    vis: Visibility (default KM)
    uv: Maximum UV Index (0-11+)
    ozone: Average Ozone (Dobson units)
    moon_phase: Moon phase illumination fraction (0-1)
    moon_phase_lunation: Moon lunation fraction (0 = New moon, 0.50 = Full Moon, 0.75 = Last quarter moon)
    moonrise_ts: Moonrise time unix timestamp (UTC)
    moonset_ts: Moonset time unix timestamp (UTC)
    sunrise_ts: Sunrise time unix timestamp (UTC)
    sunset_ts: Sunset time unix timestamp (UTC)
... ]

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 "/daily-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 "/daily-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 "/daily-forecast" --query-string-parameters 'lat=40.745680&lon=-73.990922&units=imperial'