Все готово!

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

Активация Google Maps JavaScript API

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активация Google Maps JavaScript API и связанных служб
  3. Создание соответствующих ключей

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

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

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

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

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

Следующий пример показывает карту на японском с установкой региона "Япония":

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

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

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

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

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

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

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

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

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

При загрузке Google Maps JavaScript API из maps.googleapis.com по умолчанию используются региональные настройки для США. Если вы хотите изменить свое приложение так, чтобы в нем отображались другие листы карты или результаты геокодирования, соответствующие другому региону, вы можете изменить поведение по умолчанию, добавив параметр region в тег <script> при загрузке кода Maps JavaScript API.

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

Параметр region поддерживает идентификаторы подтегов region в формате Unicode, которые обычно полностью соответствуют доменам верхнего уровня (ccTLD) соответствующих стран. Большинство идентификаторов регионов в формате Unicode совпадают с кодами ISO 3166-1, однако имеются некоторые исключения. Например, для Великобритании используются домен верхнего уровня "uk" (доменное имя .co.uk) и идентификатор региона "GB."

Например, следующий сценарий локализует карту для Великобритании:

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

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

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

Загрузка API в Китае

Интерфейс Google Maps JavaScript API в Китае предоставляется с сайта http://maps.google.cn. При обслуживании китайского контента следует заменить https://maps.googleapis.com на http://maps.google.cn. Например:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

Если ваше приложение ориентировано именно на пользователей из Китая, вы должны добавить в него параметры региона и языка. API поддерживает использование для параметра language значений zh-CN и zh-TW.

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

Оставить отзыв о...

Текущей странице
Google Maps JavaScript API
Google Maps JavaScript API
Нужна помощь? Обратитесь в службу поддержки.