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

Данная страница предназначается только для пользователей новой версии Google Maps APIs Premium Plan, которая была выпущена в январе 2016 г.

У вас есть лицензия на ранее выпускавшиеся продукты 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 помогает отслеживать использование Google Maps APIs вашим приложением и расходование кредитов Maps API. С помощью этого инструмента можно просматривать подробные ежедневные и ежемесячные отчеты по всем API в составе Google Maps APIs Premium Plan. Данные отчетов доступны для запросов API, которые содержат идентификатор клиента или идентификатор проекта.

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

Типы отчетов

Отчет об успешных запросах

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

  • Ошибки запросов. Для каждого API в ежедневном отчете также отображается количество успешно выполненных и невыполненных (из-за ошибки) запросов. Для API веб-служб, к которым ваше приложение обращается с помощью идентификатора клиента, в отчете также приводятся коды ошибок, которые применяются для диагностики и устранения проблем.
  • Данные канала. Вы можете включать в свои запросы параметр channel, чтобы в отчете об успешных запросах отображалось распределение запросов API по приложениям, использующих одинаковый идентификатор клиента (например, по доступу из внешней и внутренней сети). С помощью каналов вы можете создавать более подробные отчеты по использованию вашего приложения.

Отчет о кредитах Maps API

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

Возможности отчетов

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

  • История данных. Вы можете просматривать отчеты за любой период в течение последнего года.
  • Возможность загрузки данных. Вы можете загрузить данные по количеству запросов за месяц и использованию кредитов в файл значений, разделенных запятыми (CSV), для дальнейшего анализа в электронных таблицах или системах бизнес-аналитики, или для передачи другим лицам.
  • Многоуровневый доступ к данным. Вы можете получать доступ к ежедневным отчетам из ежемесячных отчетов, нажимая итоги месяца или заголовки столбцов отчета. Например:

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;">

Доступ к отчетам об использовании

Доступ к отчетам об использовании Google Maps осуществляется следующим образом.

  1. Выполните вход в Google Cloud Support Portal.
  2. В левой панели нажмите Maps: Usage Report.

Создание отчетов

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

Фильтр Описание
Client ID
Доступен только при использовании нескольких идентификаторов клиента. Выбирает идентификатор клиента, для которого вы хотите посмотреть отчеты.
Channel ID
Доступен только в отчетах об успешных запросах. Выбирает канал, для которого вы хотите посмотреть данные об использовании. Также вы можете выбрать пункт Show all, чтобы просмотреть данные об использовании для всех каналов.
From / To Выбирает диапазон дат отчета продолжительностью до 1 года. Нажмите Update для создания нового отчета.
Type of report
Вы можете выбрать отчет Successful Requests или Maps APIs Credits.
Select time granularity Вы можете выбрать тип отчета Monthly или Daily. В месячных отчетах также содержатся ссылки на дневные отчеты. В дневных отчетах показаны успешные и неудачные запросы, а также коды ошибок.
API type Доступен только для дневных отчетов. Выберите API, для которого хотите просмотреть отчет.

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

Отчет об успешных запросах

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

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

Что такое загрузки карты Google Maps JavaScript API? Чем они отличаются от просмотров страниц?

В Google Maps APIs Premium Plan использование Google Maps JavaScript API оценивается по загрузкам карты, т. е. по фактическому отображению карт на странице. Загрузки карт отличаются от просмотров страниц, которые использовались для расчета использования Maps JavaScript API с предыдущими лицензиями на Maps API for Business или Maps APIs for Work. Дополнительную информацию см. в документе Ограничения и цены на использование.

Почему количество загрузок карт на наших серверах не соответствует статистике доступа?

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

  • Использование карт на странице может быть различным. Загрузка карты генерируется каждый раз, когда на странице создается объект google.maps.Map. При сравнении отчетов о загрузке карт со статистикой доступа своего сервера внимательно анализируйте использование карт на каждой из ваших страниц, чтобы найти причины расхождений, например, следующие:
    • На странице содержится несколько карт, поэтому создается несколько объектов Map.
    • Карта не отображается на странице, но объект Map был создан. Например, это может произойти, если объект Map прикреплен к скрытому элементу HTML div.
    • Страница требует, чтобы пользователь выполнил какое-то действие (например, нажал кнопку) для отображения карты. Если пользователь не выполняет это действие, объект Map не создается.
    • На странице нет карт, и поэтому объект Map не создается.
  • Разница часовых поясов. Отчеты основаны на журналах, которые ведутся по тихоокеанскому стандартному времени. Вы можете анализировать свои журналы сервера по тихоокеанскому стандартному времени, чтобы избежать смещений во времени, вызванных использованием местного часового пояса.
  • Кэширование кода HTML. Загрузки карт не кэшируются. Если пользователь перезагружает вашу страницу, при перезагрузке будет сгенерирована еще одна загрузка карты для получения токена сеанса. Однако в этом случае браузер может загрузить код HTML из кэш-памяти, в результате чего число загрузок карт будет выше числа загрузок страницы в журнале вашего сервера.
Почему запросов Google Maps Distance Matrix API больше, чем ожидалось?

В отчете Google Maps Distance Matrix API отображается количество элементов (пар "исходная точка-точка назначения"), а не запросов. Подробную информацию об элементах можно найти в руководстве для разработчиков.

Ошибки запросов

Как просмотреть ошибки запросов моего приложения?

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

Что означают коды состояния?

Инструмент отчетов об использовании отображает коды состояния API веб-служб, которым ваше приложение отправляет запросы с использованием идентификатора клиента. Вы можете найти описания кодов в руководстве для разработчиков по каждому API:

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

Расходуются ли кредиты Maps API в случае ошибок?

Нет. Если в ответ на запрос поступает код ошибки, кредиты не расходуются. Однако если в ответ на запросы поступают коды OK или ZERO_RESULTS, кредиты расходуются.

Данные каналов

Что такое каналы?

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

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

Какие API поддерживают каналы?

Отчеты по каналам доступны для приложений, использующих Maps JavaScript API, Static Maps API, Street View Image API и веб-службы Google Maps APIs. Каналы не поддерживаются Geolocation API, Places API, Roads API и пакетами Maps Mobile SDK.

Сколько каналов можно использовать?

На каждый идентификатор клиента можно использовать до 2 000 отдельных каналов.

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

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

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

Параметр channel добавляется в запросы следующим образом.

API на стороне клиента

Добавьте параметр channel к значению src тега script:

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

Статические карты и Street View API

Добавьте следующий параметр channel в URL запроса:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Веб-службы

Добавьте следующий параметр channel в URL запроса:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Отчет о кредитах Maps API

Что такое кредиты Maps API?

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

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

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