Часто задаваемые вопросы о платформе Google Карт

Начало работы

Вопросы об условиях использования

Тарификация и лимиты на использование

Использование платформы Google Карт

Ошибки и устранение неполадок

Сервисы платформы Google Карт

Maps JavaScript API

Google Maps SDK для iOS

Google Maps SDK для Android

Подпись URL

Начало работы

Что такое платформа Google Карт?

Платформа Google Карт – это набор API и SDK, которые позволяют разработчикам встраивать карты Google в мобильные приложения и веб-страницы, а также получать из них данные. Есть несколько вариантов. В зависимости от ваших потребностей можно использовать один или несколько из перечисленных ниже API и SDK.

Maps:

Routes:

Places:

Как начать работу с платформой Google Карт?

Прочитайте статью о начале работы с платформой Google Карт.

Какие API мне нужны?

Инструмент выбора API поможет определить наиболее подходящий вариант с учетом ваших требований.

Как начать работу с API на своем сайте?

Изучите обзорное руководство, руководство для разработчика и руководство по началу работы для конкретных API или SDK, которые вас интересуют. Например, можно посмотреть руководства по Maps SDK для Android или Maps JavaScript API.

Какие страны охватывает платформа Google Карт?

Команда Google Карт постоянно обрабатывает новые картографические данные и добавляет карты новых стран. Актуальная информация о покрытии карт доступна на этой странице (данные можно отфильтровать с помощью окна поиска над таблицей). Обратите внимание, что покрытие может измениться в случае изменения лицензионных соглашений с поставщиками данных.

См. также:

Можно ли разместить Google Карты на своем сайте, не используя продукты платформы Google Карт?

Да. Google Карты теперь позволяют встраивать карты в сайт или блог без навыков программирования или использования платформы Google Карт. Более подробную информацию можно найти здесь.

Как интегрировать Google Карты в приложения для мобильных устройств?

Чтобы добавить карты в приложение для Android, воспользуйтесь Maps SDK для Android.

Чтобы добавить карты в нативное приложение для iOS, воспользуйтесь Maps SDK для iOS.

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

Для устройств, которые не поддерживают Maps JavaScript API, подойдет Maps Static API – в нем используются карты в виде статичных изображений GIF, JPG и PNG с маркерами и полилиниями. Обратите внимание, что при использовании Maps Static API вне браузерных приложений изображение карты необходимо связывать с Google Картами.

Какие веб-браузеры поддерживает Maps JavaScript API и Maps Embed API?

Maps JavaScript API и Maps Embed API поддерживают следующие браузеры:

Компьютер
  • Текущая версия Microsoft Edge (Windows), кроме режима IE.
  • Две последние основные и стабильные версии Firefox (Windows, macOS, Linux).
  • Две последние основные и стабильные версии Chrome (Windows, macOS, Linux).
  • Две последние основные и стабильные версии Safari (macOS).
Android
  • Текущая версия Chrome на Android 4.1+.
  • Chrome WebView на Android 4.4+.
iOS
  • Мобильная версия Safari для текущей и предыдущей основной версии iOS.
  • UIWebView и WKWebView для текущей и предыдущей основной версии iOS.
  • Текущая версия Chrome для iOS.
Можно ли распечатывать карты из Maps JavaScript API?

Печать из Maps JavaScript API не поддерживается. Это связано с тем, что в наиболее распространенных браузерах поддержка печати реализована по-разному.

Как узнавать об изменениях в продуктах платформы Google Карт?

Чтобы быть в курсе новостей обо всех географических продуктах Google для разработчиков, подпишитесь на блог платформы Google Карт.

Как связаться со службой технической поддержки?

Информацию о доступных вариантах поддержки можно найти в этой статье.

В какое время работает служба технической поддержки?
Служба поддержки решает проблемы с недоступностью сервисов круглосуточно 5 дней в неделю (с 9:00 понедельника по времени Токио до 17:00 пятницы по тихоокеанскому времени), кроме региональных праздничных дней.
Как восстановить доступ к аккаунту Google?

При потере доступа к аккаунту Google (например, ivan@mycompany.com или ivan@gmail.com) вы можете восстановить его, получив или сбросив пароль. Изучите статью Как восстановить доступ к Gmail или аккаунту Google.

Как восстановить доступ к проекту?

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

Если у вас есть доступ к проектам, связанным с аккаунтом Google:

Если у вас нет доступа к аккаунту Google, связанному с проектом:

Можно ли использовать Maps SDK и Places SDK для iOS на компьютерах Mac с ARM-процессором?

Разработка на новых компьютерах Mac с ARM-процессором возможна, но сборка и запуск приложения должны выполняться на физическом устройстве iOS. Это временное ограничение, в будущем возможности разработки на симуляторах будут расширены.

Вопросы об условиях использования

Каковы условия использования продуктов платформы Google Карт?

С Условиями использования платформы Google Карт можно ознакомиться здесь:

https://cloud.google.com/maps-platform/terms

Соответствует ли мой сайт Условиям использования платформы Google Карт?

Вы можете использовать платформу Google Карт в своих приложениях, если ваш сайт соответствует этим Условиям использования.

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

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

Есть ли прямой доступ к фрагментам карты и спутниковым снимкам?

