ICES Marine Data

DOME

The Dome Web Services provide the ability to search and retrieve data from Dome website by providing access to the data.

Each part of the web services is provided by a web service API, which defines the name, input to, and output from the service for a particular data request.

This page lists all the DOME Web Service APIs with a description that includes the information provided by the API, the input needed to get data from the API, and the data that is returned by the API.

ICES also provides a Web Service Description Language (WSDL) document that fully describes the DOME Web Service.
This document can be used to create clients that access the service.

The following web service APIs are provided:

Name

selectContaminantsInBiota()

Description

This API of the webservice returns the records of Contaminants in Biota for the specified filter. To know more about the format please read the document: Contaminants and effects of contaminants in biota.pdf

Input

YearBegining: The year of begining of the data
YearEnd: The year of end of the data
RLABO:Reporting institude (cf. RLABO).
ALABO:Analytical laboratory (cf. RLABO).
MATRX: Matrix being analysed (cf. MATRX).
PARAM: Measured parameter(cf. PARAM).
TAXA: Species name.
MPROG: Monitoring programme (cf. MPROG). Multiple programmes are possible separated by “~” (ascii 126).
PURMT: Purpose of monitoring (cf. PURMT). Multiple purposes possible separated by “~” (ascii 126).
CNTRY: Country that has reported the measurement (cf. CNTRY). Multiple purposes possible separated by “~” (ascii 126)
ParamGroup: Parameter group of measured parameter (cf. PARGROUP).
Area: Filter to a specific ICES Area (cf. ICES_AREA) or to a HELCOM (cf. Areas_HELCOM) or to an OSPAR Region (cf. Areas_OSPAR) .

Output

MPROG: Monitoring programme (cf. MPROG). Multiple programmes are possible separated by “~” (ascii 126)
PURPM: Purpose of monitoring (cf. PURPM) . Multiple purposes possible separated by “~” (ascii 126)
Country: Country that has reported the measurement
RLABO: Reporting institude (cf. RLABO)
STATN: Station name as reported
MYEAR: Monitoring year. Note that MYEAR may not always be identical to the year in date of sampling
DATE: Date of sampling (DD/MM/YYYY)
Latitude: Latitude of measurement (decimal degrees)
Longitude: Longitude of measurement (decimal degrees)
Species: Species/taxon name of examined specimen
SEXCO: Sex of specimen (cf. SEXCO)
NOINP: Number of individuals in sub-sample
MATRX: Matrix being analysed (cf. MATRX)
NODIS: Not used in this data type
PARGROUP: Parameter group of measured parameter (cf. PARGROUP)
PARAM: Measured parameter (cf. PARAM)
BASIS: Basis of determination (cf. BASIS)
QFLAG: Qualifier flag for measured value, i.e. “<” (cf. QFLAG). Multiple flags possible separated by “~” (ascii 126)
Value: Value measured
MUNIT: Measurement unit
VFLAG: Validity flag, i.e. “S“ suspect value (cf. VFLAG). Multiple flags possible separated by “~” (ascii 126)
DETLI: Detection limit value
LMQNT: Limit of quantification
UNCRT: Uncertainty value
METCU: Method of calculating uncertainty (cf. METCU)
ALABO: Analytical laboratory (cf. RLABO)
REFSK: Reference source or key (cf. REFSK)
METST: Method of storage (cf. METST)
METPT: Method of pretreatment (cf. METPT)
METPS: Method of purification/separation (cf. METPS)
METFP: Method of chemical fixation/preservation (cf. METFP)
METCX: Method of chemical extraction (cf. METCX) multiple flags possible (separate multiple entries with “~” (ascii 126))
METOA: Method of analysis (cf. METOA)
FORML: Formula used in calculation (cf. FORML)
Test organism: Not used in this data type
SMTYP: Sampler type (cf. SMTYP)
SUBNO: Sub-sample identification (can refer to an individual specimen or an aggregate pool of same species)
BULKID: If an individual (or parts thereof) has been analysed in one or more bulks, the sub-sample (SUBNO) identification(s) of the bulk(s) can be indicated as a BULKID. BULKID refer to a SUBNO within the same sample (see “tblSampleID”). Multiple SUBNO’s possible separated by “~” (ascii 126)
FINFL: Factors potentially influencing guideline compliance and interpretation of data (cf. FINFL) Multiple factors possible separated by “~” (ascii 126)
tblAnalysisID: Reference to analytical method (integer). Can be used to trace additional fields in ICES data systems
tblParamID: Reference to the measurement (integer). Unique for the data table
tblBioID: Reference to the sub-sample (integer). Unique for a sub-sample
tblSampleID: Reference to the sample (integer). Unique for a sample

