Provides access to current and forecast weather, air quality, and related environmental variables for locations identified by name or coordinates, along with place lookup, nearest‑place resolution, historical weather data, and PNG map image generation for selected variables.
Returns air quality data for a single point (geographic name or GPS)
place_id(query) — Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name).
lat(query) — Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4
lon(query) — Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4
timezone(query) — Timezone to be used for the date fields. If not specified, local timezone of the forecast location will be used. The format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used. Alternatively you may use the value ``auto`` in which case the local timezone of the location is used. The full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
GET
/find_places
Search for places. Complete words required.
text(query, required) — Place name or ZIP code
language(query) — The language of text summaries and place names (variable names are never translated). Available languages are: * ``en``: English * ``es``: Spanish * ``fr``: French * ``de``: German * ``pl``: Polish * ``pt``: Portuguese * ``cs``: Czech
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
GET
/find_places_prefix
Prefix search for places. Useful for autocomplete forms.
text(query, required) — Place name or ZIP code
language(query) — The language of text summaries and place names (variable names are never translated). Available languages are: * ``en``: English * ``es``: Spanish * ``fr``: French * ``de``: German * ``pl``: Polish * ``pt``: Portuguese * ``cs``: Czech
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
GET
/map
Returns PNG weather map for given area and variable
tile_x(query) — The X coordinate of Google Maps tile
tile_y(query) — The Y coordinate of Google Maps tile
tile_zoom(query) — The zoom level of Google Maps tile
min_lat(query) — Minimal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2
min_lon(query) — Minimal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2
max_lat(query) — Maximal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2.
max_lon(query) — Maximal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2
variable(query, required) — Name of the variable for your map. Available values are: * `temperature`: Temperature 2 metres above ground * `feels_like_temperature`: Feels like temperature * `clouds`: Percentage of sky covered by clouds * `precipitation`: Total precipitation amount accumulated since last hour * `wind_speed`: Wind speed 10 metres above the ground * `wind_gust`: Wind gust speed * `pressure`: Atmospheric pressure at mean sea level * `humidity`: Relative humidity * `wave_height`: Wave height * `wave_period`: Wave period * `sea_temperature`: Sea temperature (available only for +-24 hours) * `air_quality`: Air quality index * `ozone_surface`: Ozone at surface level * `ozone_total`: Total column ozone * `no2`: Nitrogen dioxide at surface level * `pm2.5`: Particulate matter d < 2.5 µm (PM2.5)
datetime(query, required) — There are two ways to specify date and time for your map: 1. Datetime in `YYYY-MM-DDTHH:MM` format and `UTC` timezone, e.g. `2021-08-24T12:00` 2. Offset from current time in `[+-] ` format, e.g. `+10minutes`, `-2hours` or `+1days`
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
GET
/nearest_place
Returns the nearest named location for a given GPS coordinates.
lat(query, required) — Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4
lon(query, required) — Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4
language(query) — The language of text summaries and place names (variable names are never translated). Available languages are: * ``en``: English * ``es``: Spanish * ``fr``: French * ``de``: German * ``pl``: Polish * ``pt``: Portuguese * ``cs``: Czech
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
GET
/point
Returns weather data for a single point (geographic name or GPS)
place_id(query) — Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name).
lat(query) — Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4
lon(query) — Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4
sections(query) — Sections to be included in the response. You can specify more section by separating the values with a comma. The available values are: * ``current``: Current weather situation * ``daily``: Forecasts for each whole day, without the daily parts * ``daily-parts``: Forecasts for each whole day, morning, afternoon and evening * Important: forecast for the morning, afternoon and evening is available only for the first 7 days in the forecast * ``hourly``: Forecasts with hourly resolution * ``minutely``: Precipitation forecast with 1 minute resolution * ``alerts``: The weather alerts * ``all``: All sections
timezone(query) — Timezone to be used for the date fields. If not specified, local timezone of the forecast location will be used. The format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used. Alternatively you may use the value ``auto`` in which case the local timezone of the location is used. The full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).
language(query) — The language of text summaries and place names (variable names are never translated). Available languages are: * ``en``: English * ``es``: Spanish * ``fr``: French * ``de``: German * ``pl``: Polish * ``pt``: Portuguese * ``cs``: Czech
units(query) — Unit system to be used. The available values are: * `auto`: Select the system automatically, based on the forecast location. * `metric`: Metric (SI) units (`°C`, `mm/h`, `m/s`, `cm`, `km`, `hPa`). * `us`: Imperial units (`°F`, `in/h`, `mph`, `in`, `mi`, `Hg`). * `uk`: Same as ``metric``, except that visibility is in `miles` and wind speeds are in `mph`. * `ca`: Same as ``metric``, except that wind speeds are in `km/h` and pressure is in `kPa`.
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
GET
/time_machine
Returns weather data for a single location and given day in the past
place_id(query) — Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name).
lat(query) — Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4
lon(query) — Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4
date(query, required) — The UTC day of the data in the past. Specify in `YYYY-MM-DD` format, e.g. `2021-08-24`.
timezone(query) — Timezone to be used for the date fields. If not specified, local timezone of the location will be used. The format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used. Alternatively you may use the value ``auto`` in which case the local timezone of the location is used. The full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).
units(query) — Unit system to be used. The available values are: * `auto`: Select the system automatically, based on the forecast location. * `metric`: Metric (SI) units (`°C`, `mm/h`, `m/s`, `cm`, `km`, `hPa`). * `us`: Imperial units (`°F`, `in/h`, `mph`, `in`, `mi`, `Hg`). * `uk`: Same as ``metric``, except that visibility is in `miles` and wind speeds are in `mph`. * `ca`: Same as ``metric``, except that wind speeds are in `km/h` and pressure is in `kPa`.
key(query) — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.
7 endpoints auto-detected
Authentication
This API uses an API key, passed in the "X-API-Key" header. No OAuth required.
curl -X GET \
"https://meteosource.com/api/v1/premium/air_quality" \
-H "X-API-Key: YOUR_API_KEY"
