NAME

WWW::Bund::API::PegelOnline - Adapter for Pegel-Online API (water levels)

VERSION

version 0.001

SYNOPSIS

use WWW::Bund;

my $bund = WWW::Bund->new;
my $pegel = $bund->pegel_online;

# List all gauging stations
my $stations = $pegel->stations;

# Get specific station details
my $station = $pegel->station($uuid);

# List all waters (rivers, lakes)
my $waters = $pegel->waters;

# Get timeseries metadata
my $ts = $pegel->timeseries($station_uuid, $timeseries_uuid);

# Get actual measurements
my $measurements = $pegel->measurements($station_uuid, $timeseries_uuid);

DESCRIPTION

Type-safe adapter for the Pegel-Online API, providing access to water level gauges and measurements for German rivers and waterways.

client

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

stations

my $stations = $pegel->stations;

List all gauging stations. Returns ArrayRef of station objects with UUID, name, water, coordinates, etc.

station

my $station = $pegel->station($uuid);

Get detailed information for a specific station by UUID.

waters

my $waters = $pegel->waters;

List all waters (rivers, lakes). Returns ArrayRef of water objects.

timeseries

my $ts = $pegel->timeseries($station_uuid, $timeseries_uuid);

Get metadata for a specific timeseries (measurement type) at a station.

measurements

my $measurements = $pegel->measurements($station_uuid, $timeseries_uuid);

Get actual water level measurements for a timeseries. Returns ArrayRef of measurement objects with timestamps and values.

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.