[Developers]

Natural Hazards Domain

A magnitude 5.8 earthquake strikes 40 km offshore at 03:47. Within seconds, the Natural Hazards domain detects the USGS feed update, scores the event's significance, issues alerts to populations in the affected zone, cre

Category: Api DomainsLast Updated: Feb 5, 2026
api-domainsaireal-time

Overview#

A magnitude 5.8 earthquake strikes 40 km offshore at 03:47. Within seconds, the Natural Hazards domain detects the USGS feed update, scores the event's significance, issues alerts to populations in the affected zone, creates a dynamic geofence around the impact area, and generates AI-powered prepositioning recommendations for response teams, all before most residents have checked their phones.

Interactive Architecture Topology
13 nodes15 signal paths
Below 4.04.0 to 5.05.0 to 6.5Above 6.5010→1USGS Real-Time Feed021→1Earthquake Detected031→4Magnitude Threshold041→0Store Only041→1Alert Generation041→2Alert + Geofence Creation041→3Critical Alert + MassNotification053→1AI PrepositioningRecommendations052→1Dynamic Geofence051→1Tsunami Warning Check061→0Response Teams061→0Targeted Notifications061→0Elevated Alert Handling
Select any node on the canvas or run Simulate Flow to trace upstream dependencies and downstream signal paths.
Entry points:

Key Features#

  • Real-time USGS earthquake feed integration with automatic polling
  • Tsunami warning detection and elevated alert handling
  • Significance scoring for event prioritisation
  • Community felt report tracking for ground-truth validation
  • Automated alert generation for earthquakes at or above magnitude 4.0
  • Dynamic geofence creation based on earthquake magnitude and location
  • AI-powered resource prepositioning recommendations for aftershock preparedness
  • Mass notification campaigns for significant seismic events
  • Configurable geographic coverage and magnitude thresholds per organisation
  • Magnitude-based action tiers from storage-only through critical alert

Use Cases#

Relevant sectors include critical infrastructure, national emergency management, and public safety agencies.

  • Monitoring seismic activity in real time and automatically alerting affected populations
  • Generating resource prepositioning recommendations for disaster response teams
  • Creating dynamic geofences around earthquake-affected areas for targeted notifications
  • Tracking earthquake history and community felt reports for situational awareness

Integration#

The Natural Hazards domain integrates with Geofence for dynamic hazard zone creation, Notification for mass alerting campaigns, Social Media for synthetic post generation, and Alert for automatic alert creation based on earthquake magnitude thresholds.

Open Standards#

  • FDSN Web Services (fdsnws): The domain queries the USGS earthquake catalogue via the International Federation of Digital Seismograph Networks fdsnws/event/1 standard interface for historical and real-time seismic event retrieval.
  • GeoJSON (RFC 7946): USGS real-time feeds are consumed as GeoJSON FeatureCollections, and all dynamically generated hazard geofences are stored and exchanged in GeoJSON Feature format.
  • WGS 84 (EPSG:4326): All earthquake epicentre and geofence coordinates use the World Geodetic System 1984 datum as latitude/longitude decimal degrees.
  • Modified Mercalli Intensity (MMI) and Community Decimal Intensity (CDI): Shaking-intensity values from the USGS are ingested and stored to support ground-truth validation and significance scoring of seismic events.
  • ISO 8601: All event timestamps, recommendation validity windows, and integration responses serialise datetimes in ISO 8601 format with UTC timezone offsets.
  • OAuth 2.0 and JWT Bearer Token: Token-based authentication protects typed, auditable read and write workflows across the platform.
  • OAuth 2.0 / JWT (RFC 7519): Access to all authenticated workflows is gated by RS256-signed JSON Web Tokens verified against a JWKS endpoint, following OAuth 2.0 bearer token conventions.

Last Reviewed: 2026-02-05 Last Updated: 2026-04-14

Ready to Build?

Get started with our APIs or contact our integration team for support.