[REQUEST] Add Taiwan

[thiagovmdon]

Data source
Taiwan Water Resources Agency (WRA), Ministry of Economic Affairs.

Relevant pages:

• WRA OpenAPI / Swagger: https://opendata.wra.gov.tw/openapi/swagger/index.html
• WRA metadata endpoint used for river-flow station metadata:
  https://opendata.wra.gov.tw/api/v2/9332bd66-0213-4380-a5d5-a43e7be49255
• WRA HydroInfo public website:
  https://gweb.wra.gov.tw/HydroInfo/
• Historical river discharge page:
  https://gweb.wra.gov.tw/HydroInfo/WCore?Corefunc=DI
• Historical river stage page:
  https://gweb.wra.gov.tw/HydroInfo/WCore?Corefunc=LE

Terms of use / license:

• The official WRA open-data pages are published under the Open Government Data License, version 1.0:
  https://data.gov.tw/en/license
• WRA also has a website open-data declaration:
  https://web.wra.gov.tw/welfare/cp.aspx?n=8933

Practical note:

• Station metadata comes from the official WRA OpenAPI.
• Historical discharge and water-level values come from public HydroInfo JSON endpoints used by the WRA website.
• I did not find a separate dedicated license page for each HydroInfo JSON endpoint, but the data is publicly accessible from the WRA site and appears usable with attribution.

Type of data portal
This is a mixed portal:

• Official documented OpenAPI for station metadata.
• Public website with JSON backend endpoints for historical time series.
• Data is both browsable in the website and accessible programmatically.
• No registration was required in my tests.

Metadata:

• Yes, documented API access via WRA OpenAPI.

Historical time series:

• Yes, public JSON endpoints exist, but they do not appear to be part of the official Swagger documentation.
• The website uses these endpoints internally.

Country/Countries/Regions

• Taiwan

Variables
The following variables are available from the HydroInfo endpoints that I checked:

• Daily discharge
• Hourly discharge
• Daily river stage / water level
• Hourly river stage / water level

In RivRetrieve terms:

• DISCHARGE_DAILY_MEAN
• DISCHARGE_HOURLY_MEAN
• STAGE_DAILY_MEAN
• STAGE_HOURLY_MEAN

Important detail:

• The HydroInfo water-level values appear to be absolute elevations.
• A zero-point elevation is available in the metadata and can be used to convert these values into stage in meters relative to gauge zero.

Station list
Yes, a station list is available from the official WRA OpenAPI metadata endpoint.

Endpoint:

• https://opendata.wra.gov.tw/api/v2/9332bd66-0213-4380-a5d5-a43e7be49255?format=JSON&page=1&size=1000

This metadata includes fields such as:

• station id
• station name
• river
• coordinates (TWD97 XY, convertible to lat/lon)
• watershed area
• zero-point elevation

In my implementation, I converted the TWD97 coordinates to latitude/longitude and prepared a CSV station list. As of March 27, 2026, the metadata endpoint returned 188 station records.

Known stations with live historical discharge values:

• 1140H099 思源橋, 北勢溪
• 1140H058 五堵, 基隆河
• 1140H066 秀朗, 新店溪
• 1300H016 竹林大橋, 頭前溪
• 1420H037 白鹿橋, 大甲溪
• 1430H025 大肚橋, 烏溪

Code snippets
Implemented in the branch taiwan