Локализация карты
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">