Overview
EFAS SOS is a web API for retrieving EFAS forecasts as data. The API returns an xml file. Example api requests can be found on the SOS services's web page. Note that in order to download recent forecasts, EFAS SOS credentials are required. These can be requested from the EFAS project.
Within EFAS, four streamflow forecast products are produced:
Forcing | Type | Ensemble range | procedure |
---|---|---|---|
DWD ICON | deterministic | eud_lisflood | |
COSMO-LEPS | ensemble | 1 - 20 | cos_lisflood |
ECMWF-HRES | deterministic | eud_lisflood | |
ECMWF-ENS | ensemble | 1 - 50 | eue_lisflood |
The European Flood Awareness System(EFAS) Sensor Observation Service(SOS) import function (<importType>EfasSosServer</importType>) imports XML files from the EFAS SOS API.
...
The following is an example of an xml config for the EFAS SOS Import Module Instance
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<?xml version="1.0" encoding="UTF-8"?>
<timeSeriesImportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd">
<import>
<general>
<importTypeStandard>EfasSosServer</importTypeStandard>
<serverUrl>https://efas-sos.efas.eu/sos/?service=SOS&version=2.0.0</serverUrl>
<user>xxxx</user>
<password>xxxxxxxxxx</password>
<idMapId>id_import_efas_sos</idMapId>
</general>
<properties>
<string key="procedure" value="dwd_lisflood"/>
</properties>
<timeSeriesSet>
<moduleInstanceId>import_efas_sos</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q</parameterId>
<locationId>X007318</locationId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="6"/>
<readWriteMode>add originals</readWriteMode>
<ensembleId>dwd_lisflood</ensembleId>
</timeSeriesSet>
</import>
<import>
<general>
<importTypeStandard>EfasSosServer</importTypeStandard>
<serverUrl>https://efas-sos.efas.eu/sos/?service=SOS&version=2.0.0</serverUrl>
<user>efas</user>
<password>akarmi2</password>
<idMapId>id_import_efas_sos</idMapId>
</general>
<properties>
<string key="procedure" value="cos_lisflood"/>
<bool key="ensemble" value="true"/>
</properties>
<timeSeriesSet>
<moduleInstanceId>import_efas_sos</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q</parameterId>
<locationId>X007318</locationId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="6"/>
<readWriteMode>add originals</readWriteMode>
<ensembleId>cos_lisflood</ensembleId>
<ensembleMemberIndexRange start="1" end="20"/>
</timeSeriesSet>
</import>
<import>
<general>
<importTypeStandard>EfasSosServer</importTypeStandard>
<serverUrl>https://efas-sos.efas.eu/sos/?service=SOS&version=2.0.0</serverUrl>
<user>efas</user>
<password>akarmi2</password>
<idMapId>id_import_efas_sos</idMapId>
</general>
<properties>
<string key="procedure" value="eud_lisflood"/>
</properties>
<timeSeriesSet>
<moduleInstanceId>import_efas_sos</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q</parameterId>
<locationId>X007318</locationId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="6"/>
<readWriteMode>add originals</readWriteMode>
<ensembleId>eud_lisflood</ensembleId>
</timeSeriesSet>
</import>
<import>
<general>
<importTypeStandard>EfasSosServer</importTypeStandard>
<serverUrl>https://efas-sos.efas.eu/sos/?service=SOS&version=2.0.0</serverUrl>
<user>efas</user>
<password>akarmi2</password>
<idMapId>id_import_efas_sos</idMapId>
</general>
<properties>
<string key="procedure" value="eue_lisflood"/>
<bool key="ensemble" value="true"/>
</properties>
<timeSeriesSet>
<moduleInstanceId>import_efas_sos</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>Q</parameterId>
<locationId>X007318</locationId>
<timeSeriesType>external forecasting</timeSeriesType>
<timeStep unit="hour" multiplier="6"/>
<readWriteMode>add originals</readWriteMode>
<ensembleId>eue_lisflood</ensembleId>
<ensembleMemberIndexRange start="1" end="50"/>
</timeSeriesSet>
</import>
</timeSeriesImportRun>
|
<?xml version="1.0" encoding="UTF-8"?> <timeSeriesImportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd"> <import> <general> <importType>EfasSosServer</importType> <serverUrl>https://efas-sos.efas.eu/sos/?service=SOS&version=2.0.0&</serverUrl> </general> <properties> <string key="request" value="GetObservation"/> <string key="featureOfInterest" value="ID_1"/> <string key="procedure" value="eud_lisflood"/> </properties> </import> </timeSeriesImportRun> |
---|
Example url for retrieval of ensemble of 50 from api.
https://efas-sos.efas.eu/sos/?service=SOS&version=2.0.0&request=GetObservation&featureOfInterest=ID_1&procedure=eue_lisflood_50&temporalFilter=om:resultTime,2020-08-10T00:00:00Z