Cyprus Water

Welcome to Cyprus Water, an open repository of data and functionality on water reservoirs in Cyprus.

Water level across all reservoirs in Cyprus

Your browser does not support the HTML5 canvas tag.

Size bars according to dam capacity

Showing data for 01/01/2019

Water level in main reservoirs in Cyprus

Frequently Asked Questions (FAQ)

What is this website?

This is an open repository of information and functionality related to Cyprus' water reservoirs and their storage. You can learn about dams in Cyprus and their storage presently, and in the past.

Where do you get the data from?

From the website of the Water Development Department.

Can I create an app that uses this data?

Yes. You can use the API described below. If you do this, we expect you to make fair use of the resource which is provided for free and without any guarantee. We would also appreciate but not require an acknowledgement/attribution.

How do I acknowledge this project, its data and its services?

Use the following text

Use of cyprus-water data and functionality is licensed under CC BY 2.0

which you could produce with this sample HTML code

Application Programming Interface (API)

/api/dams

Queries static information about the main water reservoirs (dams) in Cyprus. The reply is encoded in JSON.

Returns an array of Dams
https://cyprus-water.appspot.com/api/dams

/api/date-statistics

Queries the statistics of water reservoirs on a specific date. The query uses the format yyyy-MM-dd (e.g. "?date=2018-06-21" to query the statistics for June 21st, 2018, or if no data exist for this date, then the latest date before the specified one). If no date parameter is specified, the server implies the current date. The reply is encoded in JSON.

Returns an instance of DayStatistics
https://cyprus-water.appspot.com/api/date-statistics?date=2018-06-21

/api/percentages

Queries the storage percentages of the main water reservoirs on a specific date. The query uses the format yyyy-MM-dd (e.g. "?date=2018-06-21" to query the percentages for June 21st, 2018, or if no data exist for this date, then the latest date before the specified one). If no date parameter is specified, the server implies the current date. The reply is encoded in JSON.

Returns an instance of DamsPercentage
https://cyprus-water.appspot.com/api/percentages?date=2018-06-21

/api/monthly-inflows

Queries the historical monthly inflows throughout time. The reply is ordered chronologically with older entries first, and is encoded in JSON.

Returns an array of MonthlyInflows
https://cyprus-water.appspot.com/api/monthly-inflows

/api/events

Queries the stored events throughout time. The query uses the format yyyy-MM-dd (e.g. "?from=2019-12-21" to query the events since December 21st, 2019. If no 'from' or 'to' parameter is specified, the server returns all stored events. The reply is encoded in JSON.

Returns an array of Events
https://cyprus-water.appspot.com/api/events?from=2019-12-21

/api/timeseries

Queries the timeseries of the water level through time. The query returns a Timeseries object containing basic info of the dams, plus an ordered array of dates to percentages. The reply is encoded in JSON.

Returns an instance of Timeseries
https://cyprus-water.appspot.com/api/timeseries

The following are Admin-only API calls which you cannot access (and you shouldn't need to).

/sync/grab

Triggers a grab from the source website (requires authentication and admin rights which you most likely don't have). Returns a message encoded in JSON.

The reply is an instance of Message
https://cyprus-water.appspot.com/sync/grab

Graphs

/graphs/timeseries

Timeseries graph, showing the water level across the main reservoirs over time.

https://cyprus-water.appspot.com/graphs/timeseries

/graphs/shares

Timeseries graph, showing the share of each dam compared to the overall water reserves, over time.

https://cyprus-water.appspot.com/graphs/shares

About

Developed by Computing at UCLan Cyprus. For details please contact Dr Nearchos Paspallis.

UCLan Cyprus
Inspire Research Center