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

Начиная

Ознакомьтесь с условиями обслуживания

Лимиты использования и биллинг

Используйте платформу Google Карт

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

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

API JavaScript Карт

Google Maps SDK для iOS

SDK Google Карт для Android

подписание URL-адресов

Начиная

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

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

Карты:

Маршруты:

Места:

Среда:

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

См. раздел Начало работы с платформой Google Maps .

Какой API мне нужен?

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

Как начать использовать API на моем сайте?

Ознакомьтесь с руководствами «Обзор», «Для разработчиков» и «Начало работы» для интересующего вас API или SDK. Например, ознакомьтесь с руководствами по Maps SDK для Android или Maps JavaScript API .

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

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

См. также:

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

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

Как загрузить приложения «Карты» на мобильные устройства?

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

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

API JavaScript Карт был разработан для мобильных устройств и подходит для браузерных приложений, предназначенных как для настольных компьютеров, так и для устройств, которые включают веб-браузер с полной реализацией JavaScript, например Apple 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).
Андроид
  • Текущая версия 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 Maps, чтобы быть в курсе новостей о различных предложениях Google Geo для разработчиков.

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

Информацию о доступных вариантах поддержки см. в разделе «Поддержка и ресурсы платформы Google Карт» .

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

Если вы потеряли доступ к своей учётной записи Google (например, joe@mycompany.com или joe@gmail.com), попробуйте восстановить доступ к ней, восстановив или сбросив пароль. См. статью «Как восстановить учётную запись Google или Gmail» в разделе «Справка по учётной записи Google».

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

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

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

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

Могу ли я использовать Maps and Places SDK для iOS на компьютерах Mac на базе Arm?

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

Ознакомьтесь с условиями обслуживания

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

Условия предоставления услуг платформы Google Maps доступны по адресу:

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

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

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

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

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

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

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

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

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

Могу ли я использовать Google Maps в своем невеб-приложении?

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

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

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

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

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

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

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

Мы больше не собираем эти данные. Использование параметра indexing устарело и не имеет силы. Вам больше не нужно явно отказываться от него, но мы рекомендуем вам удалить этот параметр как можно скорее.

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

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

Вы не имеете права хранить и предоставлять копии изображений, созданных с помощью Maps Static API на вашем веб-сайте. Все веб-страницы, требующие статических изображений, должны напрямую связывать атрибут src HTML-тега img или CSS-атрибут background-image HTML-тега div со статическим API Карт, чтобы все изображения карт отображались в HTML-контенте веб-страницы и предоставлялись Google непосредственно конечным пользователям.

Лимиты использования и биллинг

Как настроить выставление счетов для моего проекта?
См. раздел Начало работы с платформой Google Maps .
Как клиенты Google Cloud Free Tier могут перейти на платную учетную запись?
Программа Google Cloud Free Tier предоставляет клиентам бесплатный пробный период с кредитом в размере 300 долларов США для использования любых сервисов Google Cloud, включая API платформы Google Карт (GMP). По окончании бесплатного пробного периода необходимо перейти на платную учётную запись , чтобы продолжить пользоваться этими сервисами. Чтобы перейти на платную учётную запись, посетите консоль Cloud .
Есть ли ограничения по использованию платформы Google Maps?

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

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

API Лимит использования
Проверка адреса 6000 QPM
Вид с воздуха: поисковое видео 180 QPM и 100 000 QPD
Вид с воздуха: видео рендеринга 100 QPM и 100 QPD
Качество воздуха 6000 QPM
API JavaScript Карт: 3D-карты 30 000 QPM
API JavaScript Карт: Динамические карты 30 000 QPM
Высота 6000 QPM
Геокодирование 3000 QPM
Геолокация 6000 QPM
API фрагментов карты: фрагменты 2D-карты 6000 QPM и 15000 QPD
API фрагментов карты: фрагменты просмотра улиц 6000 QPM и 15000 QPD
API тайлов карты: фотореалистичные 3D-тайлы 12 000 QPM и 10 000 корневых запросов в день.
Навигация: установка запросов на пункт назначения 30 000 QPM
Места 6000 QPM
Места Совокупность 1200 QPM
Пыльца 6000 QPM
Дороги 30 000 QPM
Маршруты: вычисление маршрутов 3000 QPM
Маршруты: вычислить матрицу маршрутов 3000 эп/мин
Солнечный 600 QPM
Статические карты 30 000 QPM
API изображений Street View 30 000 QPM
Часовой пояс 30 000 QPM
Погода 6000 QPM

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

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

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

