Page info | ||||||
---|---|---|---|---|---|---|
|
Info | ||||
---|---|---|---|---|
| ||||
|
Easy Heading Macro |
---|
Hide content |
---|
Created by Anabelle Guillory Reviewed by CUS team members Approved on |
...
Warning |
---|
The Atmosphere Data Store (ADS) will soon become the only primary source for access to CAMS datasets and updates, users need to migrate to ADS as soon as possible. The CDS API is a service providing programmatic access to ADS data. Note that access to the CAMS global forecast NRT data on the operational FTP server will remain in place. |
...
Before the release of Copernicus Atmosphere Monitoring Service (CAMS) Atmosphere Data Store (ADS) in March 2020, CAMS datasets were made available through various means depending on data host (e.g. Global CAMS analysis and forecast data hosted at the ECMWF data server and made available though the ECMWF Web API, the programmatic way of retrieving data; European air quality forecast or analysis data through www.regional.atmosphere.copernicus.eu and eu and download.regional.atmosphere.copernicus.eu; etc...)
...
- Python and pip: You are expected to have at least some basic understanding of Python and in particular know how to install packages on your local machine using pip.
- Install the CDS API:
- on linux or on cygwyn (using pip), please follow the instructions HERE.
- Windows users may follow the instructions HERE instead.
- macOS user, please read instructions HERE
On systems running Anaconda, you can install using conda:
Code Block /<install_path>/conda/anaconda2/bin/conda config --add channels conda-forge /<install_path>/conda/anaconda2/bin/conda install cdsapi
- You are recommended to use the latest release of packages: CDS API and see the following page for more details: https://ads.atmosphere.copernicus.eu/api-how-to
ADS account - If you do not yet have a ADS account, please create one HERE.
Info We have had some problems with mail servers rejecting address confirmation emails from the ADS. We are working on this but if you register on the site and don't receive the registration email, please contact the contact User Support Team and we will authorise your address manually.
- Data licence - Before you may download any data from the ADS, you need to have accepted the Terms and Conditions of the dataset of choice. Further details below on how to do this.
...
At this stage, you can test that CDS API is working for you simply by using the basic API request script generated by the ADS Download data web form. Copy this script to a file on your local system and run it using the version of python you installed the CDS API into.
Note | |||||
---|---|---|---|---|---|
Please don't use your CDS ensure you have your ADS userID and key in your ADS .cdsapirc file . if you are requesting data from the ADS. If you have more than one CDS API key and therefore have(e.g. one for your account on the CDS, one for your account on the ADS, stored in separate files), you can use the following method to pass credentials in explicitly (see above) you can use the following methodbelow):
|
If you are encountering difficulties retrieving the data using your basic API script, please have a look at the following page: Common Error Messages for CDS API Requests or contact the User Support with a copy of your API script and any error messages that you may have received.
Note |
---|
The keyword 'grid' is not support for CDS API requests on the ADS. |
Info | ||
---|---|---|
| ||
This document has been produced in the context of theCopernicus AtmosphereAtmosphere Monitoring Service (CAMS) and the Copernicus Climate Change Service (C3S).. The activities leading to these results have been contracted by the European Centre for Medium-Range Weather Forecasts, operator of CAMS and C3Son behalf of the European Union (Delegation Agreement signed on 11/11/2014 and Contribution Agreement signed on 22/07/2021). All information in this document is provided "as is" and no guarantee or warranty is given that the information is fit for any particular purpose. The users thereof use the information at their sole risk and liability. For the avoidance of all doubt , the European Commission and the European Centre for Medium - Range Weather Forecasts have no liability in respect of this document, which is merely representing the author's view. |
Related articles
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...