20
Guidelines: INSPIRE web services. A gentle introduction. Issued by: METEO FRANCE Date: 05/06/2019

Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Guidelines: INSPIRE web services. A gentle introduction.

Issued by: METEO FRANCE

Date: 05/06/2019

Page 2: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

Summary

The objective of Météo-France web service is to facilitate the access and the consultation ofpublic data in order to make them interoperable with georeferenced data from otherAdministrations or other sources.

In this document, are explained how getting access to web service rights and how to usethe web service REST API in order to download numerical data or to display map as layers.All data concerned in this document are data issued from Copernicus Atmosphere Servicesproduction line over Europe also called Copernicus Regional Atmosphere Production.

The Copernicus data are operable and interoperable in compliance with INSPIRE standards.

GuideLines : INSPIRE CAMS50 web services | 2

Page 3: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

Table des matières1. What is INSPIRE?...........................................................................................42. What is a web service?....................................................................................53. Available data sets through INSPIRE services.....................................................54. How to access Météo-France INSPIRE services for CAMS regional production?.........7

4.1. The concept.............................................................................................74.2. How to get an account?.............................................................................74.3. How to get a key?....................................................................................84.4. Use of a key to invoke a web service...........................................................8

5. Key validity duration.......................................................................................96. General information on Météo-France INSPIRE services........................................97. View (or images) services..............................................................................10

7.1. Version:................................................................................................117.2. Operations:............................................................................................117.3. Dimensions:...........................................................................................117.4. Examples of queries:...............................................................................13

7.4.1. GetCapabilities.................................................................................137.4.2. GetMap...........................................................................................13

8. Download services........................................................................................138.1. Version:................................................................................................158.2. Operations:............................................................................................158.3. GetCapabilities.......................................................................................15

9. Available data sets and services......................................................................1810. Requesting via API – Helper:........................................................................2011. Contact......................................................................................................21

GuideLines : INSPIRE CAMS50 web services | 3

Page 4: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

1. What is INSPIRE?

The European Directive INSPIRE1 aims at establishing a spatial data infrastructure toensure interoperability between databases and facilitate the dissemination, availability, useand reuse of geographical information in Europe.

It was transposed by the insertion of articles in the French code of the environment 2 (Art.L127-1 to L127-10 and R127-8 to R127-10). According to this code Météo-France must, asa public authority, provide certain data according to the INSPIRE requirements.

These requirements mainly focus on: Documentation of data and services (metadata); Services on data, in particular for consulting and downloading; Data exchange formats to ensure interoperability.

For more information on the legislation relating to the INSPIRE Directive and all informationon its implementation in France, we recommend to have a look at the website CNIG(National Council for Geographic Information).

The directive classifies data in different topics with specific requirements. The atmosphericservice is one of the topics of Annex III of the Directive. It is the subject of a specificationdocument at the European level named “Data Specification on Atmospheric Conditions -Meteorological Geographical Features - Technical Guidelines” which can be downloadedon the INSPIRE portal of the European Commission.

These guidelines take into account INSPIRE's implementing rules with regards toatmospheric forecast data, which have specific characteristics compared to othergeographical data, in particular regarding time issue, vertical extent, coordinate systems,refresh rate and data volumes that can often be very high.

2. What is a web service?

A network service or a "web service" is a software system to support communication anddata exchange between heterogeneous systems and applications in distributedenvironments. So this is a set of interfaces reachable from Internet or an Intranet, formachine to machine interaction in real time.

1 Directive 2007/2 / EC of the European Parliament and of the Council of March, 14 th 2007 establishing an Infrastructurefor Spatial Information in the European Community (INSPIRE) (http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri= OJ: L: 2007: 108: 0001: 0014: en: PDF)2 The French Environmental Code is available online at http://www.legifrance.gouv.fr/affichCode.do?cidTexte=LEGITEXT000006074220.

GuideLines : INSPIRE CAMS50 web services | 4

Page 5: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

In geomatics, a web service offers a service that will enable the remote management ofdata. Several types of services covering different functional areas can be identified:

Discovery services (CSW3 protocol); View services, i.e. the simple display of maps (WMS4 protocols and/ or WMTS 5); Download services of data (WCS6, WFS7 and SOS8 protocols).

Météo-France has set up an infrastructure of spatial data web services which allow to viewand download spatial data through appropriate queries. The consultation services arebased on the WMS standard protocol and the downloading services are based on the WCSstandard protocol.

