aio-geojson-geonetnz-volcano

What it is and what it does

This is an async Python wrapper around GeoNet NZ's Volcanic Alert Level GeoJSON feed. It provides convenient access to real-time volcanic alert data for New Zealand volcanoes, with built-in geographic filtering by distance from home coordinates. The library returns structured feed entries containing volcano geometry, alert levels (0–5), activity descriptions, and hazard information.

The package includes both a simple feed class for one-off updates and a feed manager for tracking changes over time—new entries, updates, and removals compared to the previous fetch. It integrates with aiohttp for async HTTP requests and is designed for use in automation systems like Home Assistant. Status codes distinguish between successful updates, no-data responses, and errors.

Use it for:

• Monitor volcanic alerts in New Zealand and trigger home automation alerts when activity changes within a specified radius
• Build a geographic dashboard showing real-time volcanic alert levels and hazard information for a region
• Track volcano activity changes over time using the feed manager to detect new or updated alerts
• Integrate volcanic hazard data into emergency response or risk assessment applications
• Filter volcano data by distance to focus on volcanoes near a specific location

Worth the install?

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

Async client library for retrieving New Zealand volcanic alert data from GeoNet's GeoJSON feed, with distance filtering and feed management capabilities.

Yes, if you need async access to GeoNet NZ volcanic alert data. The library is actively maintained, has low install friction, carries a permissive license, and no known vulnerabilities. It is purpose-built for this specific feed and integrates cleanly with aiohttp-based applications. Not relevant outside New Zealand volcanic monitoring use cases.

Install

aio-geojson-geonetnz-volcano on PyPI

pip install aio-geojson-geonetnz-volcano

uv add aio-geojson-geonetnz-volcano

poetry add aio-geojson-geonetnz-volcano

Installing aio-geojson-geonetnz-volcano

Before you install

Active maintenance with recent release (46 days old). Low install friction—pure Python wheel with only three runtime dependencies (aiohttp, aio_geojson_client, pytz). Supports current Python versions (3.11–3.14).

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions, typical for open-source libraries.

Quickstart

pip install aio-geojson-geonetnz-volcano

import asyncio
from aiohttp import ClientSession
from aio_geojson_geonetnz_volcano import GeonetnzVolcanoFeed

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

Verify before relying

• Whether the package is actively maintained beyond the latest release date or if development has stalled
• Real-world reliability and error handling behavior when GeoNet API is unavailable or rate-limited

Package facts

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

Keywords: homeassistant, geojson, geonetnz, volcano

Tags

More WWW/HTTP packages