Обзор цен на продукты платформы Google Карт смотрите в прайс-листе .

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

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

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

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

Панорамы Street View тарифицируются отдельно от загрузки карт:

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

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

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

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

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

  1. Выберите проект, содержащий API, который вы хотите просмотреть.
  2. В списке API на панели инструментов щелкните имя API.
  3. В верхней части страницы нажмите «Метрики» или «Квоты» .

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

  1. Если вы еще этого не сделали, настройте выставление счетов .
  2. Перейдите на страницу выставления счетов облачной консоли.
  3. Выберите проект.
  4. На левой боковой панели нажмите «Отчёты» . Используйте фильтры на правой боковой панели для просмотра отчётов по вашему платёжному аккаунту.

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

Что произойдет, если я превышу лимит частоты запросов (QPM)?

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

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

Примечание: следующие API веб-сервисов имеют эквивалентную клиентскую службу, доступную в Maps JavaScript API: Elevation , Geocoding .

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

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

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

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

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

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

Если после создания учетной записи вы превысите лимит бесплатного использования и у вас не будет действительного способа оплаты в учетной записи (например, кредитной карты или банковского перевода), API перестанет функционировать до тех пор, пока вы не добавите действительный способ оплаты.

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

Использование рассчитывается в конце каждого дня и оплачивается в соответствии с прайс-листом . В конце каждого месяца с вашего платёжного аккаунта списывается общая сумма за использование. Подробнее см. в разделе «Оплата за платформу Google Карт» .

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

Ознакомьтесь с прайс-листом, чтобы ознакомиться с ценами на API. Если ваше приложение генерирует запросы или загружает карты в объёмах, не превышающих лимит бесплатного использования в течение месяца, плата за использование не взимается. Превышение лимита бесплатного использования будет списано с вашего платёжного счёта. Подробнее см. в разделе «Оплата за платформу Google Карт» .

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

В консоли могут быть доступны дополнительные валюты . При выборе другой валюты курсы будут конвертированы из эквивалента в долларах США, указанного в нашем прайс-листе .

Я настроил выставление счетов. Как мне посмотреть свой счет?

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

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

Как избежать большого счета, если объем использования неожиданно увеличится?

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

Ограничение максимального дневного лимита к оплате:

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

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

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

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

«Переходный аккаунт платформы Google Карт» был создан, чтобы помочь некоторым клиентам перейти на наш тарифный план с оплатой по мере использования. Этот переходный аккаунт позволил Google предоставить этим клиентам единовременный кредит, чтобы они могли продолжать использовать платформу Google Карт до достижения лимита бесплатного использования. После превышения этого лимита платёжный аккаунт будет закрыт, и вы потеряете доступ к сервису. Во избежание перебоев в работе сервиса мы настоятельно рекомендуем вам создать собственный платёжный аккаунт и продолжать пользоваться ежемесячным лимитом бесплатного использования. Чтобы изменить платёжный аккаунт для вашего проекта:

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

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

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

Я получил уведомление о нарушении правил выставления счетов. Как мне это исправить?

Вы получили это уведомление, поскольку Google определил, что ваша учётная запись использует несколько платёжных аккаунтов. Это является нарушением условий Google, как определено в Условиях использования платформы Google Карт . Согласно этим условиям, создание нескольких платёжных аккаунтов запрещено. Подробнее см. в разделе «Часто задаваемые вопросы о нарушении правил платёжных аккаунтов» .

Используйте платформу Google Карт

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

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

API-ключ:

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

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

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

