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

Начиная

Понимание условий обслуживания

Ограничения использования и выставление счетов

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

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

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

Карты JavaScript API

SDK Google Карт для iOS

SDK Google Карт для Android

Подписание URL

Начиная

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

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

Карты:

Маршруты:

Места:

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

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

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

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

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

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

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

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

Также см:

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

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

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

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

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

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

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

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

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

Рабочий стол
  • Текущая версия Microsoft Edge (Windows)
  • Текущая и предыдущая версии Firefox (Windows, macOS, Linux)
  • Текущая и предыдущая версии Chrome (Windows, macOS, Linux)
  • Текущая и предыдущая версии Safari (macOS)

Чтобы высвободить ресурсы для предоставления запрошенных клиентами функций, доступных для современных браузеров, платформа Google Карт прекращает поддержку Internet Explorer 11. Microsoft прекратила поддержку IE11 в 2021 году и призвала к переходу на Microsoft Edge.

Начиная с августа 2021 года пользователям Internet Explorer 11 в верхней части карт стало появляться предупреждающее сообщение. Последняя версия Maps JavaScript API для поддержки Internet Explorer 11 — v3.47. Поддержка Internet Explorer 11 будет полностью прекращена в ноябре 2022 года. Это также относится к режиму IE в Edge.

Андроид
  • Текущая версия 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 Карт доступны по адресу:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ограничения использования и выставление счетов

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

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

API Лимит использования
Проверка адреса 6000 импульсов в минуту
Направления 50 запросов в секунду
Матрица расстояний 1000 EPS
Высота 100 запросов в секунду
Геокодирование 50 запросов в секунду
Геолокация 100 запросов в секунду
Динамические карты 500 запросов в секунду
Статические карты 500 запросов в секунду
API изображений Просмотра улиц 500 запросов в секунду
Часовой пояс 500 запросов в секунду
Места (кроме мобильных) 100 запросов в секунду
Дороги 500 запросов в секунду

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

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

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

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

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

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

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

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

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

  • Плата за статическую панораму Просмотра улиц взимается за каждый запрос к API Street View Static для встраивания статической (неинтерактивной) панорамы Просмотра улиц.
  • Плата за динамическую панораму Просмотра улиц взимается за каждый экземпляр объекта панорамы в приложении 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 .

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

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

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

Примечание. У четырех API веб-служб есть эквивалентная служба на стороне клиента, доступная в API JavaScript Карт: Directions , Distance Matrix , Elevation и Geocoding .

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

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

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

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

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

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

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

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

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

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

См. прайс-лист для обзора стоимости API. Если ваше приложение генерирует запросы или объемы загрузки карты до 200 долларов США в месяц, плата за использование не взимается. Использование, превышающее ежемесячный кредит в размере 200 долларов США, будет взиматься с вашего платежного счета. Дополнительные сведения см. в нашем руководстве по выставлению счетов на платформе Google Карт .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Каждый раз, когда вы используете продукты платформы Google Карт, вы должны включать ключ API для проверки вашего запроса. Платформа Google Maps доступна для 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 (веб-сайты) — для использования с веб-API .
    • Ограничение приложений Android (по имени пакета и отпечатку пальца) — для использования с Maps SDK для Android .
    • Ограничение приложения iOS (по идентификатору пакета iOS) — для использования с Maps SDK для iOS .
  • Вы также можете добавить ограничение API к ключу API. Дополнительные сведения см. в разделе Получение, добавление и ограничение ключа API .

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

API/SDK Ограничение учетных данных и приложений
Карты SDK для Android Ключ API с ограничением Android 1
Places SDK для Android Ключ API с ограничением Android 1
Карты SDK для iOS Ключ API с ограничением iOS 1
Places SDK для iOS Ключ API с ограничением iOS 1
Карты JavaScript API Ключ API с ограничением реферера HTTP 1
Статический API Карт Ключ API с ограничением реферера HTTP 1 + цифровая подпись 2
Статический API Просмотра улиц Ключ 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
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 Карт .
Как найти изменения, внесенные в каждую версию API Карт Google?

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

You can also check which version of the Google Maps Platform a particular bug was introduced and fixed in using the Google Maps Platform Issue Tracker at:

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

