NAME

WWW::Bund::API::NINA - Adapter for NINA API (disaster warnings)

VERSION

version 0.001

SYNOPSIS

use WWW::Bund;

my $bund = WWW::Bund->new;
my $nina = $bund->nina;

# Get warnings for region by ARS code
my $warnings = $nina->dashboard('091620000000');  # Munich

# Get specific warning details
my $warning = $nina->warning($identifier);
my $geojson = $nina->warning_geojson($identifier);

# Get map data by provider
my $katwarn = $nina->mapdata_katwarn;
my $biwapp = $nina->mapdata_biwapp;
my $mowas = $nina->mapdata_mowas;
my $dwd = $nina->mapdata_dwd;

# Metadata
my $version = $nina->version;
my $event_codes = $nina->event_codes;

DESCRIPTION

Type-safe adapter for the NINA (Notfall-Informations- und Nachrichten-App) API. Provides access to disaster warnings, civil protection alerts, and emergency information for Germany.

NINA aggregates warnings from multiple providers: KATWARN, BIWAPP, MOWAS (BBK), DWD (weather warnings), LHP (flood warnings), and police.

client

WWW::Bund client instance. Required. Weak reference.

dashboard

my $warnings = $nina->dashboard($ars_code);

Get all active warnings for a region by ARS (Amtlicher Regionalschlüssel) code. Returns ArrayRef of warning objects.

Example: 091620000000 for Munich.

warning

my $warning = $nina->warning($identifier);

Get detailed information for a specific warning by identifier. Returns HashRef with warning details, affected areas, instructions, etc.

warning_geojson

my $geojson = $nina->warning_geojson($identifier);

Get GeoJSON representation of warning area for mapping.

mapdata_katwarn

Get KATWARN map data for all active warnings.

mapdata_biwapp

Get BIWAPP map data for all active warnings.

mapdata_mowas

Get MOWAS (BBK/Federal Office of Civil Protection) map data.

mapdata_dwd

Get DWD (German Weather Service) warnings map data.

mapdata_lhp

Get LHP (flood warnings) map data.

mapdata_police

Get police warnings map data.

version

Get API version information.

logos

Get logos/icons for warning providers.

event_codes

Get list of event type codes and descriptions.

notfalltipps

Get emergency tips and guidelines (Notfalltipps).

faqs

Get frequently asked questions about NINA.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-www-bund/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.