Map localization

The API lets you display maps that are localized in various languages with allowances for the differences in specific countries.
For example, you can display a map with labels in English and indicate distances in miles.

To set a language for the map, pass the lang parameter when connecting the API:

lang=language_region

  • language — Two-letter language code. Specified in ISO 639-1 format. Sets the language for objects on the map (toponyms and controls).

  • region — Two-letter country code. Specified in ISO 3166-1 format. Determines regional settings, such as measurement units (for indicating distances between objects or driving speeds on a route).

    Note.

    For the regions RU, UA, and TR, distance is shown in kilometers. For US, distance is shown in miles.

The following locales are currently supported:

  • lang=ru_RU
  • lang=ru_UA
  • lang=uk_UA
  • lang=tr_TR
  • lang=en_RU
  • lang=en_US
  • lang=he_IL
  • lang=en_IL

Example of loading a map in English:

<script src="https://api-maps.yandex.ru/v3/?apikey=YOUR_API_KEY&lang=en_US"/>
Previous
Map customization
Next
Objects on the map