Панель Google Maps APIs for Work Usage Dashboard

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

Обзор

Панель Google Maps APIs for Work Usage Dashboard содержит подробные отчеты, помогающие отслеживать использование и состояние вашего приложения сMaps APIs for Work. Данные в отчете доступны для всех запросов, в которых используется идентификатор клиента.

Панель Usage Dashboard позволяет легко и быстро просматривать следующие данные вашего приложения.

  • Просмотры страниц, использование клиентских служб и веб-служб
  • Число запросов в секунду (QPS) для веб-служб
  • Просмотры страниц и использование веб-служб по домену
  • Доля успешных запросов и ошибок веб-служб

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

Преимущества отчетов

Отчеты в панели Google Maps APIs for Work Usage Dashboard полезны для разработки приложений, маркетинга и закупок. Например, с их помощью выполняются следующие действия.

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

Содержание отчетов

Данные Клиент/веб API/службы в отчете
Просмотры страниц Клиент JavaScript, Static Maps, Street View
Просмотры страниц по доменам Клиент JavaScript, Static Maps, Street View
Запросы служб Клиент Geocoding, Directions, Elevation
Запросы служб Веб Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Запросы служб по доменам Клиент Geocoding, Directions, Elevation
Число запросов в секунду (QPS) Веб Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Доля успешных запросов служб Веб Geocoding, Directions, Elevation, Time Zone
Ошибки при запросе служб Веб Geocoding, Directions, Distance Matrix, Elevation, Time Zone

Примечание. Панель с информацией об использовании не включает отчеты по Google Places API, Google Maps Geolocation API, Google Maps Roads API и Google Maps Mobile SDK for Work.

Войти в панель Usage Dashboard

Первый вход

Перед первым входом в панель Usage Dashboard необходимо связать с ней свою учетную запись Google. Если у вас еще нет учетной записи Google, в этой статье вы найдете инструкции по ее созданию.

  1. Выполните вход в Google Cloud Support Portal.
  2. На панели слева нажмите Maps: Usage Report.
  3. Выберите пункт Access the new Usage Dashboard.
  4. Следуя указаниям, выберите учетную запись Google. При необходимости выполните вход.
  5. Когда появится сообщение, запрашивающее для панели Usage Dashboard разрешение на доступ к вашей учетной записи Google, нажмите Approve. После этого ваша учетная запись Google будет связана с вашей учетной записью Support Portal.

Теперь вы сможете открыть панель Usage Dashboard.

Примечание. Если не удается получить доступ к панели Usage Dashboard, свяжитесь со Службой поддержки.

Вход после первоначальной настройки

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

https://maps-dashboard.appspot.com

Если вы еще не выполнили вход в свою учетную запись Google, введите данные учетной записи, которую вы привязали к панели Usage Dashboard.

Использование отчетов

Просмотр графиков в отчетах

Панель Google Maps APIs for Work Usage Dashboard позволяет просматривать графические отчеты, в которых показаны тенденции за определенные периоды. Чтобы посмотреть в отчете данные по каждому API, наведите курсор мыши на график. Например:

Изменение диапазона дат для отчетов

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

Примечание. На вкладке Web Services можно посмотреть более детализированные данные, например данные по доле успешных запросов к вашему приложению за каждый час. Для этого нужно выбрать диапазон дат в 3 дня или менее.

Изменение диапазона дат:

  1. На вкладке Page Views, Client Services или Web Services нажмите значок календаря изображение значка календаря.
  2. Перейдите в поля дат, чтобы выбрать дату начала и дату окончания.
  3. Нажмите кнопку отметки изображение кнопки отметки.

Новый диапазон дат будет применен к данным на всех вкладках, за исключением вкладки Dashboard.

Примечание. Все временные метки на панели Usage Dashboard, где определены только даты (без указания времени суток), отображают время часового пояса PST (тихоокеанское время США). При выборе короткого диапазона дат на вкладке Web Services будут отображаться более точные временные метки (с точностью до часа, минуты или секунды) с учетом местного часового пояса.

Экспорт и анализ данных отчета

