Skip to content

Commit

Permalink
Update web-service-description.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@cyrielledelvenne
cyrielledelvenne authored Sep 8, 2023
1 parent 2eb87be commit c8a11ad
Showing 1 changed file with 50 additions and 0 deletions.
50 changes: 50 additions & 0 deletions docs/web-service-description.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -19,27 +19,41 @@ nav_order: 3
{:toc}
</details>


The web services are the **tools** used to **process** the data. The web services can also be used in a concatenated way, where the output of the first web service is the input for the next web service. This is demonstrated in the use cases.


![Screenshot (17)](https://github.com/lifewatch/elab-documentation/assets/144227108/47a3215d-96e2-4590-89c8-742bcabade75)


## Data validation and QC services 🌍



| Service | Explanation |
|:-------------|:------------------|
| **Data format validation** | The LifeWatch portal uses a specific standard data format based on Darwin Core and the OBIS Schema (see above). This service checks if the uploaded data file matches this standard LifeWatch data format.|
| **Show on map** | This service generates a map based on Latitude and Longitude in the uploaded data file. The resulting map is available in the result report. |
| **Check OBIS file** | This service checks if the uploaded data file matches the OBIS Schema (mandatory and missing fields), checks the format of the date and coordinates and checks if the observation points are located at sea or on land. This service also performs a WoRMS taxon match. |



## EMODnet Biology 🐾



| Service | Explanation |
|:-------------|:------------------|
| **Number of observations in a 1000m radius around a point** | Returns the number of observations in the Ocean Biodiversity Information System (OBIS) of taxon in a radius of 1000 meter around a point, based on Latitude and Longitude in the uploaded data file.|



## ​​Geographical services - Administrative boundaries 🗺️


These web services return the name and code of administrative boundaries, such as EMODnet regions, Exclusive Economic Zones (EEZ), ICES Ecoregions, IHO Sea Areas, Intersect of the EEZ and IHO (Marine Regions), World Countries, and FAO Fishing Areas, based on Latitude and Longitude in the uploaded data file.​​


| Service | Explanation |
|:-------------|:------------------|
| **Exclusive Economic Zone** ||
Expand All @@ -49,16 +63,22 @@ These web services return the name and code of administrative boundaries, such a
| **Intersect of the EEZ and IHO** | |
| **World countries** | Returns the country based on latitude and longitude |



## Geographical services - Bathymetry 📐


| Service | Explanation |
|:-------------|:------------------|
| **Bathymetry Southern Bight of the North Sea** |Returns the bathymetry for points in the Southern Bight of the North Sea (from the "Limited Atlas of the Belgian Part of the North Sea"), based on Latitude and Longitude in the uploaded data file.|
| **​​GEBCO bathymetry** | Returns the bathymetry from the General Bathymetric Chart of the Oceans (GEBCO), based on Latitude and Longitude in the uploaded data file. |
| **MARSPEC: global marine bathymetrie (Resolution: 30 arc seconds)s** | Returns the global marine bathymetry with a resolution of 30 arc seconds from the Ocean Climate Layers for Marine Spatial Ecology (MARSPEC), based on Latitude and Longitude in the uploaded data file |



## Geographical services - Biogeographical classification 🗾


| Service |
|:-------------|
| **Large Marine Ecosystems of the World** |
Expand All @@ -68,8 +88,11 @@ These web services return the name and code of administrative boundaries, such a
| **Marine Realms of the World** |
| **World countries** |



## Geographical services - Environmental data 🌡️


| Service |
|:-------------|
| **Calcite (mean) [mol/m<sup>3</sup>]** |
Expand All @@ -96,45 +119,63 @@ These web services return the name and code of administrative boundaries, such a
| **Sea surface temperature (range) [Celsius]** |
| **Silicate [µmol/l]** |



## Geographical services - Features 🐟


| Service | Explanation |
|:-------------|:------------------|
| **Shoals (Belgian Continental Shelf)** |Indicates if a given location in the Belgian Continental Shelf is situated on a shoal, based on Latitude and Longitude in the uploaded data file, and gives the name and group of the shoal.|



## Geographical services - Protected areas 🍀


| Service | Explanation |
|:-------------|:------------------|
| **Flemish Ecological Network** |Indicates if a given location is situated within the Flemish Ecological Network, based on Latitude and Longitude in the uploaded data file, and gives the type and name of the VEN-area. The Flemish Ecological Network (VEN) is a selection of valuable and sensitive natural areas in Flanders. The Flemish government gives priority to nature conservation and nature development in these areas.|



## Geographical services - Total biological valuation 🌿


| Service | Explanation |
|:-------------|:------------------|
| **Terrestrial Biological Valuation (v22)** |Returns the terrestrial biological value of a location in the Flemish Region, based on Latitude and Longitude in the uploaded data file and the Biological Valuation Map (version 22). The Biological Valuation Map is a uniform field-driven survey of the land cover and vegetation in the Flemish Region.|
| **Marine Biological Valuation Map for the Belgian Part of the North Sea** | Returns the total marine biological value of a location in the Belgian Continental Shelf, based on Latitude and Longitude in the uploaded data file and the Biological Valuation Map for the Belgian Continental Shelf (BWZee) produced in 2007. |



## Marineregions gazetteer services 🌐


| Service | Explanation |
|:-------------|:------------------|
| **Get lat-long by mrgid** |Returns the latitude and longitude of the centroid and the preferred gazetteer name of a Marine Regions ID (MRGID), based on the MRGID in the uploaded data file.|
| **Get lat-long by name** | Returns the latitude, longitude, matched name and the Marine Regions ID (MRGID) of a given gazetteer name in the uploaded data file. |
| **Get gazetteer name by lat-long** | Returns the Marine Regions place name and the Marine Regions ID (MRGID) of the bounding box (radius 3) based on Latitude and Longitude in the uploaded data file. |
| **Get lat-long by accepted name** | Returns the latitude, longitude, accepted name and the Marine Regions ID (MRGID) of a given gazetteer name in the uploaded data file.|



## Other taxon services 🐝


| Service | Explanation |
|:-------------|:------------------|
| **Get AphiaID World Register of Marine Species (WoRMS)** |Returns the (first) exact matching AphiaID for a given taxon name, based on the ScientificName in the uploaded data file.|
| **Get GUID Pan-European Species Infrastructure** | The service returns the Globally Unique Identifier (GUID) from PESI for a given taxon name, based on ScientificName in the uploaded data file. |
| **Reverse taxon match by ITIS TSN** | Returns the Aphia record (scientific name, taxonomic status, etc.) based on the Taxonomic Serial Number (TSN) of the Integrated Taxonomic Information System (ITIS) in the uploaded data file. |
| **Reverse taxon match by AphiaID** | Returns the Aphia record (scientific name, taxonomic status, etc.) based on the AphiaID of the World Register of Marine Species (WoRMS) in the uploaded data file.|



## Taxon match services 🦦


| Service | Explanation |
|:-------------|:------------------|
| **Pan-European Species directories Infrastructure (PESI)** |The service matches your taxon list with the Pan-European Species directories Infrastructure database (PESI), based on the ScientificName in the uploaded data file. Website information : http://www.eu-nomen.eu/portal/webservices.php|
Expand All @@ -148,8 +189,11 @@ These web services return the name and code of administrative boundaries, such a
| **Taxon match Interim Register of Marine and Nonmarine Genera (IRMNG)** | The service matches your taxon list with the Interim Register of Marine and Nonmarine Genera (IRMNG), based on the ScientificName in the uploaded data file.|
| **Catalogue of Life (CoL)** | The service matches your taxon list with the Catalogue of Life (CoL), based on the ScientificName in the uploaded data file.|



## Taxon match services WoRMS Regional Species Databases 🐙


| Service | Explanation |
|:-------------|:------------------|
| **Taxon match African Register of Marine Species (AfReMaS)** |The service matches your taxon list with the African Register of Marine Species (AfReMaS), based on the ScientificName in the uploaded data file.|
Expand All @@ -161,16 +205,22 @@ These web services return the name and code of administrative boundaries, such a
| **Taxon match World Register of Marine Introduced Species (WRIMS)** | The service matches your taxon list with the World Register of Marine Introduced Species (WRIMS), based on the ScientificName in the uploaded data file.|
| **Taxon match World Register of marine Cave Species (WoRCS)** | The service matches your taxon list with the World Register of marine Cave Species (WoRCS), based on the ScientificName in the uploaded data file. |



## Taxon observations 🔬


| Service | Explanation |
|:-------------|:------------------|
| **Number of observations of a marine taxon** |Returns all observation points (latitude and longitude) in the Ocean Biodiversity Information System (OBIS) for a specific species, based on the ScientificNameID in the uploaded data file. Website information: http://www.iobis.org/geoserver/web/|
| **Taxon list of a certain region** | Returns a taxon list based on observations from the Ocean Biodiversity Information System (OBIS) for a certain region, based on the Marine Regions ID (MRGID) in the uploaded data file. Website information: http://www.iobis.org/geoserver/web/ |
| **Occurence of a taxon is located within a known distribution record** | The service verifies if the coordinates of the taxon observation in the uploaded data file are located within a distribution record of that taxon in WoRMS/Aphia. In the result report a map is available which shows the coordinates in the uploaded data file and the distribution records of the taxa in WoRMS/Aphia. Website information: http://marinespecies.org/aphia.php?p=webservice |



## ​Tidal services 🌊


| Service | Explanation |
|:-------------|:------------------|
| **Calculate tidal reduction** |Calculates tidal heights in NAP (Normaal Amsterdams Peil), GLLWS (Gemiddeld Laag LaagWater bij Springtij), and TAW (Tweede Algemene Waterpassing) based on Latitude, Longitude and EventDate in the uploaded data file. The calculations are based on the M2 tidal reduction algorithm and the water levels measured by the monitoring network Flemish Banks.|

0 comments on commit c8a11ad

Please sign in to comment.