The standards describe the parameters to be set to properly access the desired result:identification of layers or objects, spatio-temporal extent, used projection, etc.

3. Available data sets through INSPIRE services

In this guidelines, the scope of concerned data covers the Copernicus RegionalAtmosphere production as mentioned in the user guide of data server. The following dataare concerned :

Forecast of atmospheric composition for different species and at different levels is-sued from the Multi-Model Ensemble.

Covered domain, also called regional domain, is : –24,95°W/30,05°N/44,95°W/71,95°N on a grid with a resolution of 0.1°. Data is updated every day in order to compute 96hours of forecasts.

Forecasts of atmospheric composition for different species and at different levels is-sued from every partner model involved in the ensemble calculation.

Partner models are : CHIMERE from INERIS (France), EMEP from MET Norway(Norway), EURAD-IM from University of Cologne (Germany), LOTOS-EUROS from

3 CSW: OGC® standard Catalog Service for the Web4 WMS: OGC® standard Web Map Service5 WMTS: OGC® standard Web Map Tile Service6 WCS: OGC® standard Web Coverage Service7 WFS: ® OGC standard Web Feature Service8 SOS: OGC standard ® Sensor Observation Service

GuideLines : INSPIRE CAMS50 web services | 5

Page 6: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

KNMI and TNO (Netherlands), MATCH from SMHI (Sweden), MOCAGE from Météo-France (France) and SILAM from FMI (Finland).

Covered domain, also called regional domain, is : –24,95°W/30,05°N/44,95°W/71,95°N on a grid with a resolution of 0.1°.

Data are updated every day in order to compute 96hours of forecasts.

Analyses for different species and at different levels issued from the MULTI-MODELENSEMBLE.

Covered domain, also called regional domain, is : –24,95°W/30,05°N/44,95°W/71,95°N on a grid with a resolution of 0.1°.

Data is updated every day in order to compute 24hours of analyses. Note that delivered analyses are analyses for the day before.

Analyses of atmospheric composition for different species and at different levels is-sued from every partner model involved in the ensemble calculation.

Partner models are : CHIMERE from INERIS (France), EMEP from MET Norway(Norway), EURAD-IM from University of Cologne (Germany), LOTOS-EUROS fromKNMI and TNO (Netherlands), MATCH from SMHI (Sweden), MOCAGE from Météo-France (France) and SILAM from FMI (Finland).

Covered domain, also called regional domain, is : –24,95°W/30,05°N/44,95°W/71,95°N on a grid with a resolution of 0.1°.

Data are updated every day in order to compute 24hours of analyses. Note that delivered analyses are analyses for the day before.

Other types of data will be added gradually over time.

GuideLines : INSPIRE CAMS50 web services | 6

Page 7: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

4. How to access Météo-France INSPIRE services for CAMS regional production?

4.1. The concept

It is compulsory to register to be able to access the services even when these servicesprovide data without any limitation of access nor use. Data access policy implementation isbased on a key mechanism (API keys) for now.

This chapter describes how to obtain and use keys for these services. It is especially aimedat helping developers who want to directly query the services from a third client applicationnot provided by Météo-France, typically a GIS (Geographic Information System).

4.2. How to get an account?

To get an account :

1) First you have to register on the Regional data server registration page.Fill in the form and accept the CAMS Data License.

2) A mail will be sent to you recapping your user profile and explaining you how to generatea token.

3) To use CAMS regional APIs, you have now to generate this valid token. See below forthe procedure.

4.3. How to get a key?

The user gets a key by making a request to an authentication web service, accessible via HTTP, by giving his account ID (UID) and the associated password (pwd):

https://geoservices.regional.atmosphere.copernicus.eu/services/GetAPIKey?username=YOUR_UID&password=YOUR_PASSWORD

The user then receives a reply with an XML document containing the key:

<Token>__Tiyodhhsd4G4q8856sqY884g59W6T54gSg__</Token>

Note: double underscores are part of the token.

GuideLines : INSPIRE CAMS50 web services | 7

Page 8: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

NB: 1- Please note that the GetAPIKey web service does not verify the validity of the UID and associated password.

In practice, the service provides a key (without sending an error message) even if the user has provided a wrong information, but in this case, the key will be invalid. The real access control is performed during the service invocation.

2- if you decide to change the password sent to you during the registration step, you will have to generatea new token.

3- This unique key/token allows the use of all CAMS Regional APIs.

4.4. Use of a key to invoke a web service

A key provides access to services accessible via URLs such as (REST for example):

