- About
- Data & data product access
- Data Catalogue
- Data Download
- Online QC tool
- Map Viewer
- Atlas of Marine Life
- News & events
- Terms & Conditions
- Get involved!
- Helpdesk
The EMODnet Biology data are available as a Web Feature Service (WFS) in accordance with the Open Geospatial Consortium (OGC) specifications. This webservice supports requests for geographical feature data (with vector geometry and attributes). The base link for performing a WFS request to EMODnet Biology is:
https://geo.vliz.be/geoserver/Dataportal/ows?
Essentially, the Download Toolbox developed by EMODnet Biology acts as an interactive builder for WFS requests . The URL to the WFS request can be copied to the clipboard at the last step of the selection in the Download Toolbox.
Technical details of the WFS can be retrieved by following GetCapabilities request:
https://geo.vliz.be/geoserver/Dataportal/ows?service=wfs&version=1.1.0&request=GetCapabilities
For composing your own query, you need to combine different parts:
The base link for performing a WFS request to EMODnet Biology is:
https://geo.vliz.be/geoserver/Dataportal/ows?service=WFS&version=1.0.0&request=GetFeature&
There are three data formats presented by EMODnet Biology.
The syntax for specifying a data format is:
typeName=Dataportal:<data_format>
Basic Occurrence Data
The Basic Occurrence Data provides you with all data required to perform temporal spatial analysis for the different taxa. It indicates which taxa was found (scientificname
and aphiaid
), when (datecollected
) and where (decimallongitude
and decimallatitude
in WGS84 - EPGS:4326), along with a dataset identifier (datasetid
).
The syntax for requesting this data format is: eurobis-obisenv_basic
For example, the following request will return the first 50 basic occurrence records:
Full Occurrence Data
The Full Occurrence Data provides additional information which may help interpret the basic data. This format offers all the data from the Basic Occurrences plus additiontal information which may help interpret the basic data such as information on the institute collecting the data, the methodology, the exact time and location (and uncertainty),...
The syntax for requesting this data format is: eurobis-obisenv_full
For example, the following request will return the first 50 full occurrence records: https://geo.vliz.be/geoserver/Dataportal/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=Dataportal:eurobis-obisenv_full&maxFeatures=50&outputformat=csv
Full Occurrence Data and Parameters
The Full Occurrence Data and Parameters provides you with all measurement or facts associated to the occurrence or the sample.
The syntax for requesting this data format is: eurobis-obisenv
For example, the following request will return the first 50 full occurrence data and parameter records:
You can find more information about the terms returned by each download type in the documentation.
In this part you can filter the result by several parameters. We highlight three options:
These filter options are linked to other services that you can find at the end of this page.
Taxonomy: World Record of Marine Species (WoRMS)
Concerning taxonomy, EMODnet Biology data are connected to the services provided by the World Record of Marine Species (WoRMS) using the AphiaID. This is provided in the aphiaid
and aphiaidaccepted
columns.
To retrieve a Shapefile with the full occurrence data of the seabird Herring gull (Larus argentatus) using its AphiaID 137138, you can run the following request (this might take a while to complete): https://geo.vliz.be/geoserver/Dataportal/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=Dataportal:eurobis-obisenv_full&&viewParams=where:aphiaidaccepted=137138&outputformat=csv
Geography: Marine Regions
EMODnet Biology allows to query information to standardized areas by using the MRGID provided by MarineRegions.org. This is a unique and persistent identifier for geographic objects. You can select the area of interest using the Download Toolbox and copying the WFS request generated.
For example, the following request returns all occurrences in the Belgian Exclusive Economic Zone (MRGID 3293): (this might take a while)
Currenlty you can subset on EEZ, IHO Sea Area, Marine Ecoregion of the World (MEOW), Marine Region, Territorial Sea.
Dataset (Integrated Marine Information System - IMIS)
Filtering on datasets is possible thanks to the connection to the Integrated Marine Information System (IMIS) described via this link.
This request will return the first 50 basic occurrences from the dataset Monitoring of birds in the Voordelta (datasetid=4569) as a csv file:
Combining filter parameters
Here are some examples of combining filters:
Querying for two or more conditions is also possible as seen below when requesting the occurrences of the seabird Herring gull (Larus argentatus 137138) in the dataset titled Monitoring of birds in the Voordelta (datasetid=4569) as JSON:
The WFS request allows the use of OR
statements. You can retrieve a CSV file with the full occurrence data and parameters of both the White furrow (Alba alba 141433) and the Common razor shells (Ensis ensis 140733):
EMODnet Biology data are available in a number of output formats, which are indicated at the end of the WFS request as:
outputFormat=<output_format>
csv
json
shapefile
kml
In addition to the three data formats, EMODnet Biology also makes available through its webservices the possibility of returning the total occurrences count for a certain query, its occurrence data as a geospatial grid, and the data products developed by the EMODnet Biology community:
Retrieve the count of occurrences: You can retrieve the total number of records available in EMODnet Biology for a certain query using the sentence Dataportal:eurobis-obisenv_count
. The example below will return the number of occurrences in the dataset Monitoring of birds in the Voordelta (datasetid=4569):
Retrieve a geospatial grid, summarising the number of eurobis occurrences: EMODnet Biology also offers occurrences summarised as the number of occurrences in a geospatial grid. There are four grid size levels available, plus the possibility of retrieving each point directly. To query any of these five options, the correct table must be specified in the request:
&typeName=Dataportal:eurobis_grid_1d-obisenv
&typeName=Dataportal:eurobis_grid_30m-obisenv
&typeName=Dataportal:eurobis_grid_15m-obisenv
&typeName=Dataportal:eurobis_grid_6m-obisenv
&typeName=Dataportal:eurobis_points-obisenv
For example, this WFS request will return a geospatial grid, summarizing the number of eurobis occurrences of the seabird Herring gull (Larus argentatus 137138) with a resolution of 30 minutes as KML:
Retrieving data products: EMODnet Biology develops data products that are accessible through WFS services. For example, the following requests return the OOPS Copepod gridded abundances in 1 and 10 years bin respectively:
EMODnet Biology follows the FAIR principles. The data formats available via EMODnet Biology allow for enhanced interoperability by providing links to controlled vocabularies, like the World Record of Marine Species (WoRMS), MarineRegions.org and the British Oceanographic Data Centre (BODC). It also has links to the Integrated Marine Information System (IMIS), a system developed by the Flanders Marine Institute (VLIZ) where information about people, organisations, publications and more is stored and managed. You can find more information about the webservices offered by each of these data systems in their documentation pages:
EMODnet Biology data are accessible via an R package eurobis
, which provides webservice wrapper. You can find more information on the GitHub repository:
Some data applications using EMODnet Biology data has been written in R using the shiny framework: These are available at: