ݺߣ

ݺߣShare a Scribd company logo
#Floodhack16 11-12 March 2016
Environment Agency Flood
Monitoring API
Stuart Williams
skw@epimorphics.com
@skwlilac
#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
#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
#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
#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)
#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
#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.

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.