Часто задаваемые вопросы

В настоящем документе даются ответы на вопросы, относящиеся к Google Maps APIs Premium Plan.

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

Начало работы

Лицензии и обновления на ранее выпускавшиеся продукты Google Maps APIs for Work

Приобретение Google Maps APIs Premium Plan

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

Разработка приложения

KML

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

Стилизация

Начало работы

Что такое Google Maps APIs Premium Plan?

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

Какие API включены в Google Maps APIs Premium Plan?

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

* Google Places API не включен в лицензию на Premium Plan Asset Tracking. Если у вас есть лицензия на Asset Tracking и вы хотите использовать Places API, обратитесь в отдел продаж Google Maps.

Следующие API не входят в состав Google Maps APIs Premium Plan. Их использование в приложениях регулируется опубликованными Условиями использования для этих API. На них не распространяется Соглашение об уровне обслуживания Google Maps APIs Premium Plan и техническая поддержка для них не предоставляется.

Как обратиться в техническую поддержку по вопросам, связанным с Google Maps APIs Premium Plan?

Пользователи Google Maps APIs Premium Plan могут зарегистрировать новую заявку на поддержку в службе поддержки Google, используя портал Google Cloud Support Portal по адресу:

https://google.secure.force.com/

Для доступа к порталу требуются имя пользователя и пароль. Заполните эту форму, если у вас нет учетной записи.

Дополнительные сведения см. в руководстве с информацией о поддержке и ресурсах.

Как сбросить учетные данные для Google Cloud Support Portal?

Я забыл пароль. Данная ссылка также доступна на странице входа в Google Cloud Support Portal.

Что такое Условия использования для Google Maps APIs Premium Plan?

Если вы являетесь пользователем Google Maps APIs Premium Plan, условия использования Google Maps APIs приведены в вашем соглашении. Дополнительные сведения см. в условиях использования Google Maps APIs Premium Plan.

Лицензии и обновления на ранее выпускавшиеся продукты Google Maps APIs for Work

Где можно найти информацию о лицензиях на ранее выпускавшиеся продукты Google Maps APIs for Work?

Чтобы определить, какая у вас лицензия на Maps APIs for Work, выполните следующие действия. Перейдите на Google Cloud Support Portal и щелкните Maps: Usage Report слева. Если идентификатор в верхней части отчета представлен в следующем формате, вы используете новый Premium Plan:
gme-[company] & proj-[number] ([type]) В противном случае у вас лицензия на ранее выпускавшийся продукт. Дополнительные сведения см. в руководстве с информацией о лицензиях на Maps APIs for Work.

Какие изменения представлены в новом Premium Plan?

См. обзор изменений для пользователей с обновленными лицензиями и часто задаваемые вопрос об обновлении лицензий.

Приобретение Google Maps APIs Premium Plan

Зачем необходимо приобретать Google Maps APIs Premium Plan?

Вам необходимо приобрести премиум-план для Premium Plan, если вам или вашей организации необходимо следующее:

  • Договор о сервисном обслуживании с круглосуточной поддержкой
  • Возможность продавать продукты или службы со встроенными Google Maps
  • Возможность использовать Google Maps APIs для внутренних приложений или веб-сайтов
  • Определенный объем квот
  • Возможность использовать Google Maps APIs для приложений, отслеживающих использование ресурсов
  • Премиум-функции, доступные для существующей лицензии Maps APIs for Work
Как приобрести Google Maps APIs Premium Plan?

Обратитесь к представителю Google по продажам для получения дополнительной информации о приобретении Premium Plan и ценового предложения с учетом предполагаемых объемов использования вашего приложения.

Необходима ли учетная запись Google для использования Google Maps APIs Premium Plan?

Да, для доступа к Google Maps APIs, предоставляемым на Google API Console, требуется учетная запись Google.

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

Каким образом рассчитывается использование Google Maps APIs Premium Plan?

У вас есть лицензия на ранее выпускавшиеся продукты Maps APIs for Work или Maps API for Business? См. наше Руководство по использованию лицензий на Maps APIs for Work. Чтобы определить, какая у вас лицензия, выполните следующие действия. Перейдите на Google Cloud Support Portal и щелкните Maps: Usage Report слева. Если идентификатор в верхней части отчета представлен в следующем формате, вы используете новый Premium Plan:
gme-[company] & proj-[number] ([type])
В противном случае у вас лицензия на ранее выпускавшийся продукт.