Нет, доступ к фрагментам карты и спутниковым снимкам возможен только через платформу Google Карт. То есть ваш собственный картографический API или скрипт, загружающий фрагменты карты, не сможет получать данные. Доступ приложения к фрагментам карты в обход платформы Google Карт будет блокироваться. Более подробную информацию можно найти в Условиях использования платформы Google Карт.

Можно ли использовать продукты платформы Google Карт в приложениях для отслеживания местоположения?

Если приложение соответствует Условиям использования платформы Google Карт, то ограничений на показ данных (отслеживание местоположения) в реальном времени с помощью продуктов платформы Google Карт нет.

Можно ли использовать Google Карты в автономных приложениях без веб-доступа?

Да, продукты платформы Google Карт теперь можно использовать для автономных приложений, если эти приложения соответствуют Условиям использования платформы Google Карт.

Maps JavaScript API поддерживает только указанные в этом списке браузеры.

Можно ли использовать продукты платформы Google Карт на сайте, защищенном паролем?

Да, сервисы Maps, Routes и Places от Google можно использовать в приложениях с закрытым доступом. Более подробную информацию можно найти в Условиях использования платформы Google Карт.

Можно ли создать приложение, содержащее данные платформы Google Карт в виде документа?

Если ваше приложение создает документ (в электронном или бумажном виде), он не должен содержать данные из платформы Google Карт, включая изображения. Подробная информация приведена в разделе о запрете извлечения данных в Условиях использования платформы Google Карт.

Как отказаться от показа своего контента в результатах поиска Google?

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

Чтобы запретить показ своего сайта или определенной его страницы в результатах поиска Google, следуйте инструкциям в нашем Справочном центре для веб-мастеров.

Можно ли создавать изображения с помощью Maps Static API, а затем сохранять их на своем сайте для показа пользователям?

Нет, если на веб-странице содержится статичное изображение карты, оно должно загружаться непосредственно из Maps Static API. Адрес можно указать в атрибуте src HTML-тега img или в CSS-атрибуте background-image HTML-тега div.

Тарификация и лимиты на использование

Как настроить платежные функции для проекта?
Подробнее о начале работы с платформой Google Карт
Как клиенты с бесплатным планом Google Cloud Platform могут перейти на платный аккаунт?
В рамках программы бесплатного плана Google Cloud Platform мы предоставляем клиентам кредит в размере 300 долл. США для пробного использования любого из сервисов Google Cloud Platform (GCP), включая API платформы Google Карт. Чтобы продолжать пользоваться этими сервисами по завершении периода бесплатного использования, вам нужно перейти на платный аккаунт. Для этого войдите в Cloud Console.
Существуют ли лимиты на использование платформы Google Карт?

Для продуктов платформы Google Карт не существует лимитов на использование в течение дня или на количество запросов. Ограничивается только максимальное количество запросов в секунду или в минуту.

Для матрицы расстояний задано ограничение по количеству событий в секунду. Это сумма запросов со стороны клиента и сервера.

Для Routes: Compute Route Matrix задано ограничение по количеству элементов в минуту. Количество элементов в запросе рассчитывается как количество пунктов отправление, умноженное на количество пунктов назначения.

В таблице ниже приведены лимиты на использование каждого API.

API Лимит на использование
Проверка адресов 6000 запросов в минуту
Directions 50
Distance Matrix 1000 событий в секунду
Dynamic Maps 500 запросов в секунду
Elevation 100
Geocoding 50
Geolocation 100 запросов в секунду
Places 100
Roads 500 запросов в секунду
Routes: Compute Routes 3000 запросов в минуту
Routes: Compute Route Matrix 3000 элементов в минуту
Static Maps 500
Street View Image API 500
Time Zone 500 запросов в секунду

Для управления расходами вы можете отслеживать использование API и устанавливать дневные лимиты на все запросы к платным API.

Продукты платформы Google Карт нужно развертывать в соответствии с Условиями использования платформы Google Карт.

Как рассчитывается стоимость использования?

С ценами на продукты платформы Google Карт можно ознакомиться в этой таблице.

Подробная информация о том, как взимается оплата за API платформы Google Карт, приведена в этой статье.

Как подсчитывается количество загрузок карт на платформе Google Карт?

Плата за одну загрузку карты будет взиматься при выполнении любого из следующих условий:

  • карта отображается на веб-странице или в приложении с помощью Maps JavaScript API;
  • приложение запрашивает одно изображение карты из Maps Static API.

Панорамы в Просмотре улиц оплачиваются отдельно от загрузки карт:

  • статическая (не интерактивная) панорама в Просмотре улиц оплачивается за каждый запрос к Street View Static API на встраивание статической панорамы;
  • динамическая панорама в Просмотре улиц оплачивается за каждый экземпляр объекта панорамы в приложении с Maps JavaScript API, Maps SDK для Android или Maps SDK для iOS.

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

При добавлении маркера дополнительная загрузка не происходит, но может измениться способ, используемый для определения местоположения маркера, например возможна загрузка или повторная загрузка класса google.maps.Map().

Как отслеживать использование?

Вы можете контролировать использование отдельных API с помощью Google Cloud Console.

  1. Выберите проект с нужным API.
  2. В списке API на панели инструментов выберите название API.
  3. В верхней части страницы нажмите Показатели или Квоты.

Чтобы посмотреть отчет о трафике и платежную информацию для всего проекта, выполните следующие действия:

  1. Настройте платежные функции.
  2. Перейдите на страницу оплаты в Cloud Console.
  3. Выберите проект.
  4. На левой боковой панели выберите Отчеты. С помощью фильтров на правой боковой панели посмотрите отчеты по своему платежному аккаунту.

