Documentation

Map zoom level

The zoom level determines the current resolution of the image from the map. In the Static API, the zoom level is set by the z parameter, which can take whole values from 0 to 17. At the zero zoom level, the map shows the entire world, while at the maximum zoom level, it shows a single building.

When the zoom level is increased by a single level, the image resolution doubles; for more information, see Coordinates and projections.

Note. If the request specifies a viewport (the spn parameter), the zoom level is ignored.
Attention! Not all zoom levels are available in all areas of the map. If the requested zoom level is not available for the selected area, the map will not be returned.

The example below is a request for a map image with zoom level 12, centered on Sultanahmet Camii:

https://static-maps.yandex.ru/1.x/?lang=en_US&ll=28.97709,41.005233&z=12 \
&size=450,450&l=map

The following example is a request for the same map, but with the maximum zoom level (17):

https://static-maps.yandex.ru/1.x/?lang=en_US&ll=28.97709,41.005233&z=17&size=450,450&l=map

zoom level URL parametersspn URL parametersz