Квота и отчеты

Эта страница предназначена только для пользователей, которые владеют лицензией на ранее выпускавшиеся продукты Maps APIs for Work или Maps API for Business. Эта страница не предназначена для пользователей нового продукта Google Maps APIs Premium Plan, который стал доступен в январе 2016 года.

Квота

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

  • Одна загрузка Google Maps JavaScript API на страницу.
  • Один запрос изображения Google Street View Image API или Google Static Maps API.
  • Одна загрузка Google Earth API на страницу.

Взаимодействие пользователя с картой, такое как сдвиг, масштабирование или изменение типа карты, не создает дополнительных просмотров страниц.

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

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

Отчеты

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

  • Подробную информацию об использовании Google Maps APIs for Work для тарификации можно получить в отчетах на вкладке Maps: Usage Report в Google Cloud Support Portal.

  • Чтобы узнать, как пользователи взаимодействуют с вашим приложением Google Maps JavaScript API, вы можете включить Analytics for Google Maps APIs for Work.

Отчеты об использовании

Google Cloud Support Portal предоставляет подробные отчеты по Google Maps JavaScript API и API изображений Google Maps.

После входа на портал нажмите Maps: Usage Report в левой панели навигации. Вы можете использовать фильтрацию по каналу и по диапазону дат.

В этих отчетах представлены те же данные, которые Google применяет для тарификации на основе использования.

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

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

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

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

Параметр channel имеет следующий формат:

  • Должен представлять собой буквенно-цифровую строку ASCII. Разрешены символы: точка (.), подчеркивание (_) и дефис (-).
  • В параметре channel не учитывается регистр; параметры channel в верхнем, смешанном и нижнем регистре будут объединены в эквивалентный параметр в нижнем регистре. Например, данные по каналу CUSTOMER будут объединены с данными по каналу customer.
  • Значение channel должно представлять собой статическое значение, присваиваемое каждому экземпляру приложения, и не должно генерироваться динамически. Например, нельзя использовать значения channel для отслеживания отдельных пользователей.

Допускается использование до 2 000 отдельных каналов на один идентификатор клиента.

Параметр channel нужно указывать после значения src в теге script:

<script src="https://maps.googleapis.com/maps/api/js?v=3&client=gme-yourclientid&channel=YOUR_CHANNEL"></script>

Analytics for Google Maps APIs for Work

С помощью Analytics for Google Maps APIs for Work вы можете узнать, как люди взаимодействуют с вашими картами. Это позволит вам улучшить свое приложение на основе реальной статистики использования. Analytics for Google Maps APIs for Work позволяет получать ответы на следующие вопросы.

  1. Какой уровень масштабирования и тип карты используются чаще всего?
  2. Для каких стран пользователи запрашивают результаты геокодирования?
  3. Как часто используются службы JavaScript?

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

Этот отчет *Zoom Interactions* показывает, что для сайтов, связанных
с указанным идентификатором клиента, большинство пользователей применяли уровни масштабирования от 4 до
7.

Доступ к Analytics

Откройте Google Cloud Support Portal и выберите Maps: Analytics из предложенного списка ресурсов. Если к вашей учетной записи привязано несколько идентификаторов клиента, при каждом входе в Analytics вам будет предложено выбрать идентификатор клиента и канал, который вы хотите использовать.

Активация Analytics для идентификатора клиента

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

Если вы не собираетесь использовать параметр channel, а сам канал при загрузке библиотеки JavaScript не указан, менять существующий код нет необходимости.