Ограничения:

  • Ограничения на использование API-ключей необязательны, но мы настоятельно рекомендуем ограничить использование всех API-ключей для повышения безопасности. Подробнее см. в разделе «Рекомендации по безопасности API» .
  • Вы можете добавить ограничение приложения к ключу API. После применения ограничения ключ будет работать только на платформах, поддерживающих этот тип ограничения. Доступны четыре типа ограничений приложения. API, реализующие один и тот же тип ограничения, могут использовать один и тот же ключ с ограничениями.
    • IP-адреса (отдельных серверов) — для использования с API веб-сервисов .
    • HTTP-рефереры (веб-сайты) — для использования с веб-API .
    • Ограничение приложений Android (по имени пакета и отпечатку пальца) — для использования с Maps SDK для Android .
    • Ограничение приложения iOS (по идентификатору пакета iOS) — для использования с Maps SDK для iOS .
  • Вы также можете добавить ограничение API к ключу API. Подробнее см. в статье Получение, добавление и ограничение ключа API .

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

API/SDK Ограничение полномочий и приложений
Карт SDK для Android API-ключ с ограничением Android 1
Places SDK для Android API-ключ с ограничением Android 1
Навигационный SDK для Android API-ключ с ограничением Android 1
Карт SDK для iOS API-ключ с ограничением iOS 1
Places SDK для iOS API-ключ с ограничением iOS 1
Навигационный SDK для iOS API-ключ с ограничением iOS 1
API JavaScript Карт API-ключ с ограничением HTTP-реферера 1
API фрагментов карты API-ключ с ограничением по IP-адресу 1
API наборов данных карт OAuth-токен
API вида с воздуха API-ключ с ограничением по IP-адресу 1
Статический API Карт API-ключ с ограничением HTTP-реферера 1 + Цифровая подпись 2
Статический API Street View API-ключ с ограничением HTTP-реферера 1 + Цифровая подпись 2
API для встраивания карт API-ключ с ограничением HTTP-реферера 1
API проверки адреса API-ключ с ограничением по IP-адресу 1
API высоты API-ключ с ограничением по IP-адресу 1
API геокодирования API-ключ с ограничением по IP-адресу 1
API геолокации API-ключ с ограничением по IP-адресу 1
API мест API-ключ с ограничением по IP-адресу 1
API агрегации мест API-ключ с ограничением по IP-адресу 1
API дорог API-ключ с ограничением по IP-адресу 1
API маршрутов API-ключ с ограничением по IP-адресу 1
API часового пояса API-ключ с ограничением по IP-адресу 1
API качества воздуха API-ключ с ограничением по IP-адресу 1
API пыльцы API-ключ с ограничением по IP-адресу 1
Солнечный API API-ключ с ограничением по IP-адресу 1
API погоды API-ключ с ограничением по IP-адресу 1
1 Ограничения по ключам API необязательны, но мы настоятельно рекомендуем вам ограничить все ключи API для большей безопасности.
2 В зависимости от использования, для Maps Static API и Street View Static API может потребоваться цифровая подпись. Независимо от использования, мы настоятельно рекомендуем использовать как ключ API, так и цифровую подпись для аутентификации ваших запросов.
Как изменить тип ограничения ключа с HTTP-реферера на ограничение по IP-адресу?

Важно: если вы используете API любого веб-сервиса с API-ключом, имеющим ограничения по реферерам, ваши запросы будут завершаться ошибкой: «API-ключи не могут иметь ограничения по реферерам при использовании с этим API». Вам следует перейти на использование API-ключа с ограничениями по IP-адресам.

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

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

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

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

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

Вы также можете проверить, в какой версии платформы Google Карт была обнаружена и исправлена ​​конкретная ошибка, с помощью инструмента отслеживания ошибок платформы Google Карт по адресу:

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

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

Просто укажите параметр обратного вызова при загрузке API. Дополнительную информацию и примеры кода можно найти в разделе «Начало работы» документации Maps JavaScript API.

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

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

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

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

