The document describes the Environment Agency Flood Monitoring API, which provides access via a URI and JSON-based API to flood area reference data, flood alerts and warnings updated every 15 minutes, 3-day flood risk forecasts, monitoring station reference data, measure reference data, and readings updated every 15 minutes. The API data is available under an Open Government License and is not intended for safety critical applications. Examples are given of how to access specific types of data via the API.
1 of 7
Download to read offline
More Related Content
Environment agency flood monitoring api
1. #Floodhack16 11-12 March 2016
Environment Agency Flood
Monitoring API
Stuart Williams
skw@epimorphics.com
@skwlilac
2. #Floodhack16 11-12 March 2016
What is it?
? Launched March 2015
? URI and JSON based API giving access to:
C Flood Area reference data
C Flood Alerts and Warnings (15 min updates)
C 3 day Flood Risk forecast
C Monitoring Station reference data
C Measure reference data
C Readings (15 min update)
? CSV archive of readings data
C Currently back to 2014-01-15
? Open Govt License v3 C freely reusable data with due attribution
? Not to be used for Safety Critical Applications
C Fed from same source but less demanding SLA
3. #Floodhack16 11-12 March 2016
So what does that look like?
{base}=http://environment.data.gov.uk/flood-monitoring/
? Flood Areas
C {base}/id/floodAreas?_limit=10
C {base}/id/floodAreas/053FWFPUWI06
C {base}/id/floodAreas?search=Leeds
? Area Geometries
C {base}/id/floodAreas/053FWFPUWI06/polygon
? Flood Warnings and Alerts
C {base}/id/floods
C {base}/id/floods?county=Yorkshire
? 3 Day Forecasts
C {base}/id/3dayforecast
C {base}/id/3dayforecast/image/1
4. #Floodhack16 11-12 March 2016
So what does that look like?
{base}=http://environment.data.gov.uk/flood-monitoring/
? Stations
C {base}/id/stations/1029TH
C {base}/id/stations?town=Leeds
? Measures
C {base}/id/measures/1029TH-level-downstage-i-15_min-mASD
(dont panic C station data list measures at station)
C {base}/id/measures?parameter=level&qualifier=Downstream Stage&_limit=50
C {base}/id/measures?stationReference=1029TH&_limit=100
? Readings
C {base}/data/readings?latest .see note on crawling
C {base}/data/readings
C {base}/id/measures/{id}/readings
C {base}/id/stations/{id}/readings
C Various filters inc date/date range
5. #Floodhack16 11-12 March 2016
Result Formats
? Just follow the links for
.json (by default)
? But also:
C .csv
C .ttl and .rdf (RDF)
C .html (stations,
measures)
6. #Floodhack16 11-12 March 2016
Reading Archives
http://environment.data.gov.uk/flood-monitoring/archive
4 weeks of queryable
readings in linked-data store
Daily .csv archives currently
since 15th Jan 2015
7. #Floodhack16 11-12 March 2016
Wrap-up
? API Reference:
C http://environment.data.gov.uk/flood-monitoring/doc/reference
? Here to help over the weekend
? Happy to receive feedback:
? skw@epimorphics.com
? data.info@environment-agency.gov.uk (goes to Environment Agency, not me)
? Acknowledgements
C This is all the work of my colleague, Dave Reynolds.