v1

latestSwagger 2.02026-07-132137180.4 KB

Current Weather Data

Returns a Current Observation - Given a lat/lon.

Returns a Current Observation - given a lat, and a lon.

get/current

Query parameters

latnumber double

Latitude component of location.

lonnumber double

Longitude component of location.

includestring[]

Include optional current weather add-ons in the response. Accepts a comma separated list of minutely, lightning, and/or alerts.

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.

pointsstring string

Comma separated list of points. Example: (35.5, -75.5),(45, 65),(45.12, -130.5)

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>

keystring string required

Your registered API key.

Response

An Observation Group object.

countinteger

Count of found observations

Example response

{
  "data": [
    {
      "city_name": "Raleigh",
      "state_code": "NC",
      "country_code": "US",
      "timezone": "America/New_York",
      "lat": 38,
      "lon": -78.25,
      "station": "KRDU",
      "sources": [
        "rtma"
      ],
      "vis": 2.2,
      "rh": 75,
      "dewpt": 12,
      "wind_dir": 125,
      "wind_cdir": "ENE",
      "wind_cdir_full": "East-North-East",
      "wind_spd": 5.85,
      "gust": 9,
      "temp": 13.85,
      "app_temp": 14.85,
      "clouds": 42,
      "weather": {
        "icon": "c02",
        "code": 802,
        "description": "Broken clouds"
      },
      "datetime": "2017-03-15:13",
      "ob_time": "2017-03-15 13:11",
      "ts": 1490990400,
      "sunrise": "06:22",
      "sunset": "19:34",
      "slp": 1013.12,
      "pres": 1010,
      "aqi": 50,
      "uv": 6.5,
      "solar_rad": 300.4,
      "ghi": 450.4,
      "dni": 450.4,
      "dhi": 450.4,
      "elev_angle": 37,
      "hour_angle": 45,
      "h_angle": 45,
      "precip": 2,
      "snow": 10
    }
  ],
  "minutely": [
    {
      "timestamp_utc": "2017-03-15 13:11",
      "timestamp_local": "2017-03-15 13:11",
      "precip": 2,
      "temp": 13.85,
      "snow": 10
    }
  ]
}