Обзор Static API

Static API формирует изображение карты в соответствии со значениями параметров, передаваемых сервису в URL следующего формата:

https://static-maps.yandex.ru/1.x/?{параметры URL}

Строка {параметры URL} представляет собой последовательность пар вида {имя параметра}={значение параметра}, разделенных символом амперсанда (&).

Ниже приведен пример запроса изображения карты центра Москвы с двумя пронумерованными метками:

https://static-maps.yandex.ru/1.x/?ll=37.620070,55.753630&size=450,450&z=13&l=map&pt=37.620070,55.753630,pmwtm1~37.64,55.76363,pmwtm99

Ниже приводится полный список параметров URL.


Параметр	Тип данных и пример	Описание
Обязательные параметры
l	`string,[string]...` `l=sat,skl`	Перечень слоев, определяющих тип карты: map (схема), sat (спутник) и sat,skl (гибрид). Подробнее см. Слои и типы карты.
ll	`float,float` `ll=37.620070,55.753630`	Долгота и широта центра карты в градусах, см. Центр карты.
key	`string` `248120a9-95c1-65b2-8876-fdd3b462ff8d`	API-ключ для коммерческой версии Static API. Необходимо указывать при использовании коммерческой версии.
Необязательные параметры
spn	`float` `spn=0.01,0.01`	Протяженность области показа карты по долготе и широте (в градусах), см. Область показа.
z	`integer` `z=10`	Уровень масштабирования карты (0-17), см. Уровень масштабирования карты.
size	`integer,integer` `size=450,450`	Ширина и высота запрашиваемого изображения карты (в пикселах), см. Размер карты. По умолчанию принимает значение 450x450.
scale	`float` (от 1.0 до 4.0) `scale=2.0`	Коэффициент увеличения объектов на карте. Может принимать дробное значение от 1.0 до 4.0. Подробнее см. в разделе Увеличение объектов на карте.
pt	`string (ОписаниеМетки1~ОписаниеМетки2~...)` `pt=37.620070,55.753630,pmwtm1`	Содержит описание одной или нескольких меток, которые требуется отобразить на карте. Описание каждой метки содержит ее координаты (долготу и широту), а также сведения о ее внешнем виде (включая стиль, цвет, размер и текст метки). Описания меток перечисляются через тильду (~). Подробнее см. Метки.
pl	`string (ОписаниеФигуры1~ОписаниеФигуры2~...)` `pl=c:ec473fFF,f:00FF00A0,w:5,37.51,55.83,37.67,55.82,37.66,55.74,37.49,55.70,37.51,55.83` `pl=c:ff0000ff,w:3,80peAuGUQQMIUgAAAAAAAAAAAAAQJwAA`	Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте. Описание фигуры содержит координаты ее вершин, в формате "Долгота1,Широта2, ... ,ДолготаN,ШиротаN" или `Base64`, а также сведения о цвете и толщине линии и цвете заливки (для многоугольников). Описания фигур перечисляются через тильду (~). Подробнее см. Линии и многоугольники
lang	`string (language_region)` `lang=tr_TR`	API позволяет отображать карты, локализованные на различных языках с учетом специфики отдельных стран. Например, можно показать карту с надписями на английском языке и обозначить на ней расстояния в милях (инструмент Линейка). `lang=language_region` language — двузначный код языка. Указывается в формате ISO 639-1. Задает язык объектов на карте (топонимов, элементов управления). region — двузначный код страны. Указывается в формате ISO 3166-1. Определяет региональные особенности, например единицу измерения (для обозначения расстояния между объектами или скорости движения по маршруту). Примечание. Для регионов `RU`, `UA` и `TR` расстояние показывается в километрах, для `US` — в милях. На данный момент поддерживаются следующие локали: `lang=ru_RU`; `lang=en_US`; `lang=en_RU`; `lang=ru_UA`; `lang=uk_UA`; `lang=tr_TR`. Примечание. В ранних версиях API локаль указывалась через дефис. Например, `ru-RU`. Данное обозначение поддерживается в целях сохранения обратной совместимости, но не рекомендуется к использованию.


