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

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

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

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

По умолчанию 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 необходимо добавить 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> при загрузке кода Maps JavaScript API, если вы хотите изменить свое приложение для обслуживания различных фрагментов карты или сместить приложение (например, сместить результаты геокодирования в сторону региона).

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

Параметр region принимает идентификаторы вложенных тегов региона Юникода , которые (как правило) имеют однозначное сопоставление с доменами верхнего уровня с кодом страны (ccTLD). Большинство идентификаторов регионов Unicode идентичны кодам ISO 3166-1 Alpha-2, за некоторыми заметными исключениями. Например, нДВУ Великобритании — «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 (США), на «Толедо, Огайо», а другая смещает результаты на основе region , установленного для ES (Испания), на «Толедо, Испания». "

Посмотрите пример США и пример ЕС .

Демо-версия локализации

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

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