Формат запроса

https://tiles.api-maps.yandex.ru/v1/tiles/
  ? apikey=<string>
  & lang=<string>
  & x=<integer>
  & y=<integer>
  & z=<integer>
  & l=<string>
  & [scale=<float>]
  & [projection=<float>]

Все параметры

Все параметры, кроме scale и projection, являются обязательными.

apikey

Обязательный параметр

Ключ, полученный в Кабинете Разработчика.

Примечание

Ключ будет активирован в течение 15 минут после получения.

Настройка ограничений для API-ключа

lang

Обязательный параметр

Язык надписей на карте.

Формат записи lang=language_region, где:

  • language — двузначный код языка. Указывается в формате ISO 639-1. Задает язык, на котором будут отображаться названия географических объектов.
  • region — двузначный код страны. Указывается в формате ISO 3166-1. Определяет региональные особенности.

Список поддерживаемых значений:

  • ru_RU
  • en_RU
  • en_US
  • uk_UA
  • ru_UA
  • tr_TR

x

Обязательный параметр

Номер тайла по оси X. Как вычислить номер тайла

y

Обязательный параметр

Номер тайла по оси Y. Как вычислить номер тайла

z

Обязательный параметр

Уровень масштабирования карты. Доступные значения: от 0 до 20.

l

Обязательный параметр

Тип подложки карты. Параметр может принимать только одно значение map

scale

Коэффициент для увеличения или уменьшения изображения тайла. Параметр может принимать дробные значения от 0.1 до 4.0:

  • если scale меньше 1.0 – изображение уменьшится;
  • если scale больше 1.0 – изображение увеличится.

Если указать значение вне допустимого диапазона, сервер вернет ошибку.

Параметр scale влияет как на размер тайла, так и на размер самих объектов на карте (надписей, домов, дорог и др.). Например, при scale=2.0 тайл будет размером 512х512 пикселей и все объекты карты будут отображены более крупно.

Этот параметр рекомендуется использовать при отображении карты на экранах с высоким разрешением.

projection

Для какой проекции нужно получать тайлы. Доступные значения:

  • wgs84_mercator (по умолчанию) – получить тайлы для эллиптической проекции Меркатора (WGS 84);
  • web_mercator – получить тайлы для сферической проекции Меркатора (Web Mercator).
Предыдущая
Быстрый старт
Следующая
Формат ответа