Параметр	Тип данных и пример	Описание
Обязательные параметры
l	`string,[string]...` `l=sat,skl`	Перечень слоев, определяющих тип карты: map (схема), sat (спутник) и sat,skl (гибрид). Подробнее см. Слои и типы карты.
ll	`float,float` `ll=37.620070,55.753630`	Долгота и широта центра карты в градусах, см. Центр карты.
key	`string` `248120a9-95c1-65b2-8876-fdd3b462ff8d`	API-ключ для коммерческой версии Static API. Необходимо указывать при использовании коммерческой версии.
Необязательные параметры
spn	`float` `spn=0.01,0.01`	Протяженность области показа карты по долготе и широте (в градусах), см. Область показа.
z	`integer` `z=10`	Уровень масштабирования карты (0-17), см. Уровень масштабирования карты.
size	`integer,integer` `size=450,450`	Ширина и высота запрашиваемого изображения карты (в пикселах), см. Размер карты. По умолчанию принимает значение 450x450.
scale	`float` (от 1.0 до 4.0) `scale=2.0`	Коэффициент увеличения объектов на карте. Может принимать дробное значение от 1.0 до 4.0. Подробнее см. в разделе Увеличение объектов на карте.
pt	`string (ОписаниеМетки1~ОписаниеМетки2~...)` `pt=37.620070,55.753630,pmwtm1`	Содержит описание одной или нескольких меток, которые требуется отобразить на карте. Описание каждой метки содержит ее координаты (долготу и широту), а также сведения о ее внешнем виде (включая стиль, цвет, размер и текст метки). Описания меток перечисляются через тильду (~). Подробнее см. Метки.
pl	`string (ОписаниеФигуры1~ОписаниеФигуры2~...)` `pl=c:ec473fFF,f:00FF00A0,w:5,37.51,55.83,37.67,55.82,37.66,55.74,37.49,55.70,37.51,55.83` `pl=c:ff0000ff,w:3,80peAuGUQQMIUgAAAAAAAAAAAAAQJwAA`	Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте. Описание фигуры содержит координаты ее вершин, в формате "Долгота1,Широта2, ... ,ДолготаN,ШиротаN" или `Base64`, а также сведения о цвете и толщине линии и цвете заливки (для многоугольников). Описания фигур перечисляются через тильду (~). Подробнее см. Линии и многоугольники
lang	`string (language_region)` `lang=tr_TR`	API позволяет отображать карты, локализованные на различных языках с учетом специфики отдельных стран. Например, можно показать карту с надписями на английском языке и обозначить на ней расстояния в милях (инструмент Линейка). `lang=language_region` language — двузначный код языка. Указывается в формате ISO 639-1. Задает язык объектов на карте (топонимов, элементов управления). region — двузначный код страны. Указывается в формате ISO 3166-1. Определяет региональные особенности, например единицу измерения (для обозначения расстояния между объектами или скорости движения по маршруту). Примечание. Для регионов `RU`, `UA` и `TR` расстояние показывается в километрах, для `US` — в милях. На данный момент поддерживаются следующие локали: `lang=ru_RU`; `lang=en_US`; `lang=en_RU`; `lang=ru_UA`; `lang=uk_UA`; `lang=tr_TR`. Примечание. В ранних версиях API локаль указывалась через дефис. Например, `ru-RU`. Данное обозначение поддерживается в целях сохранения обратной совместимости, но не рекомендуется к использованию.

Коммерческая версия

Для Static API доступна коммерческая версия. Эту версию следует использовать если ваш проект нарушает хотя бы одно из условий использования.

Для коммерческой версии API используйте URL следующего формата:

https://enterprise.static-maps.yandex.ru/1.x/?key=ваш API-ключ&{параметры URL}

Коммерческую версию Static API можно приобрести в Кабинете разработчика.

Примечание. В платной версии Static API доступна только подложка «схема». Это связано с тем, что лицензионные ограничения провайдеров данных не позволяют использовать спутниковые подложки в сторонних коммерческих проектах.