v1

latestSwagger 2.02026-07-132137180.4 KB
240 hour / hourly Forecast

Returns an hourly forecast - Given a lat/lon.

Returns an hourly forecast, where each point represents a one hour period.

get/forecast/hourly

Query parameters

latnumber double

Latitude component of location.

lonnumber double

Longitude component of location.

citystring string

City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR

postal_codestring string

Postal Code. Example: 28546

countrystring string

Country Code (2 letter) - to be used with postal_code.

stationstring string

Station Call ID.

units'S' | 'I' | 'M' string

Convert to units. Default Metric. Options (I = Imperial, M = Metric, S = Scientific)

lang'ar' | 'az' | 'be' | 'bg' | 'bs' | 'ca' | 'cs' | 'de' | 'fi' | 'fr' | 'el' | 'es' | 'et' | 'hr' | 'hu' | 'id' | 'it' | 'is' | 'kw' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'tr' | 'uk' | 'zh' | 'zh-tw' string

Language (Default: English) See <a target='blank' href='/api/requests'>language field description</a>

hoursinteger

Number of hours to return.

keystring string required

Your registered API key.

Response

A forecast object.

city_namestring

Nearest city name

state_codestring

State Abbreviation

country_codestring

Country Abbreviation

latnumber

Latitude

lonnumber

Longitude

timezonestring

Local IANA time zone

Example response

{
  "city_name": "Raleigh",
  "state_code": "NC",
  "country_code": "US",
  "lat": 38.25,
  "lon": -78,
  "timezone": "America/New_York",
  "data": [
    {
      "timestamp_local": "2019-03-04T12:00:00",
      "timestamp_utc": "2019-03-04T17:00:00",
      "datetime": "2019-03-04:17",
      "snow": 10.45,
      "snow_depth": 45,
      "precip": 1.1,
      "temp": -1.5,
      "dewpt": -4,
      "app_temp": 4.5,
      "rh": 95,
      "clouds": 100,
      "clouds_low": 65,
      "clouds_mid": 100,
      "clouds_hi": 100,
      "weather": {
        "icon": "s02d",
        "code": 601,
        "description": "Snow"
      },
      "slp": 1012.89,
      "pres": 1005,
      "uv": 6.5,
      "ozone": 340,
      "solar_rad": 320,
      "ghi": 1000,
      "dhi": 200,
      "dni": 400,
      "vis": 1,
      "pod": "d",
      "pop": 75,
      "wind_spd": 13.85,
      "wind_gust_spd": 16.85,
      "wind_dir": 105,
      "wind_cdir": "ENE",
      "wind_cdir_full": "East-North-East"
    }
  ]
}