Last modified March 13, 2012

Endpoints

Endpoints refer to the types of data to request, such as a place, observation, forecast or advisory, and will be the basis for any request made to the API. The following endpoints are currently supported within Aeris.

To query multiple endpoints with a single API request review the Batch Requests feature.

All endpoints support the Schema Action, which will return the JSON specification for the endpoint.

Endpoint Description Actions
advisories

The advisories data set provides access to all currently active advisories as issued by the National Weather Service (NWS). The NWS issues a variety of severe weather warnings, watches, advisories and statements that may be issued for a single forecast zone or county, or for a larger region.

id
closest
within
search
countries

The countries dataset provides the core data for countries, returning the full name, abbreviations, capital, population area, and neighboring countries.

id
search
earthquakes

The earthquake data set provides information on US and international earthquakes, including location, mangnitude, depth and more.

id
closest
within
search
affects
fires

The fires data set contains data for all of the active wildfires across the U.S., including type of fire, area, cause and percent contained.

id
closest
within
search
forecasts

The forecasts endpoint provides the core forecast data for US and international locations. Forecast data is available in various intervals, such as 24-, 12-, 6-, 3- and 1-hour intervals.

id
closest
normals

The normals endpoints provides access to the climate normal’s for US locations.

id
closest
within
search
normals/stations

The normals_stations dataset provides access to the complete Coop/Station information that normals are available for.

id
closest
within
search
observations

The observations data set provides access to current and archived weather observations from a variety of reporting stations. The primary source for observation data comes from METARs located at airports or permanent weather stations. METAR reports are generated once an hour, but if conditions change significantly, then additional special reports may be issued. Other sources, such as personal weather stations (PWS), may update more frequently but are not official stations used by NOAA.

closest
within
search
observations/archive

The observations/archive endpoint provides access to a full day of observations from our archive based on your subscription level. A day of archived observations is based on UTC time from Midnight - 11:59:00pm.

id
closest
within
search
observations/recent

The observations/recent endpoint provides access to recent observations, up to the past 30 days depending on API service level. Since this endpoint provides recent observations, all observations will be returned descending by observation date starting with the most recent.

closest
within
search
observations/summary

(Beta) The observations/summary endpoint provides access to daily summaries based on received observations.

id
closest
search
affects
places

The places dataset provides the core data for geographical locations, including cities, reporting stations, airports, points of interest (poi), etc. This is typically the first request that is made for every other weather-related request.

id
closest
within
search
places/airports

The places/airports endpoint provides place information on airports, heliports

id
closest
within
search
places/postalcodes

The places/postalcodes endpoint provides information on US zip codes and Canadian Postal Codes.

US 5 digit zip codes and Canadian 6 character postal codes are supported.

id
closest
within
search
records

The records data set provides access to daily US records (RER) as transmitted by the National Weather Service (NWS).

id
closest
within
search
stormcells

The storm cells dataset provides observed and forecast data for all storm cells across the United States. This is a NEXRAD derived product that attempts to identify and track storm cell movement along with reporting cell intensity and certain severe weather signatures within the cell, like rotation and hail. The forecast track can be used to determine when and where a cell will affect a particular location or area.

id
closest
within
search
affects
stormreports

The storm reports data set provides access to all local storm reports (LSR) as transmitted by the National Weather Service (NWS). These reports are received from storm spotters, such as amateur radio operators, storm chasers, law enforcement, emergency management, or citizens about severe weather conditions in their area.

id
closest
within
search
sunmoon

The sunmoon endpoint provides sunrise/set, twilight, moon rise/set and moon phase information for requested locations and time frames.

id
sunmoon/moonphases

The Moonphases endpoint is an extension of the sunmoon endpoint and provides easy access to the moon phase calendar information. Such as the next full, new and quarter moon phases.

id
search
tides

The normals endpoints provides access to the predicted tidal information for US locations.

id
closest
within
search
tides/stations

The tides_stations dataset provides access to the complete station information that tides are available for.

id
closest
within
search
version

Provides the version of the Aeris API