Часто задаваемые вопросы о платформе 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 на моем сайте?

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

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

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

См. также:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API-ключ:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для получения дополнительной информации см. FAQ платформы Google Maps Root CA Migration и FAQ Google Trust Services .

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

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

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

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

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

Как Google Maps Platform Apis использует куки -файлы сайта?

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

Я не могу найти ответ на свой вопрос. С кем мне связаться?

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

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

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

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

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

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

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

При определенных обстоятельствах может отображаться затемненная карта или «отрицательное» изображение уличного вида, водянированное с текстом «только для целей разработки». Это поведение обычно указывает на проблемы с ключом 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 , вы можете использовать устаревшую версию мест SDK для Android или места 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, если ваш ключ уже используется с API Maps JavaScript.

Google Maps Platform Services

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

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

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

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

Чтобы увидеть страны, поддерживаемые Google Maps Platform Geoocoders, обратитесь к данным охвата Google Maps .

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

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

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

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

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

  • Укажите адреса в соответствии с форматом, используемым Национальной почтовой службой соответствующей страны.
  • Не указывайте дополнительные элементы адреса, такие как названия бизнеса, номера единиц, номера этажей или номера наборов, которые не включены в адрес, как определено почтовой службой соответствующей страны. Это может привести к ответам с ZERO_RESULTS .
  • Формат плюс коды, как показано здесь (плюс знаки с URL-эскапированием до %2B , а пространства с URL-эскапированы до %20 ):
    • Глобальный код представляет собой код площадью 4 символов и 6 или более длинный локальный код (849VCWC8+R9 - 849VCWC8%2BR9 ).
    • Составной код представляет собой 6 или более длинный локальный код с явным местоположением (CWC8+R9 Mountain View, CA, USA IS 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 Routes поддерживает всех партнеров Google Transit , за исключением Индийской корпорации по питанию и туризму железной дороги и тех, кто находится в Японии.

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

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

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

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

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

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

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

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

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

Обратите внимание, что карты статических URL -адресов API могут содержать максимум приблизительно 8 192 символа, что ограничивает количество маркеров и вершин пути, которые могут быть указаны на основе количества десятичных мест, используемых при определении каждой пары широты/долготы. Для получения информации о том, как количество используемых десятичных знаков, связано с точностью на земле, см. В статье Википедии о десятичных градусах .

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

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

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

Для исправления места или бизнес -листинга предложите редактирование .

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

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

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

Некоторые функции на стороне клиента предназначены для того, чтобы сообщать о успехе или сбое с целью расчета SLO (цель уровня обслуживания). Эта информация отправляется в Google по адресу maps.googleapis.com/maps_api_js_slo/log в вызовах, которые вводят информацию SLO. Эта информация включает в себя статус успеха, задержку и версию/канал карт 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 meta-meta.

API JavaScript Карт

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

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

Google Maps SDK для iOS

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

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

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

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

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

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

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

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

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

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

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

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

Google Maps SDK для Android

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

Общей причиной того, что пустая серая плитка отображается вместо карты, является проблем с аутентификацией. Вы можете выполнить шаги ниже, чтобы решить эти проблемы, используя ADB LogCat.

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

Подписание URL

Могу ли я подписать URL -адреса, используя JavaScript?

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

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

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

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