Область показа

Область показа карты может быть задана двумя способами:

с помощью параметра bbox;
через параметры ll+spn.

Static API подбирает уровень масштабирования таким образом, чтобы заданный участок был виден на изображении целиком.

Если параметры bbox или ll+spn не заданы и, при этом, явно не указан уровень масштабирования (параметр z), то Static API попытается установить пропущенные параметры автоматически.

Параметр bbox

В параметре bbox задаются географические координаты углов прямоугольника, ограничивающего область просмотра. Указываются координаты левого нижнего и правого верхнего углов (в последовательности «долгота, широта»).

Примечание

При одновременном задании bbox и ll+spn параметр bbox является более приоритетным.

https://static-maps.yandex.ru/v1?bbox=29.0,40.2~29.1,41.9&lang=ru_RU&apikey=YOUR_API_KEY

Параметры ll+spn

Через параметры ll+spn задается протяженность области показа относительно центра карты.

Параметр ll задает долготу и широту центра карты (в градусах), а spn — ее протяженность (в градусах). Протяженность области задается двумя числами, первое из которых есть разница между максимальной и минимальной долготой, а второе — между максимальной и минимальной широтой данной области.

Примечание

При одновременном задании bbox и ll+spn параметр bbox является более приоритетным.

Ниже приведены примеры запросов изображения карты, отличающиеся друг от друга только размерами области показа (0.002x0.002, 0.3x0.3 и 10x10 градусов). Центром запрашиваемого фрагмента карты является Taksim Meydanı в Стамбуле, размеры карты 300х300 пикселов.