С Google Maps APIs Premium Plan ваше приложение использует квоту по разным расценкам в зависимости от запрашиваемых API. Вы приобретаете квоту, называемую кредитами Maps API, на один год или несколько лет с учетом оценки годового использования API вашим приложением. Все запросы Maps API вашим приложением используют кредиты из пула приобретенных вами кредитов. Например, если ваше приложение использует Google Maps JavaScript API для отображения карты, оно потребляет кредиты при загрузках карты с помощью Maps JavaScript API. Если ваше приложение израсходует все доступные кредиты, вы можете приобрести дополнительные кредиты по мере необходимости. Дополнительную информацию см. в руководстве по расценкам на использование и лимитам Premium Plan.

Как можно контролировать использование Google Maps APIs Premium Plan моим приложением?

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

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

Чтобы примерно рассчитать использование кредитов вашим приложением, можно воспользоваться калькулятором Google Maps APIs Premium Calculator.

Кроме того, вам может помочь пример расчета кредитов.

Что произойдет, если я использую все свои кредиты Maps API?

Если у вас закончатся кредиты Maps API, запросы вашего приложения будут выполняться, но с вашего счета может быть списана плата за превышение лимита. В этом случае вам нужно будет как можно скорее продлить свою лицензию на Google Maps APIs Premium Plan, чтобы избежать приостановки действия вашей учетной записи. Google сообщит вам по электронной почте, когда вы израсходуете 85% своей квоты.

Почему за запросы подробной информации о местах Google Places API было снято 2 кредита Maps API, тогда как запросы службы подсказки мест стоили всего 0,1 кредита?

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

Разработка приложения

Будут ли мне предоставлены идентификатор проекта и идентификатор клиента Google API Console?

Да, ваше приветственное письмо будет содержать ваши идентификатор проекта в Google API Consoleи идентификатор клиента.

Будут ли активированы все доступные API, которые предоставляются мне в проекте Google API Console?

Да, вместе с Premium Plan автоматически предоставляются все API-интерфейсы для того же проекта Google API Console. Вы можете использовать все эти API в одном проекте. API на одной и той же платформе (Web, Web Services, Android, или iOS) могут совместно использовать один и тот же ключ API. Для ключей API предоставляются отчеты об их использовании в режиме реального времени, а также журнал использования за последние 30 дней. Если вам нужны другие функции, такие как Maps API Analytics, отчеты по каждому каналу и журнал с информацией более чем за 30 дней, в большинстве API поддерживается использование идентификатора клиента вместо ключа API. (Идентификатор клиента не работает с Google Places API, Google Maps Geolocation API, Google Maps Roads API, Google Maps Android API или Google Maps SDK for iOS).

В чем разница между ключом API и идентификатором клиента?

С помощью идентификатора проекта можно создавать ключи API в Google API Console. Основные различия в случаях использования ключей API и идентификатора клиента заключаются в следующем.

  • Поддержка API: Ключ API можно использовать с любым Maps API. В отличие от этого, идентификатор клиента можно использовать с любым API, за исключением Google Places API, Google Maps Geolocation API, Google Maps Roads API, Google Maps Android API и Google Maps SDK for iOS.
  • Отчетность: Для ключей API предоставляются отчеты об их использовании в режиме реального времени, а также журнал использования за последние 30 дней. Если вам нужны другие функции, такие как Maps API Analytics, отчеты по каждому каналу и журнал с информацией более чем за 30 дней, используйте идентификатор клиента для API, которые поддерживают его использование.
  • Коды ошибок: При использовании ключей API могут отображаться сообщения об ошибках, оформленные в соответствии с классом кодов статуса HTTP (например, ошибки 3xx и 4xx), которые предоставляют только общую информацию. При использовании идентификатора клиента отчеты Google Cloud Support Portal содержат более подробные коды ошибок по каждому конкретному API, что может быть полезно для устранения неполадок.
  • Безопасность: Ключи API и идентификатор клиента обеспечивают одинаково высокий уровень безопасности при условии соблюдения следующих рекомендаций.
    • Если вы используете ключ API, не передавайте его другим лицам. Все запросы к Maps API используют протокол HTTPS, поэтому риск, что кто-то перехватит передаваемые вами данные, не очень высок. Тем не менее, если кому-то удастся получить ваш ключ, он сможет отправлять запросы к Maps API, используя ваш ключ. Чтобы предотвратить подобный риск для интерфейсов API на стороне клиента, можно ограничить домены, которые могут использовать ваш ключ. Для интерфейсов API на стороне сервера ограничьте ключ таким образом, чтобы запросы могли отправляться только с исходных IP-адресов ваших серверов. Дополнительная информация о безопасном использовании ключей API доступна в Справочном центре консоли разработчика.
    • При использовании идентификатора клиента необходимо обеспечить секретность криптографического ключа, который применяется для создания цифровых подписей. Кроме того, никогда не используйте криптографический ключ в запросах API или для подписи URL-адресов с использованием JavaScript, так как эти методы могут раскрыть ваш ключ посторонним лицам.
