Локализуйте карту

Вы можете настроить карту для конкретной страны или региона следующими способами:

  • Измените языковые настройки по умолчанию.
  • Укажите код региона, который изменяет поведение карты в зависимости от конкретной страны или территории.

локализация языка

По умолчанию API JavaScript для работы с картами использует языковые настройки пользователя, указанные в браузере, при отображении текстовой информации, такой как названия элементов управления, уведомления об авторских правах, маршруты движения и подписи на картах. В большинстве случаев предпочтительнее учитывать языковые настройки браузера. Однако, если вы хотите, чтобы API JavaScript для работы с картами игнорировал языковые настройки браузера, вы можете принудительно отображать информацию на определенном языке, добавив параметр language в тег <script> при загрузке кода API JavaScript для работы с картами.

Параметр language влияет на названия элементов управления, уведомления об авторских правах, маршруты движения и метки элементов управления, а также на ответы на запросы к сервисам. Влияние на сервисы не столь очевидно. Например, при геокодировании адресов на уровне улиц название страны возвращается на запрошенном вами языке, но остальная часть адреса будет соответствовать местоположению, которое вы геокодируете. С другой стороны, почтовые и политические результаты возвращаются на запрошенном языке. Попробуйте эту демонстрацию , чтобы поэкспериментировать с изменениями на карте при обновлении параметра language .

В следующем примере отображается карта на японском языке, а в качестве региона указана Япония:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

Посмотреть пример .

Если вы задаёте язык карты, важно также указать регион . Это поможет гарантировать соответствие вашего приложения местным законам.

Примечание: При загрузке API описанным выше способом карта будет отображать японский язык для всех пользователей независимо от их предпочтений. Убедитесь, что вы хотите именно такого поведения, прежде чем устанавливать этот параметр.

API JavaScript для работы с картами также поддерживает двунаправленный текст (Bidi), содержащий символы как для языков с направлением письма слева направо (LTR), так и для языков с направлением письма справа налево (RTL). Примеры языков RTL включают арабский, иврит и фарси. Как правило, для корректного отображения страниц на языках RTL следует добавлять dir='rtl' к элементу <html> страницы. В следующем примере отображается карта Каира, Египет, с использованием арабских элементов управления:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

Посмотреть пример

См. список поддерживаемых языков . Обратите внимание, что новые языки добавляются часто, поэтому этот список может быть неполным.

Региональная локализация

Добавьте параметр region к тегу <script> при загрузке кода JavaScript API карт, если вы хотите изменить свое приложение для отображения различных фрагментов карты или сместить акцент в работе приложения (например, сместить результаты геокодирования в сторону определенного региона).

Разработчикам приложений, использующих Maps JavaScript API, рекомендуется всегда указывать region , поскольку различные сервисы (например, Places Autocomplete) обычно показывают лучшие результаты при указании region . Также вы несете ответственность за соответствие вашего приложения местным законам, обеспечивая применение правильной региональной локализации для страны, в которой размещено приложение.

Параметр region принимает идентификаторы субтегов регионов Unicode, которые (как правило) имеют однозначное соответствие доменам верхнего уровня с кодом страны (ccTLD). Большинство идентификаторов регионов Unicode идентичны кодам ISO 3166-1 alpha-2, за некоторыми заметными исключениями. Например, ccTLD Великобритании — «uk» (соответствует домену .co.uk ), а идентификатор региона — «GB». См. подробную информацию о поддерживаемых регионах в разделе «Подробности покрытия платформы Google Maps» . Попробуйте эту демонстрацию , чтобы поэкспериментировать с изменениями на карте при обновлении параметра region .

Например, следующий тег скрипта локализует карту на территорию Соединенного Королевства:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=GB&callback=initMap">
</script>

В следующих примерах показаны две карты: одна из них отображает географические координаты «Толедо» на основе region , заданного как US (US), как «Толедо, Огайо», а другая искажает результаты на основе region , заданного как Испания ( ES ), как «Толедо, Испания».

Посмотрите пример США и пример Испании .

Демонстрация локализации

При настройке языка карты важно также указать регион. Вот демонстрационный пример, который позволяет загрузить карту с выбранным вами языком и регионом.

Просмотрите эту демонстрацию в полноэкранном режиме .