Example to get the recordset for Laboratory ALUK for the reported parameter VDSI (Vas Deferens Sequence Index)

Example to get the number of measurements in the database

Name

selectContaminantsInSediment()

Description

This API of the webservice returns the records of Contaminants and biological effects of contaminants in sediment for the specified filter. To know more about the format please read the document: Contaminants and effects of contaminants in sediment.pdf

Input

YearBegining: The year of begining of the data
YearEnd: The year of end of the data
RLABO:Reporting institude (cf. RLABO).
ALABO:Analytical laboratory (cf. RLABO).
PARAM: Measured parameter(cf. PARAM).
MPROG: Monitoring programme (cf. MPROG). Multiple programmes are possible separated by “~” (ascii 126).
PURMT: Purpose of monitoring (cf. PURMT). Multiple purposes possible separated by “~” (ascii 126).
CNTRY: Country that has reported the measurement (cf. CNTRY). Multiple purposes possible separated by “~” (ascii 126)
ParamGroup: Parameter group of measured parameter (cf. PARGROUP).
Area: Filter to a specific ICES Area (cf. ICES_AREA) or to a HELCOM (cf. Areas_HELCOM) or to an OSPAR Region (cf. Areas_OSPAR) .

Output

MPROG: Monitoring programme (cf. MPROG). Multiple programmes are possible separated by “~” (ascii 126)
PURPM: Purpose of monitoring (cf. PURPM) . Multiple purposes possible separated by “~” (ascii 126)
Country: Country that has reported the measurement
RLABO: Reporting institude (cf. RLABO)
STATN: Station name as reported
MYEAR: Monitoring year. Note that MYEAR may not always be identical to the year in date of sampling
DATE: Date of sampling (DD/MM/YYYY)
Latitude: Latitude of measurement (decimal degrees)
Longitude: Longitude of measurement (decimal degrees)
Species: Not used in this data type
SEXCO: Not used in this data type
NOINP: Not used in this data type
MATRX: Matrix being analysed (cf. MATRX)
NODIS: Not used in this data type
PARGROUP: Parameter group of measured parameter (cf. PARGROUP)
PARAM: Measured parameter (cf. PARAM)
BASIS: Basis of determination (cf. BASIS)
QFLAG: Qualifier flag for measured value, i.e. “<” (cf. QFLAG). Multiple flags possible separated by “~” (ascii 126)
Value: Value measured
MUNIT: Measurement unit
VFLAG: Validity flag, i.e. “S“ suspect value (cf. VFLAG). Multiple flags possible separated by “~” (ascii 126)
DETLI: Detection limit value
LMQNT: Limit of quantification
UNCRT: Uncertainty value
METCU: Method of calculating uncertainty (cf. METCU)
ALABO: Analytical laboratory (cf. RLABO)
REFSK: Reference source or key (cf. REFSK)
METST: Method of storage (cf. METST)
METPT: Method of pretreatment (cf. METPT)
METPS: Method of purification/separation (cf. METPS)
METFP: Method of chemical fixation/preservation (cf. METFP)
METCX: Method of chemical extraction (cf. METCX) multiple flags possible (separate multiple entries with “~” (ascii 126))
METOA: Method of analysis (cf. METOA)
FORML: Formula used in calculation (cf. FORML)
Test organism: In vivo/In vitro test organism or cell line (cf. VIVIT)
SMTYP: Sampler type (cf. SMTYP)
SUBNO: Sub-sample identification (can refer to an individual specimen or an aggregate pool of same species)
BULKID: Not used in this data type
FINFL: Factors potentially influencing guideline compliance and interpretation of data (cf. FINFL) Multiple factors possible separated by “~” (ascii 126)
tblAnalysisID: Reference to analytical method (integer). Can be used to trace additional fields in ICES data systems
tblParamID: Reference to the measurement (integer). Unique for the data table
tblBioID: Reference to the sub-sample (integer). Unique for a sub-sample
tblSampleID: Reference to the sample (integer). Unique for a sample

Example to get the recordset for Laboratory ALUK for the reported parameter CD (cadmium)

Name

selectContaminantsInWater()

Description

