aio-georss-gdacs

What it is and what it does

aio-georss-gdacs is an async Python client for consuming real-time disaster and emergency event feeds from GDACS. It wraps aio-georss-client to parse structured disaster data including earthquakes, floods, cyclones, tsunamis, droughts, volcanoes, and wildfires, returning typed feed entries with geographic coordinates, severity levels, and event metadata.

You instantiate a GdacsFeed or GdacsFeedManager with home coordinates, then call update() to retrieve events filtered by radius and category. The library returns a status code (OK, OK_NO_DATA, or ERROR) and a list of entries; each entry contains coordinates, alert level, event type, population exposure, duration, and other incident details. A feed manager tracks changes across updates, reporting new, updated, and removed entries.

Use it for:

• Home automation systems monitoring nearby disasters to trigger alerts or adjust settings based on emergency severity.
• Emergency response dashboards displaying real-time disaster events within a geographic radius of interest.
• Environmental monitoring applications tracking specific disaster types in target regions.
• Integration with notification systems to alert users when high-severity events occur near specified coordinates.

Worth the install?

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

Provides async access to Global Disaster Alert and Coordination System (GDACS) feeds, parsing disaster events with geographic filtering and status tracking.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It fills a specific niche for async GDACS feed consumption. Install it if you need to monitor disaster events with geographic filtering; skip it if you don't need real-time emergency data.

Install

aio-georss-gdacs on PyPI

pip install aio-georss-gdacs

uv add aio-georss-gdacs

poetry add aio-georss-gdacs

Installing aio-georss-gdacs

Before you install

Low install friction with only two runtime dependencies. Active maintenance with a recent release (53 days old) and commits through July 2026.

License in practice

Licensed under Apache-2.0, a permissive license that allows commercial use and modification with minimal restrictions.

Quickstart

from aio_georss_gdacs import GdacsFeed
import asyncio

async def main():
    feed = GdacsFeed(websession, (-33.0, 150.0), filter_radius=500)
    status, entries = await feed.update()
    print(status, entries)

asyncio.run(main())

Requires Python 3.11 or later and an active async session from aio-georss-client's underlying transport.

Verify before relying

• Whether the library handles reconnection or retry logic for failed feed updates automatically.
• Performance characteristics when filtering large numbers of events or querying multiple feed categories.
• Specific aiohttp version requirements or compatibility constraints.

Package facts

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

Keywords: homeassistant, georss, gdacs

Tags

More Internet packages