---
id: aio-geojson-geonetnz-volcano
version: "2026.6.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aio-geojson-geonetnz-volcano — An async GeoJSON client library for GeoNet NZ Volcanic Alert Level feed.

License: permissive · Maintenance: active · Downloads: 73.9K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

geojson async client, geonet nz volcano alerts, volcanic alert level feed, geolocation distance filtering, home assistant geojson, aiohttp geojson wrapper, async feed manager, geojson, geonet-nz, async-client

[View on SkillFed](https://skillfed.io/packages/aio-geojson-geonetnz-volcano) · [View on PyPI](https://pypi.org/project/aio-geojson-geonetnz-volcano/)