Welcome to the Meersens API documentation. These APIs are designed to let you retrieve and integrate environmental data seemlessly into your own services and products.
Using these APIs, you`ll be able to retrieve information on:
- Air quality
- Pollen conditions
- Noise pollution
- Tap water quality
- UV index
- Weather conditions
For each of these APIs, endpoints allow you to request various data, depending on what information better suit your business case. It may include:
- Current conditions
- Pollutant history data
- Pollutant forecast data
- Today summarized information
Theses APIs are based on the RESTful architecture, returning either requested data or a described error message
Data confidence
Data quality may vary, mostly depending on the geographic area you`re requesting or on the timeframe you`re interested in. In order to materialize this variation, each result retrieved through the Meersens API comes with a confidence index, from 1 to 5:
- Between 1 and 2: Poorly trusted data, should not happen.
- Between 2 and 3: Unsatisfying confidence in data, meaning the geographic area is not well covered.
- Between 3 and 4: Pretty trusted data, but with uncertainties, mainly due to the requested timeframe (prediction).
- Between 4 and 5: Highly trusted data.
Internationalization
All environmental API are internatiolized and available in multiple languages. By default, results and data are returned in English, but you can easily change the output language by setting the Accept-Language header to the desired language.
Currently Meersens environmental APIs support the following languages:
- en: English (default)
- fr: French
- de: German
- es: Spanish
- it: Italian
- nl: Dutch
- cn: Chinese (simplified)
Please note that if you request an API using an unsupported language, the default English language will be returned.
Air quality
The air quality API lets you request air quality data for a specific location. Retrieved information includes pollutant concentration levels, data confidence, comparison with W.H.O applicable standards & norms and generic health recommendations.
Major pollutants are available, including:
- O3: Ozone
- NO2: Nitrogen Dioxide
- PM10: Fine Particulate Matter 10
- PM2.5: Fine Particulate Matter 2.5
- CO: Carbon Monoxide
- SO2: Sulphur Dioxide