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

Начиная

Ознакомьтесь с условиями предоставления услуг.

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

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

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

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

API карт на JavaScript

Google Maps SDK для iOS

Google Maps SDK для Android

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

Начиная

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

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

Карты:

Маршруты:

Места:

Среда:

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

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

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

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

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

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

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

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

См. также:

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

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

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

Для интеграции карт в Android-приложение используйте Maps SDK для Android .

Для интеграции карт в iOS-приложение используйте Maps SDK для iOS .

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

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

Какие веб-браузеры поддерживают API JavaScript для работы с картами и API встраивания карт?

API для работы с картами на JavaScript и API для встраивания карт поддерживают следующие веб-браузеры:

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

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

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

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

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

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

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

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

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

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

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

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

Можно ли использовать SDK «Карты и места» для iOS на компьютерах Mac с процессорами Arm?

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

Ознакомьтесь с условиями предоставления услуг.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как мне настроить выставление счетов за свой проект?
См. раздел «Начало работы с платформой Google Maps» .
Что такое бесплатная пробная версия Google Cloud и как пользователи бесплатной пробной версии могут перейти на платный аккаунт?

Бесплатная пробная версия Google Cloud — это 91-дневная программа, которая позволяет новым пользователям опробовать самые популярные продукты Google Cloud, включая API Google Maps Platform (GMP), без каких-либо финансовых обязательств. Регистрация в рамках бесплатной пробной версии создает учетную запись для бесплатной пробной версии, на которую предварительно поступает приветственный кредит в размере 300 долларов, который вы можете потратить на GMP.

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

Есть ли ограничения на использование платформы Google Maps?

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

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

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

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

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

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

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

Чтобы узнать больше о порядке оплаты API платформы Google Maps, см. раздел «Обзор ценообразования и оплаты платформы Google Maps» .

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

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

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

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

  • За каждый запрос к API Street View Static взимается плата за встраивание статической (неинтерактивной) панорамы 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 Maps» , «Мониторинг платформы Google Maps» и «Установка лимита квоты» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Установление максимального суточного лимита оплачиваемых услуг:

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

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

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

Я получил сообщение о том, что мой проект привязан к "переходному аккаунту Google Maps Platform", но у меня нет доступа к этому аккаунту. Что мне делать?

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

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

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

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

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

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

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

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

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

Ключ API:

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

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

  • Цифровая подпись генерируется с использованием секретного ключа для подписи URL-адреса, предоставленного вам компанией Google. Цифровые подписи используются с API статических карт и API статических улиц.

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

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

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

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 Referer 1
API картографических тайлов Ключ API с ограничением по IP-адресу 1
API наборов данных карт токен OAuth
API для просмотра с воздуха Ключ API с ограничением по IP-адресу 1
Статический API карт API-ключ с ограничением HTTP Referer 1 + Цифровая подпись 2
Статический API для просмотра улиц API-ключ с ограничением HTTP Referer 1 + Цифровая подпись 2
API для встраивания карт API-ключ с ограничением HTTP Referer 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. В зависимости от контекста использования, для API статических карт и API статических видов улиц может потребоваться цифровая подпись. Независимо от контекста, мы настоятельно рекомендуем использовать как ключ API, так и цифровую подпись для аутентификации ваших запросов.
Как изменить тип ограничения по ключу с ограничения по HTTP-рефереру на ограничение по IP-адресу?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для получения дополнительной информации см. разделы «Часто задаваемые вопросы о миграции корневого центра сертификации Google Maps Platform» и « Часто задаваемые вопросы о сервисах доверия Google» .

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

If you experience behavior that you believe may be a bug, 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.

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.

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

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

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

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 для 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.
Is hardware acceleration required for the Google Maps SDK for Android?
Yes, hardwareAccelerated must be set to true in your app's AndroidManifest.xml file in order to prevent issues with map loading.
For more information, see the Hardware acceleration page in the Android developer documentation.

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

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.