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 using the z parameter that can take integer values from 0 to 21. 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 one, the image resolution doubles. For more information, see Background theory.

Note

If the request specifies a viewport, the zoom level is ignored.

Warning

Not all zoom levels are available in all areas of the map. If the requested zoom level is unavailable for the selected area, the map will not be returned.

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

https://static-maps.yandex.ru/v1?lang=en_US&ll=28.97709,41.005233&z=12&size=450,450&apikey=YOUR_API_KEY

Previous