Более подробная информация приведена в статьях об отчетах платформы Google Карт, мониторинге использования API и ограничении использования API.

Что будет, если превысить лимиты частоты запросов?

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

Если вы превысили лимит количества запросов в секунду или допустили другое неправильное использование сервиса, запросы будут возвращать сообщения об ошибках. Если превышение лимитов продолжится, ваш доступ к платформе Google Карт может быть заблокирован.

Примечание. Для следующих четырех API веб-сервисов в Maps JavaScript API доступен равнозначный клиентский сервис: Directions, Distance Matrix, Elevation и Geocoding.

Превышение лимитов на использование

При превышении лимитов на использование вы будете получать в ответ на запрос код статуса OVER_QUERY_LIMIT.

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

Если вы регулярно превышаете лимиты на количество запросов в секунду, попробуйте сократить объем использования путем оптимизации приложений, которые работают с продуктами платформы Google Карт. Более подробные сведения вы найдете в руководстве по оптимизации.

На моем сайте большой трафик. Можно ли мне использовать продукты платформы Google Карт?

Да. Однако мы рекомендуем ознакомиться с лимитами на использование платформы Google Карт, которые применимы к вашему приложению.

Если вы превысите ежемесячный лимит бесплатного использования в размере 200 долл. США и в вашем платежном аккаунте не будет указан действующий способ оплаты (кредитная карта, банковский перевод и т. п.), API прекратит работу до тех пор, пока вы не добавите способ оплаты.

Как рассчитывается и оплачивается использование?

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

Сколько стоит использование платформы Google Карт?

Стоимость для каждого API приведена в таблице цен. Если ваше приложение создает запросы на загрузку карт в пределах 200 долларов США в месяц, эта возможность предоставляется бесплатно. Превышение лимита будет оплачиваться с вашего платежного аккаунта. Подробные сведения можно получить в руководстве по оплате платформы Google Карт.

Доступны ли цены в других валютах?

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

У меня настроены платежные функции. Как посмотреть счет?

Google взимает плату за предыдущий месяц в начале нового месяца с помощью указанного вами способа оплаты. Подробные сведения об оплате можно найти в руководстве по оплате платформы Google Карт.

Дополнительные ресурсы:

Как избежать крупных расходов при непредвиденном увеличении объемов трафика?

Платформа Google Карт дает возможность настроить ограничение на количество запросов в день и установить максимальную сумму, которую вы готовы платить в сутки. Это поможет избежать незапланированных расходов, если количество обращений внезапно возрастет. Также можно настроить отправку уведомлений по электронной почте в тех случаях, когда сумма счета достигает заданного порога.

Как установить ограничение на количество тарифицируемых запросов в день

Чтобы не получать неожиданно большие счета, можно установить ограничение дневного использования для предотвращения непредвиденного роста объемов использования. Вы можете изменить это ограничение в Cloud Console следующим образом:

  1. Откройте панель инструментов API и сервисы.
  2. Если появится запрос, выберите проект.
  3. Выберите API из списка и откройте вкладку Квоты.
  4. Нажмите на значок редактирования рядом с квотой Количество запросов в сутки.

Вы также можете изменить сразу несколько квот для нескольких API с помощью панели управления квотами на странице "IAM и администрирование".

Как настроить оповещения о бюджете и управлять ими

Вы можете настроить отправку оповещений на адреса электронной почты ответственных за оплату администраторов, если сумма счета достигает заданного порога. Администраторы получат оповещения, если сумма счета превысит 50 %, 90 % и 100 % от заданного порогового значения.

Мне пришло сообщение о том, что мой проект связан с "переходным аккаунтом платформы Google Карт", но у меня нет доступа к этому аккаунту. Что делать?

Переходный аккаунт платформы Google Карт предназначен для того, чтобы помочь некоторым клиентам перейти на наш новый тарифный план с оплатой по мере использования. Этот аккаунт позволяет Google выдавать пользователям однократный кредит, чтобы они могли и далее использовать платформу Google Карт в пределах лимита бесплатного плана в 200 долл. США. При превышении лимита платежный аккаунт будет отключен и вы потеряете доступ к сервису. Чтобы избежать перебоев в работе сервисов, мы рекомендуем настроить отдельный платежный аккаунт и далее пользоваться бесплатным планом с лимитом в 200 долл. США. Чтобы изменить платежный аккаунт для проекта, выполните следующие действия:

  1. Создайте платежный аккаунт (если он у вас уже есть, пропустите этот шаг).
  2. Свяжите платежный аккаунт со своим проектом.
Почему мой лимит квоты составляет один запрос в день? Как его увеличить?

Если вы не создали и не прикрепили к проекту платежный аккаунт, ваши API платформы Google Карт будут ограничены одним запросом в день. Вы можете получить большую квоту, создав и прикрепив платежный аккаунт. Подробнее…

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

Мне пришло уведомление о нарушениях, связанных с оплатой. Как решить этот вопрос?

Вы получили это уведомление, поскольку, по данным Google, в вашем аккаунте используется несколько платежных аккаунтов. Таким образом вы нарушаете Условия использования платформы Google Карт (раздел 3.2.4). Создавать несколько платежных аккаунтов запрещено. Подробнее…

