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

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

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

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

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

Параметр bbox

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

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

Пример

https://static-maps.yandex.ru/1.x/?l=map&bbox=36.6,54.6~38.6,56.6

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

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

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

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

Примеры

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

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

https://static-maps.yandex.ru/1.x/?ll=37.620070,55.753630&spn=0.002,0.002&size=300,300&l=map

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

https://static-maps.yandex.ru/1.x/?ll=37.620070,55.753630&spn=0.3,0.3&size=300,300&l=map

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

https://static-maps.yandex.ru/1.x/?ll=37.620070,55.753630&spn=10,10&size=300,300&l=map