Japan Fetcher

Fetcher for Japanese river gauge data.

class rivretrieve.japan.JapanFetcher

Bases: RiverDataFetcher

Fetches river gauge data from Japan’s Ministry of Land, Infrastructure, Transport and Tourism (MLIT).

Data Source: Water Information System (http://www1.river.go.jp/)

Note: KINDs 2 and 6, described as “Daily” on the website, actually provide HOURLY data. KINDs 3 and 7 are expected to provide true DAILY data. This fetcher returns data at the resolution provided in the source .dat files.

Supported Variables:

• 'discharge_hourly_mean' (m³/s)

• 'stage_hourly_mean' (m)

• 'discharge_daily_mean' (m³/s)

• 'stage_daily_mean' (m)

static get_available_variables() → tuple[str, ...]

Returns a tuple of supported variables.

static get_cached_metadata() → DataFrame

Retrieves a DataFrame of available Japanese gauge IDs and metadata.

get_data(gauge_id: str, variable: str, start_date: str | None = None, end_date: str | None = None) → DataFrame

Fetches and parses time series data for a specific gauge and variable.

get_metadata() → DataFrame

Fetches metadata from MLIT Water Information System.