Использование платформы Google Карт

Какие ключи или учетные данные нужно использовать для разных продуктов Google Карт?

При каждом использовании продуктов платформы Google Карт вы должны указывать ключ API для подтверждения запроса. Платформа Google Карт доступна для Android, iOS, веб-приложений, а также через веб-сервисы HTTP.

Ключ API

  • Ключ API – это уникальный идентификатор, создаваемый с помощью Cloud Console.
  • Пример загрузки API с использованием ключа: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo.

Цифровая подпись

  • Цифровая подпись создается на основе секрета для подписания URL, который вы получили от компании Google. Цифровые подписи используются с Maps Static API и Street View Static API.

Ограничения

  • Ограничения ключа API необязательны, но для повышения безопасности мы настоятельно рекомендуем вам ограничить все ключи API. Подробную информацию вы найдете в рекомендациях по обеспечению безопасности доступа к API.
  • К ключу API можно добавить ограничение по типу приложений. После добавления ограничения ключ будет работать только на тех платформах, которые поддерживают ограничение этого типа. Существует четыре типа ограничений по типу приложений. API с одинаковым типом ограничений могут совместно использовать один ключ с ограничением.
    • IP-адреса (отдельные серверы) – для использования с API веб-сервиса.
    • Заголовки HTTP referer (сайты) – для использования с веб-API.
    • Ограничение по типу приложений для Android (по названию пакета и цифровому отпечатку) – для использования с Maps SDK для Android.
    • Ограничение по типу приложений для iOS (по идентификатору пакета iOS) – для использования с Maps SDK для iOS.
  • Также вы можете добавить к ключу API ограничение API.

В таблице ниже приведены ограничения ключа/учетных данных и приложений для каждого API и SDK платформы Google Карт.

API/SDK Ограничение по учетным данным и типу приложений
Maps SDK для Android Ключ API с ограничением для Android1
Places SDK для Android Ключ API с ограничением для Android1
Maps SDK для iOS Ключ API с ограничением для iOS1
Places SDK для iOS Ключ API с ограничением для iOS1
Maps JavaScript API Ключ API с ограничением по заголовку HTTP referer1
Maps Static API Ключ API с ограничением по заголовку HTTP referer1 + цифровая подпись2
Street View Static API Ключ API с ограничением по заголовку HTTP referer1 + цифровая подпись2
Maps Embed API Ключ API с ограничением по заголовку HTTP referer1
Address Validation API Ключ API с ограничением по IP-адресу1
Directions API Ключ API с ограничением по IP-адресу1
Distance Matrix API Ключ API с ограничением по IP-адресу1
Elevation API Ключ API с ограничением по IP-адресу1
Geocoding API Ключ API с ограничением по IP-адресу1
Geolocation API Ключ API с ограничением по IP-адресу1
Places API Ключ API с ограничением по IP-адресу1
Roads API Ключ API с ограничением по IP-адресу1
Routes API Ключ API с ограничением по IP-адресу1
Time Zone API Ключ API с ограничением по IP-адресу1
1Ограничения ключа API необязательны, но для повышения безопасности мы настоятельно рекомендуем вам ограничить все ключи API.
2В зависимости от сценария использования для Maps Static API и Street View Static API может требоваться цифровая подпись. Независимо от сценария использования мы настоятельно рекомендуем применять для подтверждения запроса и ключ API, и цифровую подпись.
Как изменить тип ограничений для ключа, чтобы вместо ограничения по заголовку HTTP referer использовать ограничение по IP-адресу?

Важно! При использовании любого из API веб-сервисов с ключом API, который имеет ограничения по заголовку HTTP referer, запросы будут завершаться ошибкой с сообщением "API keys cannot have referer restrictions when used with this API" (При использовании с этим API ключи API не могут иметь ограничений по заголовку HTTP referer). Вам следует перейти на использование ключа API с ограничением по IP-адресу.

Прежде чем менять ограничение по заголовку HTTP referer на ограничение по IP-адресу, убедитесь, что все API, которые используют этот ключ API, поддерживают ограничения по IP-адресу. API с одинаковым типом ограничений могут совместно использовать один ключ с ограничением. Если нужно применять несколько ограничений, добавьте отдельный ключ с нужным типом ограничения. Подробнее о том, как добавить новый ключ API

Подробная информация об ограничениях ключей API, связанных с продуктами платформы Google Карт, приведена в этом разделе.

Чтобы вместо ограничения ключа API по заголовку HTTP referer использовать ограничение по IP-адресу, выполните следующие шаги:

  1. Откройте страницу Учетные данные в Cloud Console.
  2. Выберите проект, содержащий ключ API, который нужно изменить.
  3. На странице Учетные данные выберите нужный ключ API из списка.
  4. В разделе Ограничение ключа на этой странице выберите “IP-адреса (веб-серверы, задания Cron и т. д.)” и вставьте нужные IP-адреса сервера, после чего нажмите "Сохранить".
Как получить новый ключ API?
Подробнее о начале работы с платформой Google Карт
Где найти список изменений для каждой из версий Google Maps API?

Информацию об изменениях для многих API Карт можно найти по следующим ссылкам:

Также вы можете проверить наличие ошибок в версиях платформы Google Карт и информацию об их устранении с помощью Системы отслеживания ошибок платформы Google Карт по адресу:

https://issuetracker.google.com/bookmark-groups/76561

