This API returns an accurate 1 hour (60 minute) precipitation forecast for any point on the planet using both radar, and weather model data.

Coverage:

Global

Variables:

Local time
UTC Time
Precipitation (mm)
Snowfall (mm)
Temperature (Celsius)

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

 {  
             "city_name":"Raleigh",
             "lon":"-78.63861",
             "timezone":"America\/New_York",
             "lat":"35.7721",
             "country_code":"US",
             "state_code":"NC",
             "data":[  
                {
                   "timestamp_utc":"2021-01-16T21:14:00",
                   "timestamp_local":"2021-01-16T16:14:00",
                   "ts":1610834100,
                   "precip":0.103,
                   "snow":1.028
                },
                {
                   "timestamp_utc":"2021-01-16T21:15:00",
                   "timestamp_local":"2021-01-16T16:15:00",
                   "ts":1610834100,
                   "precip":0.009,
                   "snow":0.850
                }, ...
             ]
          }

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.
    precip: Liquid Equivalent Precipitation rate (default mm/hr).
    snow: Snowfall rate (default mm/hr).
... ]

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