Необходимо ли использовать мои учетные Google Maps APIs Premium Plan в моей тестовой среде?

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

  • Если вам необходим доступ к технической поддержке для вашей тестовой среды, вы должны использовать учетные данные из вашей Premium Plan (идентификатор клиента или ключ API). Обратите внимание, что при использовании Maps API будут сниматься кредиты для Maps API вашего плана в зависимости от ограничений и цен на использование.
  • Если вы не хотите, чтобы ваша тестовая среда потребляла кредиты Maps API вашего плана, используйте стандартные учетные данные (ключ API, указанный в Google API Console). Но в этом случае для вашей тестовой среды не будет предоставляться техническая поддержка. Если вы решите использовать стандартные учетные данные, для вашего приложения или веб-сайта будут действовать стандартные ограничения на использование для каждого API. Дополнительную информацию о стандартных ограничениях на использования см. в документе Цены и планы.
  • Если вы рассчитываете обрабатывать значительные объемы данных в своей тестовой среде и нуждаетесь в технической поддержке, но не хотите потреблять кредиты Maps API вашего Premium Plan, рассмотрите вариант приобретения лицензии только для разработки. Как правило, ее стоимость ниже, но при этом вы сможете обращаться за технической поддержкой. За дополнительной информацией обратитесь к своему менеджеру по работе с клиентами Google Maps.
  • Если вы проводите нагрузочные испытания своего приложения, для этого можно использовать фиктивный API. См. раздел Проведите нагрузочные испытания вашего приложения на странице Список проверки перед запуском.
Как получить доступ к функциям Zagat, используя Google Maps APIs Premium Plan?

При использовании Premium Plan запросы, содержащие ваш ключ API для Google Places API Web Service, предоставляют премиум-контент Zagat. Чтобы проверить, имеется ли у вас доступ к контенту Zagat, отправьте запрос к Google Places API Web Service, содержащий ключ из проекта, созданного для вас при регистрации. Пример URL-адреса:

https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants+in+mountain+View,+ca&key=YOUR_API_KEY
Как получить доступ к премиум-функциям, используя Google Maps APIs Premium Plan?

Вы можете получить доступ к премиум-функциям для мобильных устройств, используя те же самые пакеты SDK, которые доступны пользователям стандартного API: Google Maps SDK for iOS и Google Maps Android API. Для доступа к премиум-функциям убедитесь, что вы используете ключ API из проекта, созданного для вас при регистрации. Чтобы проверить, если у вас доступ к премиум-функциям для мобильных устройств, загрузите карту, используя статическую библиотеку. Дополнительную информацию см. в руководствах по началу работы с Premium Plan на Android и на iOS.

Доступна ли динамическая библиотека для Android при использовании Google Maps APIs Premium Plan?

Да, с Premium Plan вы можете также использовать для Google Maps Android API динамическую библиотеку вместо статической. Дополнительную информацию см. в руководствах по началу работы с Premium Plan на Android.

Как получить доступ к Google Maps JavaScript API, используя идентификатор клиента Google Maps APIs Premium Plan со страницы, загруженной по протоколу HTTPS (SSL)?

Чтобы получить доступ к Google Maps JavaScript API со страницы, загруженной по протоколу HTTPS, нужно предварительно авторизовать URL-адреса HTTPS, с которыми вы хотите использовать API.

Как загрузить Google Maps JavaScript API по протоколу HTTPS (SSL) с использованием параметра base_domain загрузчика Common Loader?

Загрузить Maps JavaScript API по протоколу SSL с использованием общего загрузчика с установленным параметром base_domain нельзя.

Параметр base_domain не влияет на производительность приложения. Запросы API всегда обрабатываются наиболее подходящим для конкретного положения пользователя сервером Google Maps, вне зависимости от того, из какого домена загружается API.

Параметр base_domain устанавливает предпочтительные результаты геокодирования для заданной области. Чтобы получить тот же эффект без параметра base_domain, нужно установить параметр region для службы геокодирования.

KML

Как прорисовать на карте файлы KML, хранящиеся на узлах внутренней сети?

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

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

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

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

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

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

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

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

Стилизация

Почему на карте не отображаются организации?

При загрузке карты с помощью Google Maps JavaScript API с параметром client отображение организаций на карте по умолчанию отключено. Чтобы включить его, нужно добавить на карту код стилизации:

var styles = [
  {
    featureType: 'poi.business',
    stylers: [
      { visibility: 'on' }
    ]
  }
];

map.setOptions({styles: styles});