Код языка Язык Код языка Язык
аф африкаанс джа японский
кв. албанский кн каннада
являюсь амхарский кк казахский
ар арабский км кхмерский
хай армянский ко корейский
аз азербайджанский ки кыргызский
Евросоюз баскский вот Лаосский
быть белорусский лв латышский
млрд бенгальский лт литовский
бс боснийский тк македонский
бг болгарский РС малайский
мой бирманский мл малаялам
ca каталонский Мистер маратхи
ж китайский мин монгольский
zh-CN Китайский (упрощенный) не непальский
zh-HK Китайский (Гонконг) нет норвежский
zh-TW Китайский (традиционный) pl польский
час хорватский пт португальский
cs чешский pt-BR Португальский (Бразилия)
да датский пт-ПТ Португальский (Португалия)
нл Голландский па пенджаби
ru Английский ро румынский
en-AU Английский (австралийский) ру Русский
en-GB Английский (Великобритания) старший Сербский (кириллица)
эт эстонский sr-Latn Сербский (латинская письменность)
фа фарси си сингальский
фи финский ск словацкий
фил филиппинский сл словенский
фр Французский эс испанский
fr-CA Французский (Канада) es-419 Испанский (Латинская Америка)
гл галисийский sw суахили
ка грузинский св шведский
де немецкий та тамильский
эл греческий те телугу
гу гуджарати й тайский
ив иврит тр турецкий
привет хинди Великобритания украинский
ху венгерский ур урду
является исландский уз узбекский
идентификатор индонезийский ви вьетнамский
это итальянский зу Зулу

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

Можно ли получить доступ к платформе Google Maps по протоколу HTTPS (TLS)?

Доступ ко всем сервисам платформы Google Карт может и должен осуществляться по протоколу HTTPS. Чтобы ваши приложения были защищены в будущем, мы настоятельно рекомендуем использовать TLS 1.3 для HTTPS. Хотя более старые версии TLS по-прежнему поддерживаются, мы не рекомендуем использовать устаревшие версии TLS 1.0 и 1.1.

Устаревший протокол SSL больше не поддерживается.

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

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

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

To request a feature, first raise it in the relevant forum to confirm that a solution that meets your requirements is not already available.

Once you have confirmed that you have identified a new bug, or that your requirements cannot be met by the existing functionality of Google Maps Platform products, report your bug or feature request using the Google Maps Platform Issue Tracker .

Before adding a bug or feature request to the Issue Tracker ,be sure to check that the bug or feature concerned has not already been added. If it has, you can star the issue to register your interest and be notified of updates.

How do Google Maps Platform APIs use site cookies?

Maps SDK for Android and Maps SDK for iOS use cookies subject to Google's Privacy Policy , such as calculating daily and 7-day active users and service abuse prevention. These cookies are not associated with any signed-in Google Account and are not logged with the rest of the information collected from the API calls.

I can't find the answer to my question. Who should I contact?

Google's Developer Relations team maintains a presence on Stack Overflow — a collaboratively-edited question and answer site for programmers. It's a great place to ask technical questions about developing and maintaining Google Maps applications. More information about asking questions on Stack Overflow is available on the Support page.

For best results when requesting help, keep the following in mind:

  • Search the current discussions. Chances are someone else has experienced a similar issue and found a fix.
  • Submit a link to your site if possible. Only post code snippets if the code is not viewable online.
  • Provide all relevant information including browser versions, errors, and all other facts that may be useful in troubleshooting this problem.

Errors and troubleshooting

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

If you encounter an error while loading or running the Google Maps APIs, see the following links to find explanations for the error codes:

My maps appear darker than usual. What's happening?

Under certain circumstances, a darkened map, or 'negative' Street View image, watermarked with the text "for development purposes only", may be displayed. This behavior typically indicates issues with either an API key or billing. To use Google Maps Platform products, you must have a billing account and all requests must include a valid API key. The following flow will help troubleshoot this:


How do I resolve the error codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT ?
These error codes can be returned for any of the following reasons:
  • An API key is missing from the request.
  • The provided API key is invalid.
  • The project does not have a billing account attached.
  • A self-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for example, a credit card has expired).
  • You have exceeded the quota limits for a given API.

To use Google Maps Platform products, you must have a billing account, and all requests must include a valid API key. To fix this, take the following steps:

How do I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED ?
If you are seeing kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED , you may be using a deprecated version of the Places SDK for Android or Places SDK for iOS. Learn more and find the new SDKs at https://goo.gle/places-sdk-deprecation .
How do I resolve the error: "This IP, site or mobile application is not authorized to use this API key."?

