Документация
Справочник JavaScript API
2.1.41 (текущая версия)
collection
interactivityModel
Интерфейсы
2.1.42 (релиз-кандидат)
collection
interactivityModel
Интерфейсы

Локализация карты

API позволяет отображать карты, локализованные на различных языках с учётом специфики отдельных стран. Для того чтобы управлять локализацией, необходимо в HTTP-запросе передать локаль.

Локаль задается параметром lang:

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, tr-TR, en-US и uk-UA считаются эквивалентными ru_RU, tr_TR, en_US, uk_UA соответственно.

Ниже приведен пример карты Москвы с надписями на английском языке: