---
title: "Returns PNG weather map for given area and variable"
method: GET
path: "/map"
tags: ["Weather maps"]
---

# Returns PNG weather map for given area and variable

`GET /map`

## 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.

## Query parameters

- `tile_x` integer — The X coordinate of Google Maps tile
- `tile_y` integer — The Y coordinate of Google Maps tile
- `tile_zoom` integer — The zoom level of Google Maps tile
- `min_lat` string — Minimal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2
- `min_lon` string — Minimal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2
- `max_lat` string — Maximal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2.
- `max_lon` string — Maximal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2
- `variable` string, 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` string, 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`
- `key` string — Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.

## Response `200`

Successful Response

## Other responses

- `400` — Error in passed parameter.
- `402` — Maximum requests per day limit exceeded.
- `403` — API key not not specified or invalid.
- `422` — Validation Error
- `429` — Maximum requests per minute limit exceeded.

---

[API](https://skmtc.dev/meteosource/apis/interactive-documentation-for-your-premium-plan.md) · [All operations](https://skmtc.dev/meteosource/apis/interactive-documentation-for-your-premium-plan/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteosource/interactive-documentation-for-your-premium-plan/revisions/639d912e4ae5/schema)