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

# Map localization

The API allows you to display maps that are localized in different languages, with consideration for the specifics of different countries. To control localization, you must pass the locale in the HTTP request.

The locale is set in the `lang` parameter:

```
lang=language_region
```

- `language` — Two-letter language code. Specified in [ISO 639-1](http://www.loc.gov/standards/iso639-2/php/code_list.php) format.
- `region` — Two-letter country code. Specified in [ISO 3166-1](http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm) format.

At this time, the following locales are supported:
- `lang=tr-TR`
- `lang=en-US`
- `lang=ru-RU`
- `lang=ru_UA`
- `lang=uk_UA`


{% note info %}

In early versions of the API, the locale was specified using a hyphen. This notation is no longer recommended. However, to preserve backward compatibility, the locales `ru-RU`, `tr-TR`, `en-US` and `uk-UA` are considered equivalent to `ru_RU`, `tr_TR`, `en_US`, and `uk_UA`, respectively.

{% endnote %}

![](http://static-maps.yandex.ru/1.x/?lang=ru_RU&l=map&ll=37.620070,55.753630&z=10)