Как асинхронно загрузить API на страницу после ее загрузки?

Просто укажите параметр обратного вызова при загрузке API. Более подробную информацию и образец кода можно найти в этом разделе документации по Maps JavaScript API.

Как сделать так, чтобы продукты платформы Google Карт отображались не на английском, а на другом языке?

По умолчанию API пытается загрузить карты на языке пользователя (в зависимости от его местоположения и настроек браузера). Некоторые API позволяют явным образом указать язык при отправке запроса. Дополнительную информацию по настройке языка см. в документации, прилагаемой к каждому API:

Поддерживаемые языки

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

Код языка Язык Код языка Язык
af Африкаанс ja Японский
sq Албанский kn Каннада
am Амхарский kk Казахский
ar Арабский km Кхмерский
hy Армянский ko Корейский
az Азербайджанский ky Киргизский
eu Баскский lo Лаосский
be Белорусский lv Латышский
bn Бенгальский lt Литовский
bs Боснийский mk Македонский
bg Болгарский ms Малайский
my Бирманский ml Малаялам
ca Каталанский mr Маратхи
zh Китайский mn Монгольский
zh-CN Китайский (упрощенный) ne Непальский
zh-HK Китайский (Гонконг) no Норвежский
zh-TW Китайский (традиционный) pl Польский
hr Хорватский pt Португальский
cs Чешский pt-BR Португальский (Бразилия)
da Датский pt-PT Португальский (Португалия)
nl Нидерландский pa Пенджабский
en Английский ro Румынский
en-AU Английский (Австралия) ru Русский
en-GB Английский (Великобритания) sr Сербский
et Эстонский si Сингальский
fa Фарси sk Словацкий
fi Финский sl Словенский
fil Филиппинский es Испанский
fr Французский es-419 Испанский (Латинская Америка)
fr-CA Французский (Канада) sw Суахили
gl Галисийский sv Шведский
ka Грузинский ta Тамильский
de Немецкий te Телугу
el Греческий th Тайский
gu Гуджарати tr Турецкий
iw Иврит uk Украинский
hi Хинди ur Урду
hu Венгерский uz Узбекский
is Исландский vi Вьетнамский
id Индонезийский zu Зулусский
it Итальянский

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

Можно ли обращаться к платформе Google Карт по протоколу SSL (HTTPS)?

К Maps JavaScript API, Maps Static API и API веб-сервисов можно обращаться по протоколу HTTPS. Информацию о доступе к API по протоколу SSL можно найти в документации к API.

Обратите внимание, что Maps Static API не поддерживает URL пользовательского значка с протоколом HTTPS; вместо него будет отображаться значок по умолчанию.

Как сообщить об ошибке или запросить новую функцию платформы Google Карт?

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

Если вы хотите запросить новую функцию, сначала поднимите этот вопрос на форуме, чтобы удостовериться, что подобных решений ещё нет.

Убедившись, что вы обнаружили ошибку или что на платформе Google Карт нет нужной вам функции, отправьте запрос через Систему отслеживания ошибок платформы Google Карт.

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

Как API платформы Google Карт используют файлы cookie сайта?

Использование файлов cookie в Maps SDK для Android и Maps SDK для iOS регулируется Политикой конфиденциальности Google. Например, это влияет на такие действия, как расчет количества активных пользователей за день и семь дней и предотвращение злоупотребления сервисами. Эти файлы cookie не связаны ни с одним аккаунтом Google, в который выполнен вход, и, как и другая информация, полученная из вызовов API, не регистрируются в журналах.

Я не могу найти ответ на свой вопрос. Куда мне обратиться?

Представители Google регулярно просматривают сообщения на сайте Stack Overflow. Это ресурс, позволяющий программистам обмениваться опытом, и мы рекомендуем использовать его при разработке приложений на базе Google Карт. Подробная информация о работе с сайтом Stack Overflow приведена в статье о ресурсах технической поддержки.

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

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

Ошибки и устранение неполадок

Что означает эта ошибка?

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

Карты отображаются более темными, чем обычно. Что случилось?

При некоторых обстоятельствах карты могут отображаться затемненными, а изображения Просмотра улиц – в негативе, с водяными знаками с текстом "for development purposes only" (только для целей разработки). Это обычно означает проблемы с ключом API или оплатой сервисов. Для использования продуктов платформы Google Карт у вас должен быть платежный аккаунт, а все запросы должны содержать действующий ключ API. Эту проблему поможет решить приведенная ниже последовательность шагов.


Как устранить ошибки с кодами OVER_DAILY_LIMIT и OVER_QUERY_LIMIT?
Ошибки с этими кодами могут возникнуть по одной из следующих причин:

Для использования продуктов платформы Google Карт у вас должен быть платежный аккаунт, а все запросы должны содержать действующий ключ API. Чтобы решить проблему, сделайте следующее:

Как устранить ошибки с кодами kGMSPlacesRateLimitExceeded и 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Если возникла ошибка с кодом kGMSPlacesRateLimitExceeded или 9005 PLACES_API_RATE_LIMIT_EXCEEDED, возможно, вы используете версию Places SDK для Android или Places SDK для iOS, поддержка которой прекращена. Подробную информацию и новые SDK можно найти по адресу https://goo.gle/places-sdk-deprecation.
Как устранить ошибку "This IP, site or mobile application is not authorized to use this API key" (Этот IP, сайт или мобильное приложение не авторизованы для использования этого ключа API)?