https://geoservices.regional.atmosphere.copernicus.eu/services/service_name/?param1=value1&param2=value2& ... &paramN=valueN

A key is associated with an identified user and gives access to all datasets he has the rightto access, either for consultation or downloading.

This key must be added either to the list of key-value pairs in the service invocation URL, nor in the base access URL to the service. Please note that the “token” setting may be positioned anywhere in the list of settings and in particular at the beginning or the end.

https://geoservices.regional.atmosphere.copernicus.eu/services/service_name/?param1=value1&param2=value2&...&paramN=valueN&token=YOUR_KEY

https://geoservices.regional.atmosphere.copernicus.eu/api/YOUR_KEY/service_name/?param1=value1&param2=value2&...&paramN=valueN

5. Key validity duration

A key has an unlimited validity duration, until the revocation of access rights to theresource.

6. General information on Météo-France INSPIRE services

INSPIRE identifies different types of services including:

GuideLines : INSPIRE CAMS50 web services | 8

Page 9: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

Discovery services; View services; Download services.

This documentation only deals with view and download services.

Discovery services are also provided by the “Géocatalogue” (the French geographicalinformation portal) and OpenWIS of the WMO Information System for Western Europe(Global Information System for Western Europe portal) implemented by both Météo-Franceand the UK Meteorological Office.

In addition, the INSPIRE directive mentions other types of services (processing servicesand dial-in services) that are not yet available.

Services operate on “data sets series” which are data sets grouped into time series. Theseseries of data sets are homogeneous in terms of access rights policies, spatial-temporalarea and development process. It is at the data sets series level that data can bediscovered on the “Géocatalogue” or on the OpenWIS website because metadata areassociated with that level of granularity. It is possible to group data sets series into a set ofseries if necessary.

Typically, results of Multi-Model ENSEMBLE provided on an overall 0°1 grid are seen as adata set series. A data set represents for example the results of a particular run of thismodel.

For design and practical reasons, services are associated with one and only one "data setseries". Each data set series will be made available at least through a consultation service(WMS) and a download service (WCS).

NB : Request examples given in this document are a in plain text for readability reasons. It can benecessary to encode the URL to prevent a misleading interpretation of some character such as “(“,“)”; “&” or “/”...

GuideLines : INSPIRE CAMS50 web services | 9

Page 10: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

7. View (or images) services

NB : a view service is available on each offered data set.

View services are based on the WMS 1.3.0 standard (OGC® 06-042) and compliant with“basic WMS” conformance class and with INSPIRE implementation rules on services."Basic WMS" conformance class corresponds to a WMS where only GetCapabilities andGetMap operations are implemented.

WMS services allow remote users to get access to raster georeferenced images from araster or a vector data source, via a simple HTTP request. Data are available in PNGformat.

For more details on the WMS standard, you can consult the online documentation availableat http://www.opengeospatial.org/standards/wms/ The service is self-documented through the GetCapabilities operation that provides a list ofsupported operations and available layers. These layers are generally associated with aphysical parameter (temperature, wind, relative humidity ...).

For each layer the description of covered space domain, supported coordinate systems,dimensions and attributes - especially default values and the graphic styles available – canbe found in the GetCapabilities response.

Main characteristics of Météo-France implementation are:

7.1. Version:

WMS 1.3.0 only and INSPIRE extensions.

7.2. Operations:

GetCapabilities, GetMap

7.3. Dimensions:

The management of dimensions is compliant with the Best Practice guide on theimplementation of the WMS standard in meteorology, written by an OGC® thematic working

GuideLines : INSPIRE CAMS50 web services | 10

Page 11: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

group and called "OGC Best Practice for using Web Map Services (WMS) with Time-Dependent or Elevation-dependent Data" (OGC ® 12-111r1).

The Service supports 3 dimensions:

TIME: validity date of data (for digital weather prediction, baseline plus forecast step) ; REFERENCE_TIME: baseline date time of the forecast, called model “run” date ; ELEVATION: vertical level, expressed in the pressure coordinatesystem. Note that for products only defined at ground level such as pollen products, the parameterELEVATION must NOT be mentioned.

Default value management policy:

If TIME and REFERENCE_TIME are not specified in the request or are specified as a valuewith the keyword "current", the service returns the latest forecast (issued from the lastmodel run) valid for the closest time to current date (the in-service date). These dates areindicated as the “default” attribute value in the GetCapabilities response;