There are various scenarios which may cause this error:

  • You've enabled IP address (server) restrictions on your API key, and an unauthorized IP address is attempting a request.
  • You've enabled HTTP referrer (website) restrictions on your API key, and an unauthorized referrer is attempting a request.
  • You've restricted usage to your Android apps by setting a package name and fingerprint, and an unauthorized Android app is attempting a request.
  • You've restricted requests from iOS apps by specifying bundle identifiers and an unrecognized iOS app is attemting to send a request.
  • It used to be possible to get this error if you used any of the web service APIs , with an API key with HTTP referer restrictions. Requests to those APIs should be identified with an API key with IP address restrictions. Switch your key restriction type from an HTTP referer restriction to an IP address restriction . For more information about restricting API keys, see API Key Best Practices .

View and Edit your API Key Credentials

To view your API keys and manage any restrictions, do the following:

  1. Go to the Credentials page of the Cloud console.
  2. Select the project that contains the API key you want to review.
  3. To view credential details, including any restrictions set for the key, from the list of API keys, click the name of the key.
  4. The full credentials of the selected API key are displayed, including any restrictions set up for the key. From here, the restrictions can be changed, deleted, or updated as needed.
How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

You are using any of the web service APIs with an API key restricted to an HTTP referer. For security reasons, web service APIs need to use API keys restricted to IP addresses . Switch your key restriction type from an HTTP referer restriction to an IP address restriction , or create a new API key if your key is already used with the Maps JavaScript API.

Google Maps Platform Services

I need to convert addresses to latitude/longitude pairs. Can I do that with Google Maps Platform?

Yes, this process is called "geocoding." The Maps JavaScript API includes a class for performing a geocoding service. The class is: google.maps.Geocoder .

Alternatively, Google also provides the Geocoding API , which offers a REST interface that can respond in JSON and XML formats.

Which countries is geocoding available in?

To see countries supported by Google Maps Platform geocoders, consult the Google Maps coverage data .

The accuracy of geocoded locations may vary per country, so you should consider using the returned location_type field to determine if a good enough match has been found for the purposes of your application. The availability of geocoding data depends on our contracts with data providers, so it is subject to change.

Why do Google Maps Platform Geocoders provide different locations than Google Maps?

The API geocoder and Google Maps geocoder sometimes use different data sets (depending on the country). The API geocoder occasionally gets updated with new data, so you can expect to see results changing or improving over time.

How should I format my geocoder queries to maximise the number of successful requests?

The geocoder is designed to map street addresses to geographical coordinates. We therefore recommend that you format geocoder requests in accordance with the following guidelines to maximize the likelihood of a successful query:

  • Specify addresses in accordance with the format used by the national postal service of the country concerned.
  • don't specify additional address elements such as business names, unit numbers, floor numbers, or suite numbers that are not included in the address as defined by the postal service of the country concerned. Doing so may result in responses with ZERO_RESULTS .
  • Format plus codes as shown here (plus signs are url-escaped to %2B and spaces are url-escaped to %20 ):
    • global code is a 4 character area code and 6 character or longer local code (849VCWC8+R9 is 849VCWC8%2BR9 ).
    • compound code is a 6 character or longer local code with an explicit location (CWC8+R9 Mountain View, CA, USA is CWC8%2BR9%20Mountain%20View%20CA%20USA ).
  • Use the street number of a premise in preference to the building name where possible.
  • Use street number addressing in preference to specifying cross streets where possible.
  • don't provide 'hints' such as nearby landmarks.
How should I format a US address on a numbered highway for geocoding?

The Google Maps Platform geocoder requires that US numbered highways be specified in addresses as follows:

  • County Roads: "Co Road NNN " where NNN is the road number. eg. "Co Road 82"
  • State Highways: " State NNN " where State is the full name of the state and NNN is the highway number. eg. "California 82"
  • US Highways: "US NNN " where NNN is the highway number. eg. "US 101"
  • US Interstates: "Interstate NNN " where NNN is the interstate number. eg. "Interstate 280"
When should I use an API geocoder class and when should I use the HTTP Geocoding Service?

See the document: Geocoding Strategies , which details the advantages and limitations of different geocoding strategies.

