Interactive documentation for your Premium plan

Get air quality data Get air quality forecast for a single location (specified either by geographic coordinates or by a place ID).

Search for places You can use this endpoint to obtain `place_id` of the location you want, to be used in the [Weather](#tag/weather) endpoints. The response also contains detailed information about the location, such as coordinates, timezone and the country the place belongs to. Unlike the [Search for places by prefix](#tag/locations/GET/find_places_prefix) endpoint, complete words are required here. You can search for cities, mountains, lakes, countries, ZIP codes, etc. The response can contain multiple places, sorted by relevance. You can then identify the one you want by coordinates, country, or the administrative area.

Search for places by prefix You can use this endpoint to obtain `place_id` of the location you want, to be used in the [Weather](#tag/weather) endpoints. The response also contains detailed information about the location, such as coordinates, timezone and the country the place belongs to. Unlike the [Search for places](#tag/locations/GET/find_places) endpoint, you should only specify the prefix of the place you are looking for. This is particularly useful for autocomplete forms. You can search for cities, mountains, lakes, countries, ZIP codes, etc. The response can contain multiple places, sorted by relevance. You can then identify the one you want by coordinates, country, or the administrative area.

Get PNG weather map Get PNG weather forecast maps for given area and variable ### Area specification There are two ways to specify geographical area you need for your map: 1. Specify `X` and `Y` coordinates and zoom level `Z` of desired tile in Google Maps Tile notation. 2. Specify latitude and longitude bounds of the area you want to cover. ### Notes * The resulting PNG maps are **always** in Google Mercator projection (EPSG:3857). * As Meteosource only covers areas between latitudes 80° and -80°, you can only request maps within these bounds, when specifying the latitude and longitude boundaries. When specifying the area using Google Maps Tile notation, the regions outside our supported latitudes will be fully transparent. * The finest resolution is not available for maps covering very large regions. The resulting map will be automatically downscaled in this case, to guarantee high-speed responses. * Weather maps are only supported for forecasts, not for archive data. ### Color maps Below you will find color maps for each variable that you can use as a legend for your map. You can also download [numerical references](https://www.meteosource.com/static/files/colormaps.zip) for the color maps. **`temperature`** (unit: `°C`) **`feels_like_temperature`** (unit: `°C`) **`clouds`** (unit: `%`) **`precipitation`** (unit: `mm/h`) **`wind_speed`** (unit: `m/s`) **`wind_gust`** (unit: `m/s`) **`pressure`** (unit: `hPa`) **`humidity`** (unit: `%`) **`wave_height`** (unit: `m`) **`wave_period`** (unit: `s`) **`sea_temperature`** (unit: `°C`) **`air_quality`** (unit: `Index`) **`ozone_surface`** (unit: `µg/m³`) **`ozone_total`** (unit: `Dobson`) **`no2`** (unit: `µg/m³`) **`pm2.5`** (unit: `µg/m³`)

Search for nearest place by coordinates You can use this endpoint to find the nearest place from given coordinates. ### Notes * If you specify coordinates of a secluded place (e.g. middle of the ocean), the nearest point can be very far from the coordinates.

Get weather data ## Current weather and forecast for single location ### Sections The endpoint can return multiple sections of data. To obtain the best performance, we advise only requesting the sections you actually need. The available sections are as follows: * Current weather situation * Hourly forecast (for 24/48/96/168 hours, depending on the tier) * Daily forecast (for 7/10/30 days, depending on the tier) * Minutely precipitation forecast (for 60 minutes in the following hour, only for higher tiers) * Weather alerts (only for higher tiers) By default, only the current and hourly sections are returned. The division into daily parts (morning, afternoon and evening) is only available for the first 7 days of the forecast. For details regarding available parameters, see the parameter description below. ### Notes * Variables can be instantaneous, averaged, or accumulated over certain time. For example, `precipitation` forecast provides the precipitation accumulated until the next hour (data with timestamp as `12:00:00` is rain accumulated from `12:00:00` to `13:00:00`). * The detailed description of weather alerts is only available in English. The alert category is translated into selected language.

Get historical weather data Get weather data for a single location (specified either by geographic coordinates or by a place ID) and a given day in the past. ### Sections The response is split into following sections: * `data`: Actual hourly weather records for the requested day, available up to 20 years in the past. * `daily`: Daily summary (average, minimum, and maximum) computed from that same day's hourly records in `data`. * `statistics`: Long-term climate normals for this calendar day (e.g. every August 14th, regardless of year) - typical averages plus all-time record extremes, computed from around 40 years of historical data.