Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

copy/paste general info from: Accessing WMS via web browser & Accessing GloFAS WMS via web browser

examples for EFAS & GloFAS

This page contains detailed documentation on how to access CEMS-Flood WMS via a web browser for EFAS and GloFAS. 

EFAS

Once you have retrieved the access token (if you are an EFAS registered user), copy and paste the url with the access token into the web browser and inspect the getCapabilities:

https://www.efas.eu/api/wms/?token=[YOUR_ACCESS_TOKEN]&request=getcapabilities

If you are not a registered user use the following url

https://www.efas.eu/api/wms/?request=getcapabilities

The browser will display the returned GetCapabilities document in XML Format. Take a moment to look through the available layers.

Code Block
collapsetrue
.....
<Layer queryable="1" opaque="0" cascaded="0">
	<Name>mapserver:RepPoints_High</Name>
	<Title>Reporting Points 5yr RP</Title>
	<Abstract>Reporting Points 5yr RP</Abstract>
	<KeywordList>
		<Keyword>Flood summary layers</Keyword>
	</KeywordList>
	<CRS>EPSG:3035</CRS>
	<CRS>EPSG:4326</CRS>
	<CRS>EPSG:3857</CRS>
	<EX_GeographicBoundingBox>
		<westBoundLongitude>17.6876</westBoundLongitude>
		<eastBoundLongitude>49.7105</eastBoundLongitude>
		<southBoundLatitude>32.5915</southBoundLatitude>
		<northBoundLatitude>49.1261</northBoundLatitude>
	</EX_GeographicBoundingBox>
	<BoundingBox CRS="EPSG:3035" minx="1.7725e+06" miny="4.9925e+06" maxx="2.9325e+06" maxy="7.4625e+06"/>
	<Dimension name="time" default="2019-03-03T00:00:00" units="ISO8601" multipleValues="0" nearestValue="0">2009-12-01T12:00:00/2019-03-03T00:00:00/PT12H</Dimension>
	<Style>
		....
	</Style>
</Layer>
.......

Once you have identified the layer that you want to display, make a GetMap request using the browser. In the following example the GetMap request ask for two layers (the country borders and the Reporting Points 5yr RP for the 01 of January 2019 at 00 UTC:

Copy and paste the following request into the browser and replace the token with your access token

https://www.efas.eu/api/wms/?token=(YOUR_ACCESS_TOKEN)&LAYERS=mapserver:RepPoints_High%2Cmapserver:Countries&TRANSPARENT=true&FORMAT=image%2Fpng
&MAXEXTENT=-4931105.5677773%2C2641663.6973633%2C8570731.1060977%2C12425603.316113
&SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&STYLES=&CRS=EPSG%3A3857
&BBOX=-5009377.085,2817774.6103125,4070118.8815625003,11897270.576875&WIDTH=464&HEIGHT=464&TIME=2019-01-01-00

The result is the following image returned from the WMS server:

Image Added


Changing the TIME parameter of the request will change the returned image with the forecast layers for that time (if available). Valid TIME requests are:
YYYY-MM-DD-HH-MM (i.e. 2019-03-25-12-00)
YYYY-MM-DD-HH (i.e. 2019-03-25-12)
YYYY-MM-DD THH:MM:SSZ (i.e. 2019-03-25 T12:00:00Z)

GloFAS

Copy and paste the WMS url into the web browser and inspect the getCapabilities:

         https://ows.globalfloods.eu/glofas-ows/ows.py?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities 
      

The browser will display the returned GetCapabilities document in XML Format. Take a moment to look through the available layers.

Code Block
collapsetrue
.....
<Layer queryable="1" opaque="0" cascaded="0">
	<Name>FloodHazard100y</Name>
	<Title>Flood hazard 100 year</Title>
	<Abstract>
		Inundated areas for flood events with a return period of 100 years, based on GloFAS climatology. Permanent water bodies derived from the Global Lakes and Wetlands Database and from 
        the Natural Earth lakes map (naturalearthdata.com).
	</Abstract>
	<CRS>EPSG:4326</CRS>
	<EX_GeographicBoundingBox>
		<westBoundLongitude>-180</westBoundLongitude>
		<eastBoundLongitude>180</eastBoundLongitude>
		<southBoundLatitude>-54.0083</southBoundLatitude>
		<northBoundLatitude>83.225</northBoundLatitude>
	</EX_GeographicBoundingBox>
	<BoundingBox CRS="EPSG:3857" minx="-2.00375e+07" miny="-7.17173e+06" maxx="2.00375e+07" maxy="1.80308e+07"/>
	<BoundingBox CRS="EPSG:900913" minx="-2.00375e+07" miny="-7.17173e+06" maxx="2.00375e+07" maxy="1.80308e+07"/>
	<BoundingBox CRS="EPSG:4326" minx="-54.0083" miny="-180" maxx="83.225" maxy="180"/>
	<BoundingBox CRS="EPSG:66666" minx="-1.09906e+07" miny="-1.25247e+07" maxx="1.26887e+07" maxy="1.17495e+07"/>
	<Style>
		<Name>default</Name>
		<Title>default</Title>
		<LegendURL width="422" height="625">
		<Format>image/png</Format>
		<OnlineResource xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://globalfloods-ows.ecmwf.int/glofas-ows/?version=1.3.0&service=WMS
          &request=GetLegendGraphic&sld_version=1.1.0&layer=FloodHazard100y&format=image/png&STYLE=default"/>
		</LegendURL>
	</Style>
</Layer>
.......

Once you have identified the layer that you want to display, make a GetMap request using the browser. In the following example the GetMap request ask for the Accumulated Precipitation layer for the following date: 2018-04-18T00:00:00:

Copy and paste the following request into the browser

 https://ows.globalfloods.eu/glofas-ows/ows.py?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&TIME=2018-04-18T00:00:00
&BBOX=23.07970000000000255,-44.29690000000000083,73.77580000000000382,76.99219999999999686
&CRS=EPSG:4326&WIDTH=1439&HEIGHT=602&LAYERS=AccRainEGE
&STYLES=&FORMAT=image/png&DPI=96&MAP_RESOLUTION=96&FORMAT_OPTIONS=dpi:96&TRANSPARENT=TRUE

The result is the following image returned from the WMS server:

Image Added


Changing the TIME parameter of the request will change the returned image with the forecast layers for that time (if available).