Documentation

Map localization

The Static.API lets you make localized map images with labels in different languages. To set the language for geo object names on a map, you need to pass the locale in the HTTP request.

The locale is set in RFC-3066 format using the lang parameter:

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, it is shown in miles.

The following locales are currently supported:

  • lang=tr-TR
  • lang=en-US (distance in miles)
  • lang=en_RU
  • lang=ru-RU
  • lang=ru_UA
  • lang=uk_UA

Note. In early versions of the API, the locale was specified after a dash. This notation is no longer recommended for use, but for 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.

Note. Turkish on geo object labels is currently supported only for maps of Turkey.

The example below shows the map of Moscow with labels in Russian:

https://static-maps.yandex.ru/1.x/?lang=ru_RU&l=map&ll=37.620070,55.753630&z=10