---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/dg/concepts/localization.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/localization.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt

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

<!--    <p>Для того, чтобы определить язык названий геообъектов на карте, необходимо в запросе передать локаль. Локаль - это набор параметров, таких как язык пользователя, страна и установленные в ней стандарты.</p>
    <p>Локаль задается параметром lang: <codeblock copy="yes" wrap="yes" translate="no">lang=language-region</codeblock></p>
    <p><ul>
        <li><parmname>language</parmname> - двухзначный код языка. Определяет язык интерфейса карты (кнопок на карте, подсказок и других элементов карты). Указывается в формате <xref format="html" href="http://www.loc.gov/standards/iso639-2/php/code_list.php" scope="external">ISO 639-1</xref>. </li>
        <li><parmname>region</parmname> - двухзначный код страны. Определяет подложку карты, то есть язык топонимов, а также систему мер, представление даты и времени для соответствущей страны. Указывается в формате <xref format="html" href="http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm" scope="external">ISO 3166-1-alpha-2 code elements</xref>.</li>
      </ul></p>-->

API позволяет отображать карты, локализованные на различных языках с учетом специфики отдельных стран. Например, можно показать карту с надписями на английском языке и обозначить на ней расстояния в милях (инструмент [Линейка](https://yandex.ru/dev/maps/jsapi/doc/2.1/dg/concepts/controls.html#standard-controls__ruler)).

Чтобы задать для карты язык, необходимо при подключении API передать параметр `lang`:

```httpget
lang=language_region
```

- `language` — двузначный код языка. Указывается в формате [ISO 639-1](https://ru.wikipedia.org/wiki/ISO_639-1). Задает язык объектов на карте (топонимов, элементов управления).
- `region` — двузначный код страны. Указывается в формате [ISO 3166-1](https://ru.wikipedia.org/wiki/ISO_3166-1). Определяет региональные особенности, например единицу измерения (для обозначения расстояния между объектами или скорости движения по маршруту).
    
    {% note info %}
    
    Для регионов `RU`, `UA` и `TR` расстояние показывается в километрах, для `US` — в милях.
    
    {% endnote %}

На данный момент поддерживаются следующие локали:
- `lang=ru_RU`;
- `lang=en_US`;
- `lang=en_RU`;
- `lang=ru_UA`;
- `lang=uk_UA`;
- `lang=tr_TR`.


{% note info %}

В ранних версиях API локаль указывалась через дефис. Например, `ru-RU`. Данное обозначение поддерживается в целях сохранения обратной совместимости, но не рекомендуется к использованию.

{% endnote %}


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


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



![](../_images/en_map.png)