How can I load the API into a page asynchronously after the page has loaded?

Just specify the callback parameter when loading the API. More information and sample code can be found in the Getting Started chapter of the Maps JavaScript API documentation.

How can I get Google Maps Platform products to display in a language other than English?

By default the API will attempt to load the most appropriate language based on the users location or browser settings. Some APIs allow you to explicitly set a language when you make a request. More information on how to set the language is available in the documentation for each API:

Supported Languages:

Google often updates supported languages. This list may not be exhaustive and is subject to change.

Language Code Language Language Code Language
af Afrikaans ja Japanese
sq Albanian kn Kannada
am Amharic kk Kazakh
ar Arabic km Khmer
hy Armenian ko Korean
az Azerbaijani ky Kyrgyz
eu Basque lo Lao
be Belarusian lv Latvian
bn Bengali lt Lithuanian
bs Bosnian mk Macedonian
bg Bulgarian ms Malay
my Burmese ml Malayalam
ca Catalan mr Marathi
zh Chinese mn Mongolian
zh-CN Chinese (Simplified) ne Nepali
zh-HK Chinese (Hong Kong) no Norwegian
zh-TW Chinese (Traditional) pl Polish
hr Croatian pt Portuguese
cs Czech pt-BR Portuguese (Brazil)
da Danish pt-PT Portuguese (Portugal)
nl Dutch pa Punjabi
en English ro Romanian
en-AU English (Australian) ru Russian
en-GB English (Great Britain) sr Serbian
et Estonian si Sinhalese
fa Farsi sk Slovak
fi Finnish sl Slovenian
fil Filipino es Spanish
fr French es-419 Spanish (Latin America)
fr-CA French (Canada) sw Swahili
gl Galician sv Swedish
ka Georgian ta Tamil
de German te Telugu
el Greek th Thai
gu Gujarati tr Turkish
iw Hebrew uk Ukrainian
hi Hindi ur Urdu
hu Hungarian uz Uzbek
is Icelandic vi Vietnamese
id Indonesian zu Zulu
it Italian

You can see what the map will look like in any of the languages listed above in this sample application .

Can the Google Maps Platform be accessed over SSL (HTTPS)?

The Maps JavaScript API, Maps Static API, and Web Service APIs can be accessed over secure (HTTPS) connections. Please see the documentation for the API concerned for information on how to access the API over SSL.

Note that the Maps Static API does not support custom icon URLs that use HTTPS; the default icon will be displayed.

How do I report a bug or request a new feature in the Google Maps Platform?

If you experience behavior that you believe may be a bug, please begin by raising it in the relevant forum . This will allow other developers to validate the bug, and rule out any potential issues with your code.

If you wish to request a feature, please also 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 the Google Maps Platform products, please report your bug or feature request using the Google Maps Platform Issue Tracker .

Before adding a bug or feature request to the Issue Tracker please 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, please 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 easily 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

What does this error mean?

If you encounter an error while loading or running the Google Maps APIs, please 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 QPS 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 the 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 currently supported by the Google Maps Platform geocoders, please 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. Please note that the availability of geocoding data depends on our contracts with data providers, so it is subject to change.

Why do the 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.
  • Do not 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.
  • Do not 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 pros and cons of different geocoding strategies.

How do I provide driving directions with the Google Maps Platform?

The Directions API allows you to 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). The service is available in the following forms:

In which countries are driving directions available?

To see countries currently supported by Driving Directions in the Google Maps Platform products, consult the Google Maps coverage data . Please note that 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 Directions API and Distance Matrix API support all Google Transit partners , except 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. Documentation and examples can be found here .

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 here .

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
  • Closed roads
  • 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. Please note that you may need to allow maps.googleapis.com in your Content Security Policy to ensure 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.

Maps JavaScript API

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

In Xcode 12, apps do not build correctly for the simulator. How can I fix this?

To fix this issue, open your Xcode project Build Settings, and add arm64 to the Excluded Architectures for "iOS Simulator" builds only.

For more information, see the following StackOverflow thread .

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. Please 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.
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 . GMSMapView now allows you 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 allows you to 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 will allow you to add padding from the screen edge while always ensuring 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 ensure 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 to ensure 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. Please 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 here .
  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 SHA1 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 could not 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.