aio-geojson-geonetnz-quakes

What it is and what it does

This is an async Python client library for the GeoNet NZ Quakes feed, built on top of aio_geojson_client and aiohttp. It retrieves earthquake data from the GeoNet API as GeoJSON and exposes it through a simple async interface. You instantiate a feed object with home coordinates and optional filters (radius in km, minimum magnitude, time window, MMI threshold), then call update() to fetch current earthquake data. The library returns a status code and a list of feed entries, each populated with geometry, coordinates, magnitude, depth, locality, MMI shaking estimate, and quality metadata.

The library also provides a Feed Manager that tracks changes across updates: new earthquakes, updates to existing ones, and removals. This is useful for applications that need to react to feed changes over time—such as home automation systems or emergency alerting. The Feed Manager distinguishes between the last update timestamp (regardless of success) and the last successful update timestamp, allowing consumers to handle intermittent API failures gracefully.

Use it for:

• Home automation: trigger alerts or actions when earthquakes above a certain magnitude occur near a monitored location.
• Emergency response systems: monitor seismic activity in real time and notify stakeholders of significant events in New Zealand.
• Geospatial data aggregation: collect and integrate earthquake data with other location-based services or mapping applications.
• Seismic research: fetch historical and current earthquake data for analysis, filtering by magnitude, depth, and time window.
• Public alerting: build a web or mobile app that displays nearby earthquakes with MMI shaking estimates for user locations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides async access to the GeoNet NZ Quakes feed, parsing earthquake data as GeoJSON with filtering by radius, magnitude, and time interval.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It solves a specific, well-defined problem—async access to New Zealand earthquake data with flexible filtering—and is suitable for production use in home automation, emergency systems, or geospatial applications. The Feed Manager pattern makes it practical for long-running services.

Install

aio-geojson-geonetnz-quakes on PyPI

pip install aio-geojson-geonetnz-quakes

uv add aio-geojson-geonetnz-quakes

poetry add aio-geojson-geonetnz-quakes

Installing aio-geojson-geonetnz-quakes

Before you install

Low friction: pure Python wheel with only three runtime dependencies (aio_geojson_client, aiohttp, pytz). Active maintenance since 2019, last commit 2026-07-20, and supports current Python versions (3.11–3.14).

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions, making it safe to integrate into most projects.

Quickstart

pip install aio-geojson-geonetnz-quakes

import asyncio
from aiohttp import ClientSession
from aio_geojson_geonetnz_quakes import GeonetnzQuakesFeed

async def main():
    async with ClientSession() as websession:
        feed = GeonetnzQuakesFeed(websession, (-41.2, 174.7), mmi=2,
                                  filter_radius=200,
                                  filter_minimum_magnitude=2.5)
        status, entries = await feed.update()
        print(status, entries)

asyncio.get_event_loop().run_until_complete(main())

Requires Python 3.11 or later; aiohttp ClientSession must be created and passed to the feed.

Verify before relying

• Whether MMI filtering (Modified Mercalli intensity scale) is available for all regions or only New Zealand.
• Performance characteristics when filtering large result sets by radius or magnitude.
• Whether feed manager state persists across application restarts or requires external storage.

Package facts

Evidence: aio_geojson_geonetnz_quakes-2026.6.0-py3-none-any.whl

Keywords: homeassistant, geojson, new zealand, geonetnz, earthquakes

Tags

More WWW/HTTP packages