Эта ошибка может быть вызвана следующими сценариями:

  • Вы установили ограничение ключа API по IP-адресу (для сервера), а отправка запроса выполняется с неавторизованного IP-адреса.
  • Вы установили ограничение ключа API по заголовку HTTP referer (для сайтов), а запрос выполняется неавторизованным источником.
  • Вы разрешили использовать ключ API только для ваших приложений Android, задав имя пакета и цифровой отпечаток, а запрос выполняется из неавторизованного приложения Android.
  • Вы ограничили запросы из приложений iOS, указав идентификаторы пакетов, а отправить запрос пытается нераспознанное приложение iOS.
  • Раньше эта ошибка могла возникать, если вы использовали один из API веб-сервисов с ключом API, ограниченным по заголовку HTTP referer. Запросы к таким API должны содержать ключ API с ограничениями по IP-адресу. Измените тип ограничения ключа с заголовка HTTP referer на IP-адрес. Более подробная информация об ограничениях ключей API приведена в этой статье.

Просмотр и изменение учетных данных ключа API

Чтобы посмотреть свои ключи API и изменить какие-либо ограничения, выполните следующие действия:

  1. Откройте страницу Учетные данные в Cloud Console.
  2. Выберите проект с нужным ключом API.
  3. Чтобы посмотреть сведения об учетных данных, включая ограничения, заданные для ключа, в списке ключей API нажмите на название ключа.
  4. Отобразятся полные учетные данные выбранного ключа API, в том числе установленные ограничения. Здесь при необходимости можно удалять или изменять эти ограничения.
Как устранить ошибку "API keys with referer restrictions cannot be used with this API" (С этим API нельзя использовать ключи API с ограничениями по заголовку referer)?

Вы используете один из API веб-сервисов с ограничением ключа API по заголовку HTTP referer. Из соображений безопасности API веб-сервисов должны использовать ключи API с ограничениями по IP-адресам. Измените тип ограничения ключа с заголовка HTTP referer на IP-адрес или создайте новый ключ API, если ваш ключ уже используется в Maps JavaScript API.

Сервисы платформы Google Карт

Мне нужно преобразовать адреса в координаты (широту и долготу). Можно ли это сделать с помощью платформы Google Карт?

Да, этот процесс называется геокодированием. В Maps JavaScript API предусмотрен отдельный класс для выполнения геокодирования: google.maps.Geocoder.

Вы также можете воспользоваться Geocoding API от Google, который предоставляет интерфейс REST с поддержкой форматов JSON и XML.

В каких странах доступно геокодирование?

Чтобы узнать, в каких странах поддерживаются геокодеры платформы Google Карт, изучите данные о покрытии Google Карт.

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

Почему геокодеры платформы Google Карт и Google Карты сообщают разное местоположение?

В некоторых странах сервисы геокодирования API и веб-сервиса Google Карт используют различные базы данных. Данные геокодера API время от времени обновляются, поэтому точность результатов может повышаться.

Как оформлять запросы к геокодеру, чтобы повысить вероятность их успешной обработки?

