`GET /v1/events`: earthquakes, US volcano alerts and satellite fire cells as GeoJSON, with each feed's freshness.
Reported Earth events for display as one GeoJSON FeatureCollection: earthquakes (USGS, magnitude 2.5 and above, past 24 hours), elevated volcano alerts (USGS Hazard Notification System; US-monitored volcanoes only) and satellite-detected fire-heat cells (NASA FIRMS VIIRS, 0.5 degree cells; not confirmed fires). Every feature carries kind. Each requested feed reports its own freshness (ok, stale or unknown); a stale feed still returns its features. Reported events for display, not a warning service and not safety-critical. One Standard unit per request; a browser (maps) key may call it.
Request
- Base URL: https://api.mapmap.ai
- URL: https://api.mapmap.ai/v1/events
- Auth: one of:
- HTTP bearer
- API key in query parameter api_key
Query parameters
Comma list of quake, volcano, fire. Default all three. Anything else is 400 invalid-types
west,south,east,north in WGS84 degrees, west < east, south < north. A box across the antimeridian is 400 invalid-bbox. Default: the whole world
Quakes only. 2.5 to 9.0, default 2.5. Otherwise 400 invalid-magnitude
Features returned, 1 to 5000, default 2000. Newest quakes first, then volcano alerts, then fire cells by count; truncated is true when cut. Otherwise 400 invalid-limit
Response
GeoJSON FeatureCollection with per-feed freshness and the honesty text
Changes
No recorded changes to this operation across all 1 revision of this API.