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

Начиная

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

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

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

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

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

API JavaScript Карт

Google Maps SDK для iOS

SDK Google Карт для Android

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

Начиная

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

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

Карты:

Маршруты:

Места:

Среда:

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

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

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

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

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

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

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

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

См. также:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если вы потеряли доступ к своей учётной записи Google (например, [email protected] или [email protected]), попробуйте восстановить доступ к ней, восстановив или сбросив пароль. См. статью «Как восстановить учётную запись Google или Gmail» в разделе «Справка по учётной записи Google».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API-ключ:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для достижения наилучших результатов при обращении за помощью имейте в виду следующее:

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

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

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

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

Мои карты кажутся темнее, чем обычно. Что происходит?

При определенных обстоятельствах может отображаться затемненная карта или «негативное» изображение Street View с водяным знаком и текстом «только для целей разработки». Такое поведение обычно указывает на проблемы с ключом API или оплатой. Чтобы использовать продукты платформы Google Maps, у вас должен быть платежный аккаунт, а все запросы должны включать действительный ключ API. Следующий поток поможет устранить эту неполадку:


Как устранить коды ошибок: OVER_DAILY_LIMIT или OVER_QUERY_LIMIT ?
Эти коды ошибок могут возвращаться по любой из следующих причин:
  • В запросе отсутствует ключ API.
  • Предоставленный ключ API недействителен.
  • К проекту не привязан платежный аккаунт.
  • Превышен добровольно установленный лимит использования .
  • Указанный способ оплаты больше не действителен (например, срок действия кредитной карты истек).
  • Вы превысили квоту для данного API.

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

Как устранить коды ошибок: kGMSPlacesRateLimitExceeded или 9005 PLACES_API_RATE_LIMIT_EXCEEDED ?
Если вы видите kGMSPlacesRateLimitExceeded или 9005 PLACES_API_RATE_LIMIT_EXCEEDED , возможно, вы используете устаревшую версию Places SDK для Android или Places SDK для iOS. Узнайте больше и найдите новые SDK на странице https://goo.gle/places-sdk-deprecation .
Как устранить ошибку: «Этому IP-адресу, сайту или мобильному приложению не разрешено использовать этот ключ API»?

Существуют различные сценарии, которые могут вызвать эту ошибку:

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

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

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

  1. Перейдите на страницу учетных данных облачной консоли.
  2. Выберите проект, содержащий ключ API, который вы хотите просмотреть.
  3. Чтобы просмотреть сведения об учетных данных, включая любые ограничения, установленные для ключа, в списке ключей API щелкните имя ключа.
  4. Отобразятся полные учетные данные выбранного ключа API, включая все ограничения, установленные для ключа. Отсюда ограничения можно изменять, удалять или обновлять по мере необходимости.
Как устранить ошибку: «Ключи API с ограничениями реферера не могут использоваться с этим API»?

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

Службы платформы Google Карт

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

Да, этот процесс называется «геокодированием». API JavaScript Карт включает класс для выполнения службы геокодирования. Класс: google.maps.Geocoder .

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

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

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

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

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

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

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

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

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

Геокодер платформы Google Maps требует, чтобы пронумерованные автомагистрали США были указаны в адресах следующим образом:

  • Дороги округа: "Co Road NNN " , где NNN — номер дороги. например. "Co Road 82"
  • Шоссе штата: " State NNN " , где «Штат» — полное название штата, а NNN — номер шоссе. например. "California 82"
  • Шоссе США: "US NNN " , где NNN — номер шоссе. например. "US 101"
  • Межштатные автомагистрали США: "Interstate NNN " , где NNN — межштатный номер. например. "Interstate 280"
Когда мне следует использовать класс геокодера API, а когда следует использовать службу геокодирования HTTP?

См. документ «Стратегии геокодирования» , в котором подробно описаны преимущества и ограничения различных стратегий геокодирования.

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

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

Интерфейс HTTP-запроса/ответа (используемый в мобильных и других приложениях) совместим с Maps SDK для Android и другими веб-службами Google Maps.

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

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

В каких странах доступны транзитные направления?

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

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

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

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

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

Как отобразить на карте файлы KML, размещенные на сайтах интрасети?

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

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

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

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

Обратите внимание, что URL-адреса Maps Static API могут содержать максимум около 8192 символов, что ограничивает количество маркеров и вершин пути, которые можно указать, в зависимости от количества десятичных знаков, используемых при указании каждой пары широты и долготы. Информацию о том, как количество используемых десятичных знаков связано с точностью на Земле, см. в статье Википедии «Десятичные градусы» .

Почему я не могу получить доступ к продуктам платформы Google Maps для некоторых стран?

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

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

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

Если контент Карт необходимо удалить по юридическим причинам, отправьте юридический запрос.

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

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

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

API JavaScript Карт

Как долго API JavaScript Карт будет работать после загрузки?

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

SDK Google Карт для iOS

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

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

  1. В XCode выберите «Продукт» , «Схема» , «Управление схемами» .
  2. Выберите схему и выберите «Редактировать...» .
  3. Установите для параметра «Захват кадров графического процессора» значение «Отключено» . Обратите внимание, что эта опция может быть доступна не для всех устройств.
Параметр захвата кадров Xcode GPU на странице универсального устройства iOS
Как закругленные и более широкие экраны повлияют на SDK Google Maps для iOS?

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

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

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

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

Если вы разработали интерфейс, который не работает с нашей настройкой по умолчанию, мы добавили в GMSMapView новое свойство, называемое paddingAdjustmentBehavior . Используйте GMSMapView, чтобы выбрать один из трех вариантов настройки заполнения: «Всегда» (по умолчанию), «Автоматически» и «Никогда».

Если GMSMapView настроен на использование заполнения «Всегда», он всегда будет добавлять вставки безопасной области к заполнению. Этот параметр позволяет проектировать интерфейс, предполагая, что все размещение происходит с краев безопасной области. Это значение по умолчанию.

Если GMSMapView настроен на использование «Автоматического» поведения заполнения, он всегда будет выбирать большее из значений заполнения или вставки безопасной области. Этот параметр позволяет добавлять отступы от края экрана, следя за тем, чтобы все элементы оставались в пределах безопасной области.

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

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

SDK Google Карт для Android

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

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

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

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

Могу ли я подписывать URL-адреса с помощью JavaScript?

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

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

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

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