|
The download service is based on access to pre-prepared csv files and the service helps you to extract the list of files to be downloaded matching your search criteria.
Data available in this service comes from two dataflows: E1a and E2a. The E1a data are reported to EEA by memberstates every September and covers the year before the delivery. This means that data delivered in September 2017 covers 2016. EEA also recieves up-to-date (E2a) data on hourly basis from most of its member states. Because E1a data are validated and considered an official delivery, all E2a data are deleted before E1a data are imported. This is to ensure that no E2a data are mixed with E1a data.
Download form
The form below will help you to build the request URL to get the list of files to download matching your criteria.
Before executing the URL it is possible to refine the request, e.g. by adding a specific station or leaving a parameter blank.
Note: Country, City and Pollutant are interlinked and changing the country will cause the others to change.
Note: The form above is only to help build the request URL. Executing the request URL will return a list of URL's identifying the individual files to download.
A parameter can also be left blank, e.g. if all files from a country are requested, the pollutant parameter is left blank like:
...AQData_Extract.fmw?CountryCode=AD&CityName=&Pollutant=&Year_from=2016&Year_to=2016&Station_localid=&Samplingpoint=&Output=HTML
Sample file
The files are provided as comma separated files, see this sample: https://ereporting.blob.core.windows.net/downloadservice/AD_10_42785_2016_timeseries.csv
Additional parameters
The form above supports countrycode, pollutant and timespan in years. Additional two parameters are available which is also included in the request URL:
Station : If only data from a specific station is needed, use this parameter to specify the station localid
Samplingpoint: If only data from a specific samplingpoint is needed, use this parameter to specify the samplingpoint localid
To identify a specific station and or samplingpoint localid, we recommend to use one of the viewers available in the air quality portal (http://aqportal.eionet.europa.eu), e.g the UTD viewer http://maps.eea.europa.eu/UTDViewer/
How to download all the files?
This service will provide a list of URL from where each file can be downloaded, and depending on the user need (and number of files) the output can be requested as HTML or TEXT. Below are some possible options for download:
1) Click on each file (use the HTML output option) and download to a local folder
2) Install an extension in your browser (e.g. Multi-File Downloader in Chrome) which makes it easy to download all files from a web page (use the HTML output option)
3) Use the TEXT output option and make a script which goes through the list and downloads each file
About the data
In principle the files are updated once a year after the yearly reporting cycle has finished. The reporting cycle starts in September and normally finished the following January after which we initiate an refresh of the files for this service.
Content of files
| Field | Type | Description |
| Countrycode | String | Country iso code |
| Namespace | String | Unique namespace as provided by the country |
| AirQualityNetwork | String | Network identifier |
| AirQualityStation | String | Localid of the station |
| AirQualityStationEoICode | String | Unique station identifier as used in the past AirBase system |
| Samplingpoint | String | Localid of the samplingpoint |
| Samplingpoint | String | Localid of the samplingpoint |
| SamplingProcess | String | Localid of the samplingprocess |
| Sample | String | Localid of the sample (also known as the feature of interest) |
| AirPollutant | String | Short name of pollutant. Full list: http://dd.eionet.europa.eu/vocabulary/aq/pollutant/view |
| AirPollutantCode | String | Reference (URL) to the definition of the pollutant in data dictonary |
| AveragingTime | String | Defines the time for which the measure have been taken (hour, day, etc) |
| Concentration | Value | The measured value/concentration |
| UnitOfMeasurement | String | Defines the unit of the concentration |
| DateTimeBegin | Datetime | Defines the start time (yyyy-mm-dd hh:mm:ss Z) of the measurement (includes timezone) |
| DateTimeEnd | Datetime | Defines the end time (yyyy-mm-dd hh:mm:ss Z)of the measurement (includes timezone) |
| Validity | Integer | The validity flag for the measurement. See http://dd.eionet.europa.eu/vocabulary/aq/observationvalidity/view |
| Verification | Integer | The verification flag for the measurement. See http://dd.eionet.europa.eu/vocabulary/aq/observationverification/view |
Metadata
The join between timeseries files and the metadata file should be be made using the Countrycode (or Namespace) and SamplingPoint.
| Field | Type | Description |
| Countrycode | String | Country iso code |
| Namespace | String | Namespace of network |
| AirQualityNetwork | String | Network identifier |
| AirQualityStation | String | Localid of station |
| AirQualityNatCode | String | National code of station |
| AirQualityStationEoICode | String | Station EoI code as used in the past AirBase system |
| AirQualityStationArea | String | Reference to area code. Full list at http://dd.eionet.europa.eu/vocabulary/aq/areaclassification/view |
| SamplingPoint | String | Localid of samplingpoint |
| SamplingProcess | String | Localid of process |
| Sample | String | Localid of sample (also known as feature of interest) |
| BuildingDistance | Integer | Distance to building (m). Value of -999 indicate unknown |
| EquivalenceDemonstrated | String | Reference to demonstrated equivalence. Full list at http://dd.eionet.europa.eu/vocabulary/aq/equivalencedemonstrated/view |
| InLetHeight | Integer | Height of inlet (m). Value of -999 indicate unknown |
| KerpDistance | Integer | Distance to kerp (m). Value of -999 indicate unknown |
| MeasurementEquipment | String | Refernce (URL) to measurement equipment |
| MeasurementType | String | Reference to measurement type (full list at http://dd.eionet.europa.eu/vocabulary/aq/measurementtype/view) |
| AirPollutantCode | String | Reference (URL) to pollutant definition in data dictionary |
| AirPollutant | String | Short pollutant name measured at this samplingpoint |
| AirQualityStationType | String | Short name of station type (full list at http://dd.eionet.europa.eu/vocabulary/aq/stationclassification/view) |
| Projection | String | Reference to projection |
| Longitude | Decimal | Longitude of samplingpoint |
| Latitude | Decimal | Latitude of samplingpoint |
| Altitude | Integer | Altitude of samplingpoint (m) |
Extract of metadata (file is updated on daily basis): https://ereporting.blob.core.windows.net/downloadservice/metadata.csv
More information on air quality: http://www.eionet.europa.eu/aqportal
|