How do I provide driving directions with Google Maps Platform?

The Compute Routes service of the Routes API lets you provide driving directions for single and multi-leg journeys. Routing options help you shape directions with a travel mode (driving), a single or a set of routes, and restrictions (no toll roads). These services are available in the following forms:

HTTP request/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps web services.

In which countries are driving directions available?

To see countries supported by driving directions in Google Maps Platform products, consult the Google Maps coverage data . The availability of driving directions data depends on our contracts with data providers, and is subject to change.

In which countries are transit directions available?

The Routes API supports all Google Transit partners , except the Indian Railway Catering and Tourism Corporation and those in Japan.

Which KML and GeoRSS features are supported in the Maps JavaScript API?

The KmlLayer class in the Maps JavaScript API enables developers to overlay KML/KMZ and GeoRSS files on top of the map. For documentation and examples, see KmlLayer class .

What are the limits on the size and complexity of KML that can be displayed using the KmlLayer class of the Maps JavaScript API?

The size and complexity limits on the display of KML using the KmlLayer class are documented KmlLayer overview .

How do I render KML files that are hosted on intranet sites on a map?

The KmlLayer class that generates KML overlays in the Maps JavaScript API uses a Google hosted service to retrieve and parse KML files for rendering. Consequently it is not possible to display KML files that are not hosted at a URL that is available publicly accessible, or that require authentication to access.

If you need to develop applications that use KML files hosted on intranet sites we recommend that you render the KML on the client side by using third-party JavaScript libraries. As the KML file is analyzed by the browser, performance may be lower than by using the KmlLayer class.

What is the maximum number of markers or path vertices supported by the Maps Static API?

There is no limit to the number of markers or path vertices supported by the Maps Static API. When using custom icons, up to five unique icons can be specified per request, but each can be used multiple times within the map.

Note that Maps Static API URLs can contain a maximum of approximately 8,192 characters which constrains the number of markers and path vertices that can be specified based on the number of decimal places used when specifying each latitude/longitude pair. For information on how the number of decimal places used relates to the accuracy on the Earth see the Wikipedia article on Decimal Degrees .

Why can't I access Google Maps Platform products for certain countries?

Maps APIs may not be used in Prohibited Territories . Refer also to the Terms of Service .

How do I report a problem on the Google basemap?
Send feedback through Google Maps for wrong or missing map information such as:
  • Wrong addresses or marker locations
  • Incorrect road names
  • Wrong information about one-way and two-way roads
  • Incorrectly drawn road
  • Закрытые дороги
  • Roads that don't exist

For correction of a place or business listing, suggest an edit .

If Maps content needs to be removed for legal reasons, submit a legal request.

For critical or time-sensitive requests, file a support case with specific details on what needs to be fixed.

How is performance monitored for the services used with Maps JavaScript API?

Some client-side features are instrumented to report success or failure for the purpose of calculating the SLO (Service Level Objective). This information is sent to Google at maps.googleapis.com/maps_api_js_slo/log in calls that log SLO information. This information includes success status, latency, and version/channel of the Maps JavaScript API in use. The calls may be batched for performance. You may need to allow maps.googleapis.com in your Content Security Policy so that these calls are not blocked at browser-level. For example: Content-Security-Policy: default-src 'self' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> with HTML Meta Tags.

API JavaScript Карт

How long will the Maps JavaScript API work after it has been loaded?

You need to refresh the page that loads the Maps JavaScript API at least once every 5 days.

Google Maps SDK for iOS

How do I resolve the error: kGMSPlacesRateLimitExceeded ?
If you are seeing this error, you may be using a deprecated version of the Places SDK for iOS. Version 2.7.0 of the Places SDK for iOS has been turned off, and is no longer available. Update your app to use the latest version as soon as possible. See the migration guide for details.
I'm getting crashes when debugging with an iOS 8.x device. What should I do?

If you experience issues when debugging with devices running iOS 8.x, follow these steps to disable GPU frame capture in the XCode scheme you are running:

  1. In XCode, choose Product , Scheme , Manage Schemes .
  2. Select a scheme and choose Edit... .
  3. Set the GPU Frame Capture option to Disabled . Note that this option may not be present for all devices.
