Reference · built on requestCommons signalEarth, seismic & volcanic

GeoNet

New Zealand earthquakes, shaking intensity, strong motion, and volcanic alert levels from the GeoNet API.

Request accessPricing ↗

About

GeoNet is New Zealand's geological hazard monitoring programme, sponsored by the Natural Hazards Commission Toka Tū Ake, Earth Sciences New Zealand, Toitū Te Whenua Land Information New Zealand, NEMA, and MBIE. It monitors earthquakes, volcanoes, tsunamis, and landslides. The API at api.geonet.org.nz serves recent quakes, felt and measured intensity, processed strong-motion records, volcanic alert levels, and network sensor metadata as GeoJSON, JSON, and CAP 1.2.

Through Fibric, an operator reads quakes above a shaking threshold near your properties and proposes inspections, lift checks, or guest notices for you to approve.

This is a reference listing. It documents what Fibric would read from GeoNet and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Recent earthquakes from GET /quake, filtered by the MMI parameter, with publicID, time, depth, magnitude, mmi, locality, and quality
  • One event and its revision history from GET /quake/(publicID) and GET /quake/history/(publicID)
  • Reported or measured shaking from GET /intensity, aggregated by max or median, plus GET /intensity/strong/processed/(publicID)
  • Volcanic Alert Levels for each monitored volcano from GET /volcano/val, with level, acc, activity, and hazards properties
  • Earthquakes near a volcano from GET /volcano/quake/(volcanoID)
  • CAP 1.2 alerts and an Atom feed from /cap/1.2/GPA1.0/quake/(ID) and /cap/1.2/GPA1.0/feed/atom1.0/quake
  • Station and sensor inventory from GET /network/station, /network/sensors, and /network/sensor/type

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Check lifts after strong shaking

    When a quake with MMI at or above your threshold lands near a building, the operator proposes a lift inspection and attaches the GeoNet publicID and locality.

    With Elevator Fault

  • Schedule a post-event building inspection

    The operator drafts an inspection request for each property inside the felt area, ranked by reported intensity, and holds it for your approval.

    With Inspection Scheduling

  • Answer guests during volcanic unrest

    When a Volcanic Alert Level changes for a volcano near a hotel, the operator proposes a guest notice quoting the level and activity text from GET /volcano/val.

    With Guest Requests

Requirements

  • An Accept header per endpoint; without one the API routes to the highest version, which can change under you
  • Property locations in New Zealand to match against quake coordinates and locality text
  • An MMI threshold per site, since GET /quake filters on shaking intensity rather than magnitude
  • Acceptance of the GeoNet data policy and disclaimer before use
Authentication
No key or account. The API is open over HTTPS; you pick an API version with an Accept header such as application/vnd.geo+json;version=2.

Limits

  • GeoNet documents no update interval for the API; quake records carry a quality value and are revised after review
  • The CAP endpoints are not versioned by Accept header, unlike the GeoJSON and JSON endpoints
  • The sponsors accept no liability for absent or erroneous data; do not treat the feed as a life-safety system
  • Coverage is New Zealand only; events elsewhere need another catalogue

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request GeoNet ↗

Questions and answers

How do you choose an API version on api.geonet.org.nz?
Send an Accept header. GeoJSON endpoints use application/vnd.geo+json;version=2 and JSON endpoints use application/json;version=2. With no Accept header the API routes to its highest version. The CAP endpoints are not versioned this way.
What does the MMI parameter on GET /quake do?
It filters returned quakes by MMI, an integer from -1 to 8, so you read shaking felt at the surface rather than magnitude alone. Each feature also carries mmi, magnitude, depth, locality, and a quality value.
What licence and attribution apply?
GeoNet content is copyright Earth Sciences New Zealand and licensed under Creative Commons Attribution 3.0 New Zealand. GeoNet asks you to acknowledge the New Zealand GeoNet programme and its sponsors NHC, Earth Sciences NZ, LINZ, NEMA, and MBIE.
Ask about GeoNet

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by GeoNet, Earth Sciences New Zealand (api.geonet.org.nz). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy