Observations

Get latest METAR station observations as GeoJSON.

Returns a GeoJSON FeatureCollection of METAR surface observations ingested from MADIS. By default returns the latest observation per station within the last 2 hours. hours or station switches to every report in a lookback window, newest first: hours sets the window (1-24 hours) and station limits it to one station (window 1 hour unless hours is set).

A bounding box (min_lon, min_lat, max_lon, max_lat) filters only the default latest-per-station view, so combining it with hours or station is a 400. It needs all four values as finite numbers with -180 <= min_lon <= max_lon <= 180 and -90 <= min_lat <= max_lat <= 90 (antimeridian-crossing boxes are not supported); a partial, non-numeric, out-of-range or inverted box is a 400. Empty-valued bbox params count as absent. A non-integer hours, or one outside 1-24, is a 400, as is repeating hours, station or a bbox key.

Point parameters (lat, lon, lng, latitude, longitude, zip, location, n, radius) are not accepted here and return 400; for the stations nearest a point use GET /v1/observations/nearest.

An area (a bounding box) that touches none of the US domains (CONUS, Alaska, Hawaii) returns 404 outside-coverage with next_steps; a box that touches one is served as is and may include area outside the US. station is not checked.

get/v1/observations

Request

  • Base URL: https://api.smarterweather.com
  • URL: https://api.smarterweather.com/v1/observations
  • Auth: HTTP bearer

Query parameters

stationstring

ICAO station identifier (e.g. KORD), case-insensitive. Returns every report from that station in the last hours hours (default 1), newest first. Cannot be combined with a bounding box.

hoursinteger

Lookback window in whole hours (1-24). When set, returns every report in the window, newest first, instead of the latest report per station. Unset: the latest report per station within the last 2 hours. Cannot be combined with a bounding box.

min_lonnumber

West edge of the bounding box (degrees). Give all four box values together; the box filters the latest report per station.

min_latnumber

South edge of the bounding box (degrees).

max_lonnumber

East edge of the bounding box (degrees).

max_latnumber

North edge of the bounding box (degrees).

Response

GeoJSON FeatureCollection of METAR observations.

Changes

No recorded changes to this operation across all 1 revision of this API.