Xcode GPU Frame Capture option on the Generic iOS device page
What's the impact of rounded and wider screens on the Google Maps iOS SDK?

Beginning with the iPhone X , iPhones have a screen shape featuring rounded corners, a notch at the top for the device's sensor housing, and an indicator at the bottom of the screen for accessing the Home screen. As of iOS 11.0 SDK, Apple added the Safe Area API allowing developers to position elements in an area which is safe from being clipped by the new screen shape.

The Google Maps iOS SDK has many visual elements and controls, such as an indoor picker and the report a problem link. With version 2.4, these visual elements and controls could be clipped by the new screen shape. In landscape mode, the indoor floor picker may be clipped by either the notch or the home button indicator.

With the Google Maps iOS SDK 2.5 release these layout issues are fixed automatically. When your app is used on an iPhone X or later, the padding on GMSMapView and GMSPanoramaView are increased so that the visual elements aren't clipped.

By default, we will always include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe area. If you design your interface with the assumption that everything is positioned within the safe area, this will work without any extra effort.

If you have designed an interface which doesn't work with our default adjustment, we have introduced a new property to GMSMapView, called paddingAdjustmentBehavior . Use GMSMapView to pick from one of three padding adjustments behaviors: 'Always' (default), 'Automatic', and 'Never'.

If GMSMapView is set to use the 'Always' padding behavior, it will always add the safe area insets to the padding. This setting lets you design your interface with the assumption that all placement is from the edges of the safe area. This is the default value.

If GMSMapView is set to use the 'Automatic' padding behavior, it will always choose the larger of padding or safe area inset. This setting lets you add padding from the screen edge while making sure that all elements stay within the safe area.

If GMSMapView is set to use the 'Never' padding behavior, it will never add the safe area insets to the padding. This is the behavior prior to the 2.5 release and may be useful if your padding already takes into consideration the safe area, or if our other behaviors don't act well with your interface. It is your responsibility to make sure that the Google logo and copyright notices are always visible, as specified in the Google Maps Platform Terms of Service .

In contrast, GMSPanoramaView doesn't have an optional padding property. This means that there is no padding to adjust and GMSPanoramaView will always apply any necessary padding so that all visual elements are within the safe area.

Google Maps SDK for Android

How do I resolve the error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED ?
If you are seeing this error, you may be using a deprecated version of the Places SDK for Android. The Google Play services version of the Places SDK for Android has been turned off, and is no longer available. Update your app to use the latest version as soon as possible. See the migration guide for details.
My app only shows blank grey tiles instead of a map. How can I resolve this?

A common reason that a blank grey tiles are shown instead of a map is authentication issues. You can follow the steps below to troubleshoot those issues by using adb logcat.

  1. Make sure you have adb installed. If not, you can follow the guide Android adb guide .
  2. Install the app that shows the problem on a device or an Android emulator. If you use Android emulator, make sure the emulator settings has Play Store included.
  3. In Android Studio terminal, run adb logcat -e "Google Maps Android API" . This will only print lines where the log message matches "Google Maps Android API" (Optionally, you can output the log to a text file by appending: > logcat.txt)
  4. Reproduce the issue on your device and check for common errors such as:
    • The wrong/unintended API Key is being referenced in Manifest.
    • Billing isn't enabled on Project.
    • The SDK isn't enabled on project APIs.
    • The incorrect SHA-1 fingerprint is added to the API Key restrictions.
    • The Google Play Service dependencies is not included in the build.gradle file.

URL signing

Can I sign URLs using JavaScript?

We strongly recommend against signing URLs using JavaScript as this would expose your URL signing secret to end users. Therefore signatures should only be generated by server side components.

Why am I receiving a HTTP 403 Forbidden response to my Maps API web service requests?

An HTTP 403 response indicates a permission issue, likely because the signature couldn't be verified for this request. This could be because:

  1. A signature has been specified but is incorrect for this request.
  2. The request specifies a Google Maps Platform Premium Plan an API key but does not specify a signature, and the service being called requires that requests made using an API key include a valid signature.
  3. A signature has been specified but the associated Google Maps Platform Premium Plan API key has not been specified.