Если вы хотите проанализировать данные отчета в других программах или передать их другим пользователям, вы можете экспортировать любые данные с вкладок Page Views, Client Services и Web Services в файл со значениями, разделенными запятой (CSV).

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

Порядок экспорта данных:

  1. Можно изменить диапазон дат отчета.
  2. В нижнем левом углу панели отчетов нажмите изображение кнопки загрузки CSV.
  3. Сохраните файл.

Отчеты о просмотрах страниц

Просмотр кратких сводок за год и за месяц

На панели Page View Consumption на вкладке Dashboard показываются следующие данные вашего приложения:

  • Общее число просмотров страниц за предыдущий год
  • Среднее число просмотров страниц за месяц
  • Среднее число просмотров страниц за день

Совет. Для расчета количества просмотров, которое следует закупить на следующие 12 месяцев, нужно умножить среднемесячное число показов на 12.

На панели Total Requests отображается график просмотров страниц вашего приложения за последние 30 дней.

Подробные сведения о просмотрах страниц

Откройте вкладку Page Views. На панели Total Requests отображается общее число запросов просмотров страниц на каждую дату в выбранном диапазоне дат. На панели справа вы увидите данные, показанные на графике. Также вы можете изменить диапазон дат отчета и экспортировать данные для дальнейшего анализа.

Просмотры страниц по доменам

Откройте вкладку Page Views. На панели By Authorized Domain отображается общее число запросов просмотров страниц на каждый из ваших доменов и для каждого API в выбранном диапазоне дат. Если вы указали параметры канала для запросов вашего приложения, данные по использованию будут распределены по доменам и каналам.

Примечание. В отчете показаны все домены, зарегистрированные в Google Cloud Support Portal для идентификатора клиента, по которому запрашиваются данные о Google Maps APIs.

Также вы можете изменить диапазон дат отчета и экспортировать данные для дальнейшего анализа.

Отчеты по клиентским службам

Просмотр данных по использованию на стороне клиента

Откройте вкладку Client Services. Для каждой даты в выбранном диапазоне на панели Client-Side Services Usage отображается общее число запросов, направленных вашим приложением через JavaScript. На панели справа вы увидите данные, показанные на графике.

Также вы можете изменить диапазон дат отчета и экспортировать данные для дальнейшего анализа.

Просмотр данных по использованию на стороне клиента по доменам

Откройте вкладку Client Services. На панели By Authorized Domain показаны запросы служб со стороны клиента для каждого из ваших доменов на выбранный диапазон дат. Если вы указали параметры канала для запросов вашего приложения, данные по использованию будут распределены по доменам и каналам.

Примечание. В отчете показаны все домены, зарегистрированные в Google Cloud Support Portal для заданного идентификатора клиента.

Также вы можете изменить диапазон дат отчета и экспортировать данные для дальнейшего анализа.

Отчеты по веб-службам

Просмотр данных по числу запросов в секунду (QPS)

Откройте вкладку Web Services. На панели Queries Per Second будут отображены следующие данные для каждого API в выбранном диапазоне дат.

  • Среднее значение QPS вашего приложения
  • Максимальное значение QPS вашего приложения
  • Значение QPS вашего приложения за 99% времени

Для Distance Matrix API в отчете показано число элементов (пары источник-пункт назначения) в секунду, а не число запросов.

Также вы можете изменить диапазон дат отчета.

Совет. Используйте данные о QPS для определения требуемого объема закупки QPS.

Просмотр подробных сведений об использовании веб-служб

Откройте вкладку Web Services. На панели Total Requests показано общее число запросов веб-служб для каждой даты в выбранному диапазоне. Для Distance Matrix API в отчете показано число элементов (пары источник-пункт назначения) в день, а не число запросов.

Также вы можете изменить диапазон дат отчета и экспортировать данные для дальнейшего анализа.

Примечание. На панели справа показана доля успешного выполненных вашим приложением запросов веб-служб и все ошибки, выданные при запросах к вашему приложению. Более подробную информацию см. в разделе "Отчеты о состоянии приложения".

Отчеты о состоянии приложения