This API of the webservice returns the records of Contaminants and biological effects of contaminants in water for the specified filter. To know more about the format please read the document: Contaminants and effects of contaminants in water.pdf

Input

YearBegining: The year of begining of the data
YearEnd: The year of end of the data
RLABO:Reporting institude (cf. RLABO).
ALABO:Analytical laboratory (cf. RLABO).
PARAM: Measured parameter(cf. PARAM).
MPROG: Monitoring programme (cf. MPROG). Multiple programmes are possible separated by “~” (ascii 126).
PURMT: Purpose of monitoring (cf. PURMT). Multiple purposes possible separated by “~” (ascii 126).
CNTRY: Country that has reported the measurement (cf. CNTRY). Multiple purposes possible separated by “~” (ascii 126)
ParamGroup: Parameter group of measured parameter (cf. PARGROUP).
Area: Filter to a specific ICES Area (cf. ICES_AREA) or to a HELCOM (cf. Areas_HELCOM) or to an OSPAR Region (cf. Areas_OSPAR) .

Output

MPROG: Monitoring programme (cf. MPROG). Multiple programmes are possible separated by “~” (ascii 126)
PURPM: Purpose of monitoring (cf. PURPM) . Multiple purposes possible separated by “~” (ascii 126)
Country: Country that has reported the measurement
RLABO: Reporting institude (cf. RLABO)
STATN: Station name as reported
MYEAR: Monitoring year. Note that MYEAR may not always be identical to the year in date of sampling
DATE: Date of sampling (DD/MM/YYYY)
Latitude: Latitude of measurement (decimal degrees)
Longitude: Longitude of measurement (decimal degrees)
Species: Not used in this data type
SEXCO: Not used in this data type
NOINP: Not used in this data type
MATRX: Matrix being analysed (cf. MATRX)
NODIS: Not used in this data type
PARGROUP: Parameter group of measured parameter (cf. PARGROUP)
PARAM: Measured parameter (cf. PARAM)
BASIS: Basis of determination (cf. BASIS)
QFLAG: Qualifier flag for measured value, i.e. “<” (cf. QFLAG). Multiple flags possible separated by “~” (ascii 126)
Value: Value measured
MUNIT: Measurement unit
VFLAG: Validity flag, i.e. “S“ suspect value (cf. VFLAG). Multiple flags possible separated by “~” (ascii 126)
DETLI: Detection limit value
LMQNT: Limit of quantification
UNCRT: Uncertainty value
METCU: Method of calculating uncertainty (cf. METCU)
ALABO: Analytical laboratory (cf. RLABO)
REFSK: Reference source or key (cf. REFSK)
METST: Method of storage (cf. METST)
METPT: Method of pretreatment (cf. METPT)
METPS: Method of purification/separation (cf. METPS)
METFP: Method of chemical fixation/preservation (cf. METFP)
METCX: Method of chemical extraction (cf. METCX) multiple flags possible (separate multiple entries with “~” (ascii 126))
METOA: Method of analysis (cf. METOA)
FORML: Formula used in calculation (cf. FORML)
Test organism: In vivo/In vitro test organism or cell line (cf. VIVIT)
SMTYP: Sampler type (cf. SMTYP)
SUBNO: Sub-sample identification (can refer to an individual specimen or an aggregate pool of same species)
BULKID: Not used in this data type
FINFL: Factors potentially influencing guideline compliance and interpretation of data (cf. FINFL) Multiple factors possible separated by “~” (ascii 126)
tblAnalysisID: Reference to analytical method (integer). Can be used to trace additional fields in ICES data systems
tblParamID: Reference to the measurement (integer). Unique for the data table
tblBioID: Reference to the sub-sample (integer). Unique for a sub-sample
tblSampleID: Reference to the sample (integer). Unique for a sample

Example to get the recordset for Laboratory ALUK for the reported parameter CD (cadmium)

Name

selectFishDisease()

Description

This API of the webservice returns the records of Contaminats in Biota for the specified filter. To know more about the format please read the document: Disease in biota.pdf

Input

Output

Example to get the recordset for fin rot/erosion (acute/healing) in the matrix fin of the species Melanogrammus aeglefinus

International Council for the Exploration of the Sea (ICES) · Conseil International pour l'Exploration de la Mer (CIEM)

ICES Secretariat · H. C. Andersens Boulevard 44-46, DK 1553, Copenhagen Denmark · Tel: +45 3338 6700 · Fax: +45 3393 4215 · info@ices.dk