If ELEVATION is not specified in the request and the layer is available at several verticallevels, the service provides the first level of the available levels list in the GetCapabilitiesresponse. Beware the default vertical level may not be the closest to the ground level of thelist.

GuideLines : INSPIRE CAMS50 web services | 11

Page 12: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

7.4. Examples of queries:

7.4.1. GetCapabilities

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WMS?request=GetCapabilities&service=WMS&version=1.3.0&language=en&token=YOUR_KEY

7.4.2. GetMap

Example 1 : Product with an elevation dependency

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WMS?request=GetMap&service=WMS&version=1.3.0&LAYERS=O3__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND&CRS=EPSG:4326&styles=O3_USI__HEIGHT__SHADING&format=image/png&width=550&height=400&BBOX=30.05,-24.95,71.95,44.95&ELEVATION=0&dim_reference_time=2016-12-01T00:00:00Z&time=2016-12-01T18:00:00Z&token=YOUR_KEY

Layer : O3__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND Coordinate system : EPSG: 4326 (a.k.a. Geographic, Equidistant Cylindrical, Plate Carre or

Equirectangular ) Layer style : contours with coloured areas according to the concentration

Raster format : png Image Size : 550 points (on longitude axis) * 400 points (on latitude axis) Geographic area : 30.05N 24.95W (SW corner); 71.95N, 44.95E (NE corner)

Level 0m above ground.

Model run date : 2016-12-01T00:00:00Z (December 1st , 2016 at 0h GMT)

Validity date of forecast : 2016-12-01T18:00:00Z (December 1st , 2016 at 18h GMT)

Be careful with the order of geographic coordinates as BBOX is defined in the requestedcoordinate system. In EPSG:4326 the order is minimum latitude, minimum longitude,maximum latitude, maximum longitude.

Example 2: Products only defined at ground level (currently forecasts for pollens).

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WMS?request=GetMap&service=WMS&version=1.3.0&LAYERS=OLIVEPOLLEN__GROUND_OR_WATER_SURFACE&CRS=EPSG:4326&styles=C_POL_OLIVE__GROUND__SHADING&format=image/png&width=550&height=400&BBOX=30.05,-

GuideLines : INSPIRE CAMS50 web services | 12

Page 13: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

24.95,71.95,44.95&dim_reference_time=2016-01-20T00:00:00Z&time=2016-01-20T12:00:00Z&token=YOUR_KEY

Layer : OLIVEPOLLEN__GROUND_OR_WATER_SURFACE Coordinate system : EPSG: 4326 (a.k.a. Geographic, Equidistant Cylindrical, Plate Carre or

Equirectangular ) Layer style : contours with coloured areas according to the concentration

Raster format : png Image Size : 550 points (on longitude axis) * 400 points (on latitude axis) Geographic area : 30.05N 24.95W (SW corner); 71.95N, 44.95E (NE corner)

Model run date : 2017-01-20T00:00:00Z (January 20th , 2017 at 0h GMT)

Validity date of forecast : 2017-01-20T12:00:00Z (January 20th , 2017 at 12h GMT) Note: In such a case the parameter elevation must not be mentioned.

8. Download services

The WCS norm relates to the downloading of geographical coverages (or “fields”) incompliance with the ISO 19123 standard. A geographical coverage is mathematically afunction from a spatial or space-time domain (called “Domain Set”) to a values domain(called “Range Set”).

Météo-France WCS services enable to download results issued from atmosphericcomposition models , as 2D sub-groups from 3D fields (longitude, latitude, validity time) or4D fields (longitude, latitude, validity time and altitude).

Fields the services operates on are “Referenceable Grid Coverage”. That means thatcoordinates of each point can be obtained in an external coordinate system. The externalcoordinate system of offered services has 4 dimensions: longitude, latitude, validity timeand vertical level.Please bear in mind that the service only allows for sub-group downloads limited to 2dimensions, even if the coverage is defined in 3 or 4 dimensions.

The service is self-documented through the GetCapabilities operation which providesservice metadata, in particular the list of supported operations and the list of availablefields.

The service provides a DescribeCoverage operation which describes formally the fieldsstructure in XML format.

The offered download service is based on the following standards:

GuideLines : INSPIRE CAMS50 web services | 13

Page 14: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

OGC® Web Coverage Service 2.0 Interface Standard – Core (OGC® 09-110r4)OGC® Web Coverage Service 2.0 Interface Standard – KVP Protocol Binding Extension(OGC® 09-147r3)