Получите краткую сводку данных о состоянии вашего приложения

На вкладке Dashboard вы найдете краткую сводку данных о производительности вашего приложения за последние 2 дня. Эти данные показаны на панели Application Status. Следующие значки обозначают долю успешных запросов веб-служб вашим приложением для получения данных Google Maps APIs:

Значок Описание

Хорошо: не менее 95% запросов были успешно выполнены.

Предупреждение: успешно выполнены 80-94% запросов.

Тревога: успешно выполнены менее 80% запросов.

Нет запросов: ваше приложение не использовало этот API.

Наведите курсор мыши на API для просмотра дополнительной информации.

Проверка доли успешных запросов веб-служб

Откройте вкладку Web Services. На графике на панели % Request Success показана доля успешных запросов веб-служб вашим приложением для выбранного диапазона дат .

Также вы можете изменить диапазон дат отчета и экспортировать данные для дальнейшего анализа.

Проверка ошибок запросов веб-служб

Откройте вкладку Web Services. Под графиком на панели % Request Success вы увидите все коды ошибок, полученные вашим приложением, если доля успешных запросов веб-служб вашим приложением для выбранного диапазона дат составляет менее 100%. Также вы можете изменить диапазон дат отчета. Чтобы посмотреть почасовые данные с временными метками на уровне минут нужно выбрать диапазон дат в 3 дня или меньше. Для дальнейшего анализа и диагностики ошибок нужно экспортировать данные в файл.

На панели Usage Dashboard показаны следующие типы ошибок, которые может получить ваше приложение при запросе веб-служб Google Maps APIs. Информацию о решении проблем см. в [разделе веб-служб Google Maps APIs на сайте для разработчиков.

Код ошибки Описание
OVER_DAILY_LIMIT Ваше приложение направило запрос, выходящий за рамки дневного лимита. При возникновении этой ошибки веб-служба прекращает возвращать данные, пока не будет разрешено дальнейшее использование.
OVER_QPS_LIMIT Число запросов веб-служб в секунду (QPS) вашим приложением превысило лимит. При возникновении этой ошибки веб-служба прекращает возвращать данные, пока не будет разрешено дальнейшее использование.
INVALID_SIGNATURE В запросе вашего приложения используется недействительная цифровая подпись. Дополнительную информацию о подписях и создании подписей см. в разделе цифровых подписейна странице аутентификации и авторизации.
INVALID_REQUEST Веб-службе не удалось выполнить синтаксический анализ запроса вашего приложения. Эта ошибка обычно возникает, когда в запросе отсутствует информация.
INTERNAL_ERROR При обработке запроса вашего приложения произошла ошибка, но веб- служба не указала ее причину.

Поддержка и обратная связь

Получить техническую поддержку

Если вам нужна помощь с панелью Google Maps APIs for Work Usage Dashboard, вы можете создать инцидент на портале поддержки Google Cloud Support Portal.

  1. Выполните вход в Google Cloud Support Portal.
    Примечание. Если у вас нет учетных данных, вы можете запросить доступ к порталу.
  2. Откройте вкладку Cases.
  3. Нажмите Create New Case.
  4. В поле Product Name выберите пункт My product isn’t listed. Затем выберите из раскрывающегося списка пункт Google Maps.
  5. В разделе Group в подразделе Components выберите пунктOther.
  6. Установите приоритет в соответствии со следующими определениями приоритетов.
  7. В описании нужно указать общую информацию о проблеме и шаги, необходимые для ее воспроизведения. Обязательно укажите, что ваша проблема связана с информационной панелью Google Maps APIs for Work Usage Dashboard.

Отправьте нам отзыв

Вы можете предложить новые функции, сообщить о проблеме или отправить другой отзыв о панели Google Maps APIs for Work Usage Dashboard. Хотя мы не можем отвечать на сообщения индивидуально, мы используем ваш отзыв для улучшения панели Usage Dashboard.

  1. Нажмите в правом нижнем углу любой вкладки Dashboard кнопку Send Feedback изображение кнопки отзыва.
  2. Следуйте указаниям на экране.