Sign in

v2

latestOpenAPI 3.1.02026-08-0176498.0 KB
Weather maps

Returns PNG weather map for given area and variable

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 <a href="https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection/" rel="nofollow" target="_blank">Google Maps Tile notation</a>.
  2. Specify latitude and longitude bounds of the area you want to cover.

Notes

  • The resulting PNG maps are always in <a href="https://epsg.io/3857" rel="nofollow" target="_blank">Google Mercator projection (EPSG:3857)</a>.
  • 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.
get/map

Query parameters

tile_xinteger

The X coordinate of Google Maps tile

The X coordinate of Google Maps tile

tile_yinteger

The Y coordinate of Google Maps tile

The Y coordinate of Google Maps tile

tile_zoominteger

The zoom level of Google Maps tile

The zoom level of Google Maps tile

min_latstring

Minimal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2

Minimal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2

min_lonstring

Minimal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2

Minimal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2

max_latstring

Maximal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2.

Maximal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2.

max_lonstring

Maximal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2

Maximal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2

variablestring 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)

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)
datetimestring 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 [+-]<minutes|hours|days> format, e.g. +10minutes, -2hours or +1days

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 [+-]<minutes|hours|days> format, e.g. +10minutes, -2hours or +1days
keystring

Your unique API key. You can either specify it in this parameter, or set it in X-API-Key header.

Your unique API key. You can either specify it in this parameter, or set it in X-API-Key header.

Response

Successful Response