Основные понятия

Разработка приложений для мобильных устройств

Google Maps JavaScript API разработан для быстрой загрузки и хорошей совместимости с мобильными устройствами. При создании этого API особое внимание было уделено разработке для современных мобильных устройств на платформах Android и iOS. Размер экрана мобильных устройств меньше, чем размер окна браузера на компьютере. Кроме того, мобильные устройства имеют свои специфические способы управления (например, "раздвинуть" экран пальцами для увеличения). Если вы хотите, чтобы ваше приложение хорошо работало на мобильных устройствах, мы рекомендуем следующее:

Для атрибутов ширины и высоты элемента <div>, содержащего карту, установите значение 100%. Однако следует отметить, что при этих значениях в некоторых старых браузерах для настольных ПК карты могут отображаться не самым оптимальным образом.
Вы можете определить устройства iPhone и Android, проверив значение свойства navigator.userAgent в DOM:
```
function detectBrowser() {
  var useragent = navigator.userAgent;
  var mapdiv = document.getElementById("map");

  if (useragent.indexOf('iPhone') != -1 || useragent.indexOf('Android') != -1 ) {
    mapdiv.style.width = '100%';
    mapdiv.style.height = '100%';
  } else {
    mapdiv.style.width = '600px';
    mapdiv.style.height = '800px';
  }
}
```
Эта проверка позволяет настроить макет экрана приложения для разных устройств, как это было сделано в вышеприведенном примере, где мы изменяем размер экрана для каждого устройства.
Устройства Android и iOS поддерживают следующий тег <meta>:
```
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
```
Этот параметр указывает, что карта должна отображаться во весь экран, а ее размеры не могут быть изменены пользователем. Браузер Safari в смартфонах iPhone требует, чтобы этот тег <meta> был включен в элемент <head> на странице.

Дополнительную информацию по разработке для iPhone можно найти в документации для разработчиков Apple. Дополнительную информацию по разработке для Android можно найти в документации для разработчиков Android.

Локализация

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

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

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

Например, чтобы приложение Maps API отображалось на японском языке, нужно добавить тег &language=ja в тег <script>, как показано ниже:

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

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

Просмотр примера (map-language.html)

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

Просмотр примера (map-rtl.html)

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

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

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

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

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

Для использования приложения с Maps API, локализованного для Великобритании, нужно добавить код &region=GB в тег <script>, как показано ниже:

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

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

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

Обслуживание Google Maps 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"
type="text/javascript">
</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"
type="text/javascript">
</script>

Определение версии

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