Обзор 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

Долгота и широта центра карты в градусах, см. Центр карты.

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

Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте.

Описание фигуры содержит координаты ее вершин, а также сведения о цвете и толщине линии и цвете заливки (для многоугольников). Описания фигур перечисляются через тильду (~).

Подробнее см. Линии и многоугольники

langstring (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. Данное обозначение поддерживается в целях сохранения обратной совместимости, но не рекомендуется к использованию.

key

base64

Ключ Яндекс.Карт.