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

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

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

Пример загрузки карты на английском языке:

<script src="https://api-maps.yandex.ru/2.1/?apikey=ваш API-ключ&lang=en_US" type="text/javascript">

Предыдущая