Documentation
Version 2.1 Documentation
Version 2.1 should be considered deprecated, but will remain available for the time being.
Fields
Events
The Event object is returned within the Events API.
Name | Description |
---|---|
id | Unique id for this event. |
title | The title of the event. |
description | Optional longer description of the event. Most likely only a sentence or two. |
link | The full link to the API endpoint for this specific event. |
categories | One or more categories assigned to the event. |
sources | One or more sources that refer to more information about the event. |
geometries | One or more event geometries are the pairing of a specific date/time with a location. The date/time will most likely be 00:00Z unless the source provided a particular time. The geometry will be a GeoJSON object of either type "Point" or "Polygon." |
closed | An event is deemed “closed” when it has ended. The closed field will include a date/time when the event has ended. Depending upon the nature of the event, the closed value may or may not accurately represent the absolute ending of the event. |
Categories
Categories are the types of events by which individual events are cataloged. Categories can be used to filter the output of the Categories API and the Layers API. The acceptable categories can be accessed via the categories JSON.
Name | Description |
---|---|
id | Unique id for this category (integer). |
title | The title of the category. |
description | Longer description of the category, addressing the scope. Most likely only a sentence or two. |
link | The full link to the API endpoint for this specific category, which is the same as the Categories API endpoint filtered to return only events from this category. |
layers | A service endpoint that points to the Layers API endpoint filtered to return only layers from this category. |
Sources
A Source is a reference to further information about the event. These references are usually the source from which the event was first curated, although there can be multiple sources per event. Source(s) can be used to filter the output of the Events API. The acceptable sources can be accessed via the sources JSON.
Name | Description |
---|---|
id | Unique id for this type. |
title | The title of this source. |
source | The homepage URL for the source. |
link | The full link to the API endpoint for this specific source, which is the same as the Events API endpoint only filtered to return only events from this source. |
Layers
A Layer is a reference to a specific web service (e.g., WMS, WMTS) that can be used to produce imagery of a particular NASA data parameter. Layers are mapped to categories within EONET to provide a category-specific list of layers (e.g., the 'Volcanoes' category is mapped to layers that can provide imagery in true color, SO2, aerosols, etc.). Web services come in a variety of flavors, so it is not possible to include all of the necessary metadata here that is required to construct a properly-formulated request (URL). The full list of layers can be accessed via the layers JSON.
Name | Description |
---|---|
name | The name of the layer as specified by the source web service found at serviceUrl. |
serviceUrl | The base URL of the web service. |
serviceTypeId | A string to indicate the type (WMS, WMTS, etc.) and version (1.0.0, 1.3.0, etc.) of the web service found at serviceUrl. |
parameters | Zero or more URL parameters that are pertinent to the construction of a properly-formatted request to the web service found at serviceUrl. |
API
Events
Parameter | Value(s) | Description | Examples |
---|---|---|---|
https://eonet.gsfc.nasa.gov/api/v2.1/events | |||
source | Source ID | Filter the returned events by the Source. Multiple sources can be included in the parameter: comma separated, operates as a boolean OR. |
https://eonet.gsfc.nasa.gov/api/v2.1/events?source=InciWeb https://eonet.gsfc.nasa.gov/api/v2.1/events?source=InciWeb,EO |
status | open | closed | Events that have ended are assigned a closed date and the existence of that date will allow you to filter for only-open or only-closed events. Omitting the status parameter will return only the currently open events. | https://eonet.gsfc.nasa.gov/api/v2.1/events ?status=open |
limit | # | Limits the number of events returned | https://eonet.gsfc.nasa.gov/api/v2.1/events ?limit=5 |
days | # | Limit the number of prior days (including today) from which events will be returned. | https://eonet.gsfc.nasa.gov/api/v2.1/events ?days=20 |
Categories
Parameter | Value(s) | Description | Examples |
---|---|---|---|
https://eonet.gsfc.nasa.gov/api/v2.1/categories | |||
Category ID | Filter the events by the Category. |
https://eonet.gsfc.nasa.gov/api/v2.1/categories/8 https://eonet.gsfc.nasa.gov/api/v2.1/categories/14 |
|
source | Source ID | Filter the topically-constrained events by the Source. Multiple sources can be included in the parameter: comma separated, operates as a boolean OR. |
https://eonet.gsfc.nasa.gov/api/v2.1/categories
/8?source=InciWeb https://eonet.gsfc.nasa.gov/api/v2.1/categories /14?source=InciWeb,EO |
status | open | closed | Events that have ended are assigned a closed date and the existence of that date will allow you to filter for only-open or only-closed events. Omitting the status parameter will return only the currently open events. | https://eonet.gsfc.nasa.gov/api/v2.1/categories /8?status=open |
limit | # | Limits the number of events returned | https://eonet.gsfc.nasa.gov/api/v2.1/categories /8?limit=5 |
days | # | Limit the number of prior days (including today) from which events will be returned. | https://eonet.gsfc.nasa.gov/api/v2.1/categories /8?days=20 |
Layers
Parameter | Value(s) | Description | Examples |
---|---|---|---|
https://eonet.gsfc.nasa.gov/api/v2.1/layers | |||
Category ID | Filter the layers by the Category. |
https://eonet.gsfc.nasa.gov/api/v2.1/layers/8 https://eonet.gsfc.nasa.gov/api/v2.1/layers/14 |