Геокодер сопоставляет адреса с географическими координатами. Чтобы максимально повысить шансы успешной обработки запросов, оформляйте их согласно следующим рекомендациям:

  • Указывайте адреса в формате, принятом для почтовых адресов в нужной вам стране.
  • Не указывайте дополнительные данные, обычно не содержащиеся в почтовых адресах этой страны, например названия компаний, номера этажей и квартир. Это может привести к получению ответов ZERO_RESULTS.
  • Коды Plus Code следует форматировать так, как в примере ниже (символы плюса экранируются в URL как %2B, а пробелы – как %20):
    • Глобальный код содержит 4 знака кода зоны и 6 и более знаков местного кода (849VCWC8+R9 – это 849VCWC8%2BR9).
    • Составной код содержит 6 и более знаков местного кода с точными данными о местоположении (CWC8+R9 для Маунтин-Вью, Калифорния (США) имеет значение CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • По возможности указывайте номера домов, а не их названия.
  • По возможности указывайте номера домов, а не информацию о том, на пересечении каких улиц они находятся.
  • Не добавляйте "подсказки" вроде названий местных ориентиров.
Какой формат должен иметь адрес нумерованной магистрали в США для выполнения геокодирования?

Для правильной работы геокодера платформы Google Карт нумерованные магистрали США необходимо указывать в следующих форматах:

  • Дороги местного значения: "Co Road NNN", где NNN – это номер дороги. Пример: "Co Road 82"
  • Дороги штата: "State NNN", где State – это полное название штата, а NNN – номер автомагистрали. Пример: "California 82"
  • Автомагистрали США: "U.S. NNN", где NNN – номер автомагистрали. Пример: "U.S. 101"
  • Дороги между штатами: "Interstate NNN", где NNN – это номер дороги. Пример: "Interstate 280"
Когда нужно использовать класс geocoder в API, а когда – HTTP-сервис геокодирования?

В документе о методах геокодирования подробно рассмотрены преимущества и недостатки каждого из них.

Как предоставить схему проезда с помощью платформы Google Карт?

Сервис Compute Routes, включенный в Routes API и Directions API, позволяет показывать схемы проезда с одним и несколькими пунктами назначения. Вы можете выбирать для схемы проезда режим передвижения (например, на автомобиле), один или несколько маршрутов и ограничения (например, без платных дорог). Этот сервисы доступен в следующих интерфейсах:

  • Интерфейс HTTP-запросов и ответов (используется в мобильных и других приложениях) совместим с Maps SDK для Android и другими веб-сервисами Google Карт.
  • JavaScript API для клиентских приложений позволяет предоставлять схему проезда с помощью класса google.maps.DirectionsService. Класс DirectionsRenderer автоматически создает наложения и панель маршрутов. См. дополнительные примеры в документации.
  • Такую же функциональность обеспечивают клиентские интерфейсы Java, Python, Go и Node.js для серверных приложений. Подробнее о клиентских библиотеках Directions API
В каких странах доступны схемы проезда?

Чтобы узнать, в каких странах поддерживаются схемы проезда в продуктах платформы Google Карт, изучите данные о покрытии Google Карт. Обратите внимание, что доступность схем проезда зависит от наших соглашений с поставщиками данных, которые могут измениться.

В каких странах доступны маршруты на общественном транспорте?

В Directions API и Distance Matrix API поддерживаются все партнеры Google Транспорта, кроме тех, которые находятся в Японии.

Какие функции KML и GeoRSS поддерживаются в Maps JavaScript API?

Класс KmlLayer в Maps JavaScript API позволяет разработчикам накладывать файлы KML/KMZ и GeoRSS поверх карты. Документацию и примеры можно найти здесь.

Каковы ограничения на размер и сложность объектов KML, которые можно загружать с помощью класса KmlLayer в Maps JavaScript API?

Ограничения на размер и сложность объектов KML, отображаемых с помощью класса KmlLayer, приведены здесь.

Как прорисовать на карте файлы KML, хранящиеся на внутренних сайтах?

Класс KmlLayer, создающий наложения KML в Maps JavaScript API, использует размещенный в Google сервис для получения и синтаксического анализа файлов KML для прорисовки. Поэтому файлы KML, которые не хранятся по общедоступному URL или требуют аутентификации для доступа, отобразить невозможно.

Если вы разрабатываете приложения, использующие файлы KML на внутренних сайтах, мы рекомендуем выполнять прорисовку KML на стороне клиента, используя библиотеки JavaScript сторонних разработчиков. Поскольку файл KML будет анализироваться браузером, скорость обработки может быть ниже, чем при использовании класса KmlLayer.

Какое максимальное количество маркеров или вершин пути поддерживается в Maps Static API?

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

Обратите внимание, что максимальная длина URL в Maps Static API составляет приблизительно 8192 символа, поэтому в запросе может содержаться ограниченное число точек маршрута в зависимости от того, сколько знаков после запятой указывается для каждой пары значений широты и долготы. Подробная информация о том, как количество знаков после запятой в географических координатах влияет на точность позиционирования, приведена в статье Википедии Decimal Degrees (на английском языке).

Почему в некоторых странах возникает проблема с доступом к продуктам платформы Google Карт?

Maps API нельзя использовать на запрещенных территориях. Подробная информация приведена в Условиях использования.

Как сообщить о проблеме на базовой карте Google?
В Google Картах можно сообщить о неверной или отсутствующей информации. Примеры:
  • неправильный адрес или неточное расположение маркера;
  • неправильное название дороги;
  • неверная информация об одностороннем или двустороннем движении;
  • неверное расположение дороги;
  • дорога закрыта;
  • дорога не существует.

Вы также можете изменить данные о месте или компании.

Если какой-то контент Карт нарушает действующие законы и его следует удалить, отправьте официальный запрос.

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

Как отслеживать эффективность сервисов, для работы которых используется Maps JavaScript API?

В некоторых клиентских функциях есть инструменты, которые сообщают об успехе или неудаче. Это необходимо для расчета SLO (целевого показателя уровня обслуживания). С помощью соответствующих запросов в Google по адресу maps.googleapis.com/maps_api_js_slo/log отправляется следующая информация: статус успешного выполнения, время реакции и версия/канал Maps JavaScript API. Для повышения эффективности вызовы могут быть объединены. Обратите внимание, что вам может потребоваться разрешить maps.googleapis.com в Content Security Policy, чтобы эти вызовы не блокировались на уровне браузера. Примеры: Content-Security-Policy: default-src 'self' maps.googleapis.com; для HTTP-заголовков и <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> для метатегов HTML.

Maps JavaScript API

В течение какого времени после загрузки будет работать Maps JavaScript API?

Страницу, которая загружает Maps JavaScript API, нужно обновлять не реже раза в 5 дней.

Google Maps SDK для iOS

Как устранить ошибку kGMSPlacesRateLimitExceeded?
Если вы видите эту ошибку, возможно, вы используете версию Places SDK для iOS, поддержка которой прекращена. Версия 2.7.0 Places SDK для iOS отключена и более не доступна. Как можно скорее обновите свое приложение, чтобы перейти на последнюю версию. Подробную информацию об этом вы найдете в руководстве по переходу.
Попытки отладки с использованием устройства iOS 8.x завершаются ошибками. Что делать?

Если при отладке с использованием устройств iOS 8.x возникают ошибки, выполните приведенные ниже действия, чтобы отключить захват кадров графического процессора в схеме Xcode, которую вы используете.

  1. В Xcode выберите Product (Продукт), Scheme (Схема), Manage Schemes (Управление схемами).
  2. Выберите схему и нажмите Edit…(Редактирование).
  3. Установите для параметра GPU Frame Capture (Захват кадров графического процессора) значение Disabled (Отключено). Обратите внимание, что этот параметр может указываться не для всех устройств.
GPU Frame Capture option на странице Generic iOS device в Xcode.
Что изменится в Google Maps SDK для iOS с выходом iPhone с закругленными углами и более широким экраном?

Начиная с модели iPhone X устройства iPhone выпускаются в новой форме с закругленными углами, выемкой в верхней части для датчика и индикатором кнопки перехода на главный экран в нижней части. В SDK для iOS 11.0 специалисты Apple добавили Safe Area API, позволяющий разработчикам размещать элементы в области, которая не будет обрезаться новой формой экрана.

Google Maps SDK для iOS включает множество визуальных элементов и элементов управления, например окно выбора и ссылку для сообщения о проблеме. В версии 2.4 эти визуальные элементы и элементы управления могут быть обрезаны из-за новой формы экрана. В горизонтальном расположении окно выбора может быть обрезано из-за выемки или индикатора кнопки перехода на главный экран.

В версии 2.5 Google Maps SDK для iOS эти проблемы решаются автоматически. Если приложение используется на iPhone X или более поздней версии, поля GMSMapView и GMSPanoramaView увеличиваются так, чтобы визуальные элементы не обрезались.

По умолчанию мы всегда будем включать эти поля. В Google Maps SDK для iOS предполагается, что эти поля предназначены для обеспечения безопасной зоны. Если вы размещаете все элементы своего интерфейса в безопасной зоне, от вас не потребуется дополнительных действий.

Если вы разработали интерфейс, который не работает с нашими параметрами корректировки по умолчанию, воспользуйтесь новым свойством GMSMapView под названием paddingAdjustmentBehavior. Теперь в GMSMapView можно выбрать один из вариантов корректировки полей: Always (Всегда) (выбрано по умолчанию), Automatic (Автоматически) или Never (Никогда).

Если в GMSMapView для корректировки полей установлено значение Always (Всегда), то к полям всегда будет добавляться отступ безопасной зоны. Это позволит вам разрабатывать собственный интерфейс с уверенностью в том, что все элементы будут находиться в безопасной зоне. Это значение используется по умолчанию.

Если в GMSMapView настроена автоматическая корректировка полей, то система будет выбирать максимальное значение полей или отступа безопасной зоны. Так вы сможете добавлять поля по краю экрана, и при этом элементы всегда будут оставаться в безопасной зоне.

Если в GMSMapView для корректировки полей установлено значение Never (Никогда), к полям не будет добавляться отступ безопасной зоны. Такое поведение использовалось до выхода версии 2.5, и это подходящий вариант в тех случаях, когда поля заданы с учетом безопасной зоны или другие варианты плохо сочетаются с вашим интерфейсом. Вы ответственны за то, чтобы логотип Google и информация об авторских правах всегда были видны, как описано в Условиях использования платформы Google Карт.

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

Google Maps SDK для Android

Как устранить ошибку с кодом 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Если вы видите эту ошибку, возможно, вы используете версию Places SDK для Android, поддержка которой прекращена. Версия Places SDK для Android для сервисов Google Play отключена и более не доступна. Как можно скорее обновите свое приложение, чтобы перейти на последнюю версию. Подробную информацию об этом вы найдете в руководстве по переносу.
В моем приложении вместо карты отображаются только пустые серые плитки. Как решить этот вопрос?

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

  1. Убедитесь, что у вас установлен adb. В противном случае следуйте этим инструкциям.
  2. Установите приложение, которое показывает проблему, на устройство или эмулятор Android. Если вы используете эмулятор Android, убедитесь, что в его настройках включен Google Play.
  3. В терминале Android Studio введите код adb logcat -e "Google Maps Android API". При этом будут выведены только те строки, в которых сообщение в журнале соответствует Google Maps Android API (в качестве опции вы можете вывести журнал в текстовый файл, добавив: > logcat.txt).
  4. Воспроизведите проблему на своем устройстве и проверьте наличие нижеуказанных распространенных ошибок.
    • В файле манифеста указан неправильный/неподходящий ключ API.
    • Платежные функции в проекте отключены.
    • SDK в API проекта отключены.
    • К ограничениям ключа API добавлен неверный цифровой отпечаток SHA1.
    • Зависимости сервисов Google Play не включены в файл build.gradle.

Подпись URL

Можно ли подписывать URL с помощью JavaScript?

Мы настоятельно не рекомендуем использовать JavaScript для подписи URL, поскольку в этом случае конечные пользователи могут получить доступ к вашему секрету для подписания URL. Подписи должны генерироваться только серверными компонентами.

Почему я получаю ответ "HTTP 403 Forbidden" на мои запросы веб-сервиса Maps API?

Ошибка "HTTP 403" означает проблемы с разрешениями доступа, вероятно вызванные тем, что невозможно подтвердить подпись для запроса. Возможные причины:

  1. Подпись указана, но является некорректной для этого запроса.
  2. В запросе указан ключ API для плана Premium платформы Google Карт, но не указана подпись, а вызываемый сервис требует, чтобы запросы, отправляемые с использованием ключа API, содержали действительную подпись.
  3. Подпись указана, но не указан связанный с ней ключ API для плана Premium платформы Google Карт.