Локализация карты

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Локализация региона

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

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

Параметр region принимает идентификаторы вложенных тегов региона Unicode , которые (как правило) однозначно соотносятся с доменами верхнего уровня (нДВУ) с кодом страны. Большинство идентификаторов регионов 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&region=GB&callback=initMap">
</script>

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

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

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

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

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