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

Начиная

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

Лимиты использования и выставление счетов

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

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

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

API JavaScript Карт

SDK Google Карт для iOS

SDK Google Карт для Android

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

Начиная

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

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

Карты:

Маршруты:

Места:

Среда:

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

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

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

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

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

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

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

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

См. также:

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

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

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

Чтобы интегрировать карты в приложение 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.

Какие веб-браузеры поддерживают 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 Карт, чтобы быть в курсе новостей о различных предложениях Google Geo для разработчиков.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Лимиты использования и выставление счетов

Как настроить выставление счетов для моего проекта?
См. раздел Начало работы с платформой Google Maps .
Как клиенты Google Cloud Free Tier могут перейти на платную учетную запись?
Программа Google Cloud Free Tier предоставляет клиентам бесплатную пробную версию с кредитом в размере 300 долларов США для использования с любым сервисом Google Cloud, включая API Google Maps Platform (GMP). После окончания бесплатного пробного периода вам необходимо перейти на платную учетную запись , чтобы продолжить пользоваться этими сервисами. Чтобы перейти на платную учетную запись, посетите Cloud console .
Есть ли ограничения по использованию платформы 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 просмотра изображений улиц 30 000 QPM
Часовой пояс 30 000 QPM

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

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

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

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

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

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

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

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

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

  • Плата за статическую панораму 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 Maps Platform, API вернет сообщение об ошибке. Если вы неоднократно превысите лимиты, ваш доступ к API может быть временно заблокирован.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Каждый раз, когда вы используете продукты Google Maps Platform, вы должны включить ключ API для проверки вашего запроса. Google Maps Platform доступен для 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
Место 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
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 часто обновляет поддерживаемые языки. Этот список может быть неполным и может быть изменен.

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

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

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

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

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

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

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

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

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

После того, как вы подтвердили, что вы определили новую ошибку, или что ваши требования не могут быть выполнены благодаря существующей функциональности продуктов платформы 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 не был указан.