Main characteristics of Météo-France implementation are:

8.1. Version:

WCS 2.0.1 and INSPIRE extensions.

8.2. Operations:

GetCapabilities, DescribeCoverage, GetCoverage

8.3. GetCapabilities

Settings:

Service: WCS (compulsory)Version: 2.0.1 (compulsory, the only one supported) Request: GetCapabilities (compulsory)Language: language of the response (optional, INSPIRE extension); French (fre) andEnglish (en) are available.

Example of query:

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WCS?SERVICE=WCS&REQUEST=GetCapabilities&version=2.0.1&token=YOUR_KEY&Language=en

Response:

GetCapabilities response gives a list of operations supported by the service and a list ofavailable fields:

Title ID ISO type

...<wcs:CoverageSummary>...

GuideLines : INSPIRE CAMS50 web services | 14

Page 15: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

</wcs:CoverageSummary><wcs:CoverageSummary>

<ows:Title>Air temperature on isobare surfaces.

</ows:Title><wcs:CoverageId>

CO__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND___2016-11-21T00.00.00Z</wcs:CoverageId><wcs:CoverageSubtype>

ReferenceableGridCoverage</wcs:CoverageSubtype>

</wcs:CoverageSummary>...<wcs:CoverageSummary>...</wcs:CoverageSummary>...

DescribeCoverage

Settings:

Service: WCS (compulsory)Version: 2.0.1 (compulsory, the only one supported)Request: GetCoverage (compulsory)CoverageId: coverage identifier (as it appears in the GetCapabilities response)

Example of query:

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WCS?SERVICE=WCS&version=2.0.1&REQUEST=DescribeCoverage&CoverageId= CO__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND___2016-12-01T00.00.00Z &token=YOUR_KEY

DescribeCoverage response describes the coverage structure:

Spatial extent (latitude-longitude cover)Temporal extent (validity date of the forecast)Geometry of the grid (coverage “DomainSet”)

Number of grid points on the different axesCoordinates System used on the different axesPoint coordinates on the diferent axes:coordinates on longitude and latitude axes define a regulargrid which mesh depends on the data set resolution.on the time axis, these coordinates providethe available forecast steps in seconds from the reference date of the model (“run”) and not theabsolute validity dates in ISO 8601, because of the GML limit target. Conversely, dates in queriesshould be compliant with the ISO 8601 format – see example below.

GuideLines : INSPIRE CAMS50 web services | 15

Page 16: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

On the vertical axis, these coordinates provide the different levels available in pressure orheight coordinates.

Type of data and value unit on the grid (coverage “RangeSet”).

GetCoverage

Settings:

Service: WCS (compulsory) Version: 2.0.1 (compulsory, the only one supported) Request: GetCoverage (compulsory) CoverageId: coverage identifier (as it appears in the GetCapabilities response) Subset: subsetting parameters along the axes. Combination of subset settings in the

query must define a subset of at most dimension 2.

Format: (optional) : at the moment only grib format are available for WCS services.The resulting value is application/x-grib

Note that for products only defined at ground level, the request should NOT include anysubset mentioning height dependency. Example of query: case of a product with height dependency.

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WCS?service=WCS&version=2.0.1&REQUEST=GetCoverage&coverageid= CO__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND___2016-12-01T00.00.00Z&subset=time(2016-12-01T18:00:00Z)&subset=lat(40,55)&subset=long(-5,10)& subset=height(0 )&format = application/x-grib &token=YOUR_KEY

Coverage :CO__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND___2016-12-01T00.00.00Z (Carbonmonoxide concentration at height level provided by the run dated 2016-12-01T00.00.00Z)

Latitude sub-set : from 40°N to 55°N

Longitude sub-set : from 5°W to 10°E

Step sub-set : 2016-12-01T18:00:00Z

Vertical level subset : 0m

Format : grib

Example of query: case of a product defined at ground level.

GuideLines : INSPIRE CAMS50 web services | 16

Page 17: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WCS?service=WCS&version=2.0.1&REQUEST=GetCoverage&coverageid= OLIVEPOLLEN__GROUND_OR_WATER_SURFACE ___2017-01-20T00.00.00Z&subset=time(2017-01- 20T12:00:00Z)&subset=lat(40,55)&subset=long(-5,10)&format = application/x- grib &token=YOUR_KEY

Coverage :OLIVEPOLLEN__GROUND_OR_WATER_SURFACE___2017-01-20T00.00.00Z (Olive pollen concentration at height level provided by the run dated 2017-01-20T00.00.00Z)

