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

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

  • с помощью параметра 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 пикселов.

Область показа 0.002x0.002 градуса

https://static-maps.yandex.ru/v1?lang=ru_RU&ll=28.98513,41.036943&spn=0.002,0.002&size=300,300&apikey=YOUR_API_KEY

Область показа 0.3x0.3 градуса

https://static-maps.yandex.ru/v1?lang=ru_RU&ll=28.98513,41.036943&spn=0.3,0.3&size=300,300&apikey=YOUR_API_KEY

Область показа 10х10 градусов

https://static-maps.yandex.ru/v1?lang=ru_RU&ll=28.98513,41.036943&spn=10,10&size=300,300&apikey=YOUR_API_KEY