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. |
id 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. |
id closest within search |
| 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 |
| 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 |