Latitude sub-set : from 40°N to 55°N

Longitude sub-set : from 5°W to 10°E

Step sub-set : 2017-01-20T12:00:00Z

Vertical level subset : this parameter must NOT be mentioned for a ground level product.

Format : grib

9. Available data sets and services

Metadata of all available data sets and related services will be available on the OpenWISportal of the WMO Information System for Western Europe, or in the Géocatalogue (Frenchwebsite for geographic information).

However, for convenience, a summary of the datasets available as well as the relatedservices and URLs are presented in the following table.

For example, to access the GetCapabilites view service for forecasts issued from Multi-Model Ensemble, simply concatenate the URL base with the section of the WMS settingsand the access key as shown below:

https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WMS?request=GetCapabilities&version=1.3.0&service=WMS&token=YOUR_KEY

Below Regional domain refeers to 30.05N 24.95W (SW corner); 71.95N, 44.95E (NEcorner) domain.

Data sets Model Service Type

URL base to services

Numerical forecastsof atmospheric composition at resolution 0°1

on regional domain.

ENSEMBLE WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-FORECAST-01-

GuideLines : INSPIRE CAMS50 web services | 17

Page 18: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

EUROPE-WCS?CHIMERE WMS https://

geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-CHIMERE-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-CHIMERE-FORECAST-01-EUROPE-WCS?

EMEP WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EMEP-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EMEP-FORECAST-01-EUROPE-WCS?

EURAD-IM WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EURADIM-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EURADIM-FORECAST-01-EUROPE-WCS?

LOTOS-EUROS

WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-LOTOSEUROS-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-LOTOSEUROS-FORECAST-01-EUROPE-WCS?

MATCH WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MATCH-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MATCH-FORECAST-01-EUROPE-WCS?

MOCAGE WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MOCAGE-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MOCAGE-FORECAST-01-EUROPE-WCS?

SILAM WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-SILAM-FORECAST-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-SILAM-FORECAST-01-EUROPE-WCS?

Numerical analyses ENSEMBLE WMS https://

GuideLines : INSPIRE CAMS50 web services | 18

Page 19: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

of atmospheric composition at resolution 0°1

on regional domain.

geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-ENSEMBLE- ANALYSIS-01-EUROPE-WCS?

CHIMERE WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-CHIMERE-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-CHIMERE-ANALYSIS-01-EUROPE-WCS?

EMEP WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EMEP-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EMEP-ANALYSIS-01-EUROPE-WCS?

EURAD-IM WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EURADIM-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-EURADIM-ANALYSIS-01-EUROPE-WCS?

LOTOS-EUROS

WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-LOTOSEUROS-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-LOTOSEUROS-ANALYSIS-01-EUROPE-WCS?

MATCH WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MATCH-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MATCH-ANALYSIS-01-EUROPE-WCS?

MOCAGE WMS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MOCAGE-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-MOCAGE-ANALYSIS-01-EUROPE-WCS?

SILAM WMS https://

GuideLines : INSPIRE CAMS50 web services | 19

Page 20: Guidelines: Numerical Data CAMS...Copernicus Atmosphere Monitoring Service Copernicus Atmosphere Monitoring Service Summary The objective of Météo-France web service is to facilitate

Copernicus Atmosphere Monitoring Service

Copernicus Atmosphere Monitoring Service

geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-SILAM-ANALYSIS-01-EUROPE-WMS?

WCS https://geoservices.regional.atmosphere.copernicus.eu/services/CAMS50-SILAM-ANALYSIS-01-EUROPE-WCS?

10. Requesting via API – Helper:

In order to help users in their WMS or WCS requesting, an API URL builder is provided at https://www.regional.atmosphere.copernicus.eu/index.php?category=data_access&subensemble=geo_services.

On this webpage users will find an GUI interface with multiple choices available throught several dropboxes.

These selection dropboxes are built on getCapabilities and describeCoverage requests and finally URL for getMap and getCoverage are provided to the users.

A simple copy and paste allows the users to get the URLs and to transfer it to their ownenvironment (GIS for a WMS getMap or scripting, for example, for a WCS getCoverage use).

11. Contact

CONTACT: For any questions please contact:

Copernicus Support mail contact:

[email protected]

Copernicus CAMS and C3S Support (Public Service Desk web site):

http s ://copernicus-support.ecmwf.int/

GuideLines : INSPIRE CAMS50 web services | 20