Custom Connector
NASA EONET Connector
Global
The NASA EONET Connector provides access to the NASA Earth Observatory Natural Event Tracker (EONET) REST API. It delivers curated information about natural events such as storms, wildfires, floods, and volcanic activity, allowing developers to retrieve event metadata, categories, and sources — ideal for disaster monitoring systems, research dashboards, and geospatial visualization tools.
Overview
Integration Overview
The NASA EONET Connector exposes the following endpoints:
- List events. Retrieve current or past natural events with optional filters for category, source, and status.
- Get event by ID. Fetch detailed metadata for a specific natural event.
- List categories. Retrieve available categories of natural events (e.g. wildfires, storms).
- List layers. Get information about map layers linked to natural event visualizations.
- List sources. Retrieve metadata on organizations that provide event data.
Documentation
Detailed Integration Documentation
List Events
| Operation ID | listEvents |
|---|---|
| Endpoint | /events |
| Parameters | category (string, optional) – filter by event category (e.g. wildfire). source (string, optional) – filter by data source. status (string, optional: open, closed) – filter by event status. limit (integer, optional) – limit number of results. |
| Purpose | Retrieves a list of natural events with optional filters. |
| Output | JSON with event IDs, titles, categories, geometries, and sources. |
| Workflow example | Populate a dashboard showing ongoing natural disasters worldwide. |
Get Event by ID
| Operation ID | getEventById |
|---|---|
| Endpoint | /events/{id} |
| Parameters | id (path, string, required) – the unique identifier of the event. |
| Purpose | Retrieve detailed metadata for a specific event, including geometry, date, and source. |
| Output | JSON object describing the event in detail. |
| Workflow example | Clicking on an event in a map loads its details from this endpoint. |
List Categories
| Operation ID | listCategories |
|---|---|
| Endpoint | /categories |
| Parameters | None. |
| Purpose | Returns all available natural event categories. |
| Output | JSON with category IDs and titles (e.g. “Wildfires”, “Severe Storms”). |
| Workflow example | Allows filtering events by type in an app. |
List Layers
| Operation ID | listLayers |
|---|---|
| Endpoint | /layers |
| Parameters | None. |
| Purpose | Retrieves metadata about geospatial map layers related to events. |
| Output | JSON describing layers with type and attribution. |
| Workflow example | Use with GIS software to overlay natural event data on maps. |
List Sources
| Operation ID | listSources |
|---|---|
| Endpoint | /sources |
| Parameters | None. |
| Purpose | Retrieves metadata about data providers and their capabilities. |
| Output | JSON list of source IDs, titles, and URLs. |
| Workflow example | Display source organizations in a dashboard to provide attribution. |
Example Workflow: Natural Disaster Monitoring Dashboard
| Step 1 | Fetch categories → /categories. |
|---|---|
| Step 2 | Select “Wildfires” → call /events?category=wildfires&status=open. |
| Step 3 | Display events on a map → plot event geometries. |
| Step 4 | User clicks an event → call /events/{id} for details. |
| Step 5 | Display related source attribution → /sources. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.