Отчеты платформы Google Карт

Отчеты на платформе Google Maps предоставляют набор предопределенных визуальных отчетов об основном использовании API, квотах и ​​платежной информации в Google Cloud Console. Используйте эти отчеты, чтобы определить количество совершенных вами вызовов API, насколько вы близки к достижению квоты на использование API, а также отслеживать использование счетов с течением времени.

К типам отчетов относятся:

• Отчеты об использовании . Сообщают о количестве запросов, которые ваш проект отправляет к API платформы Google Maps с использованием учетных данных, связанных с вашим проектом.
• Отчеты о квотах : отчеты об использовании квот в виде графиков, которые можно сгруппировать по количеству запросов в минуту. Текущие ограничения квот для выбранных API отображаются в таблицах под графиками использования квот.
• Отчеты о выставлении счетов : отчеты о расходах с течением времени в виде составной линейной диаграммы. Просмотрите использование квоты в текущем месяце, включая любые примененные кредиты за использование, а также общую прогнозируемую стоимость за весь текущий месяц.
• отчеты science Engagement : предоставьте бизнес-информацию о том, как пользователи взаимодействуют с вашими картографическими приложениями.

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

Просматривайте отчеты об использовании платформы Google Maps, квотах и ​​выставлении счетов с помощью Cloud Console .

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

Использование зависит от количества запросов, которые ваш проект отправляет к API платформы Google Maps с использованием учетных данных, связанных с вашим проектом. Запросы включают успешные запросы, запросы, приводящие к ошибкам сервера, и запросы, приводящие к ошибкам клиента. Учетные данные включают ключи API и идентификаторы клиентов (для плана Premium и перенесенных проектов плана Premium). Подробную информацию см. в обзоре премиум-плана и информации об использовании идентификатора клиента .

Метрики использования отображаются в таблицах (запросы, ошибки и задержка) и графиках (трафик, ошибки и задержка). В целях отслеживания:

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

  • Фильтровать по периоду времени и API.
  • Просматривайте трафик, ошибки и задержку, сгруппированные по коду ответа, API и учетным данным.

• Определенный API . Вы можете фильтровать и группировать показатели использования для определенного API следующими способами:

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

Страница панели управления API и сервисами

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

• Страница Dashboard содержит три графика и таблицу. Вы можете отфильтровать использование, отображаемое на графиках и таблицах, выбрав период времени от 1 часа до последних 30 дней.

• График трафика показывает использование запросов в минуту (QPM) для каждого API.

• На графике ошибок показан процент запросов, которые привели к ошибкам, по каждому API.

• График задержки показывает среднюю задержку запросов для каждого API.

Под графиками в таблице перечислены включенные API и службы. Запросы — количество запросов (за выбранный период времени). Ошибки — это количество этих запросов, которые привели к ошибкам. Задержка (средняя задержка и процентиль) — это задержка для этих запросов.

Чтобы получить доступ к странице панели управления API и сервисами:

1. Откройте страницу выбора проекта в Cloud Console:

   Страница выбора проекта

2. Выберите свой проект. Появится страница панели мониторинга API и служб.
   
   Если страница не отображается, выберите кнопку меню а затем выберите API и службы .

Дополнительную информацию см. в разделе Мониторинг использования API .

Страница обзора Google Карт

На странице «Обзор Карт Google» есть таблица со списком включенных API и запросов на использование за последние 30 дней. Запросы по API также отображаются в виде графика. График выставления счетов показывает текущий счет и общий объем использования за последние 3 месяца.

Чтобы получить доступ к странице обзора платформы Google Maps:

1. Откройте страницу платформы Google Maps в Cloud Console:

   Перейти на страницу платформы Google Карт.

2. В меню слева выберите Обзор .

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

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

Чтобы получить доступ к странице API и сервисов платформы Google Maps:

1. Откройте страницу платформы Google Maps в Cloud Console:

   Перейти на страницу платформы Google Карт.

2. В меню слева выберите API и сервисы .

Страница показателей Google Карт

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

Под графиками страница «Метрики» содержит таблицу API, в которой показаны запросы, ошибки и задержка для выбранных вами API.

Используя раскрывающийся список API вверху, а также параметры группировки и фильтрации на правой панели, вы можете группировать и фильтровать отображаемые показатели использования, выбирая определенные или несколько API, учетные данные, классы кода ответа, тип платформы и/или домен. Вы также можете выбрать период времени (от одного часа до последних 30 дней) и степень детализации (в секунду или день) для отображаемых показателей использования.

На следующих изображениях показаны фильтры «Платформа» и «Домен» для одного API, когда в раскрывающемся списке «Сгруппировано по» выбрана группировка по платформе и домену :

Чтобы получить доступ к странице показателей API платформы Google Карт:

1. Откройте страницу платформы Google Maps в Cloud Console:

   Перейти на страницу платформы Google Карт.

2. В меню слева выберите Метрики .

Отчеты о учетных данных

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

Графики кодов ответов

Графики «Трафик по коду ответа» и «Ошибка по коду ответа» разделяют использование по классам кода ответа HTTP. В этой таблице показано соответствие между статусом ответа API платформы Google Карт и классом кода ответа HTTP:

Дополнительные сведения о кодах состояния и сообщениях об ошибках см. в документации по ответам для интересующего вас API (например, «Ответы геокодирования» или «Ответы направлений» ).

Параметр решений платформы Google Карт

Платформа Google Maps предоставляет множество типов примеров кода, которые помогут вам быстро приступить к работе. Например, вы можете использовать Quick Builder в Cloud Console, следовать руководствам по внедрению отраслевых решений и учиться на лабораториях кода .

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

• Параметр запроса solution_channel по умолчанию включен в пример кода решения.
• Параметр запроса возвращает в Google аналитику по внедрению решения, чтобы улучшить качество решения в будущих итерациях.
• Вы можете отказаться, удалив параметр запроса solution_channel и его значение из примера кода.
• Нет необходимости сохранять параметр. Удаление параметра запроса не влияет на производительность.
• Параметр запроса используется только для отчетов об использовании примера кода.
• Параметр запроса отделен от любой аналитики и отчетов, относящихся к API. Это означает, что удаление параметра из примера кода решения не отключает внутренние отчеты Maps JavaScript API.

Отчеты о квотах

Квоты устанавливают ограничения на количество запросов, которые ваш проект может отправлять к API платформы Google Maps. Запросы можно ограничить тремя способами: за день, за минуту и ​​за пользователя за минуту. В квоту засчитываются только успешные запросы и запросы, вызывающие ошибки сервера. Запросы, не прошедшие проверку подлинности, не учитываются в квоте.

Использование квоты отображается в виде графиков на странице «Квоты» в Cloud Console и может быть сгруппировано по количеству запросов в минуту. Текущие ограничения квот для выбранных API отображаются в таблицах под графиками использования квот.

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

Страница квот Google Maps

На странице « Квоты Google Maps» отображаются ограничения квот и потребление квот для конкретного выбранного вами API.

Диаграмма использования квоты в Google Cloud Console показывает общий трафик для ваших ключей API и идентификаторов клиентов. Трафик идентификатора клиента также доступен на диаграмме показателей в Cloud Console.

На странице показаны только запросы, потребляющие квоту: успешные запросы ( OK , ZERO_RESULTS , DATA_NOT_AVAILABLE ) и запросы, вызывающие ошибки сервера ( NOT_FOUND , INVALID_REQUEST/INVALID_VALUE (недопустимое значение параметра), UNKNOWN_ERROR ).

Запросы, вызывающие ошибки клиента — ошибки аутентификации, авторизации и неверных аргументов ( REQUEST_DENIED , OVER_QUERY_LIMIT , INVALID_REQUEST (неверный параметр, ошибка анализа запроса)) — не используют квоту и не отображаются.

Единица квоты — это запрос для большинства API платформы Google Карт (API Maps Static, Street View Static API, API геокодирования, API направлений, API Places, API часовых поясов, API геолокации и API высоты), но есть некоторые исключения. :

• Для API Distance Matrix единицей квоты является элемент, который представляет собой пару отправитель-назначение.
• Для Maps JavaScript API единицей квоты является загрузка карты.
• Для Maps SDK для Android и Maps SDK для iOS единицей квоты является запрос Street View или загрузка Panorama. Загрузка карт доступна бесплатно и не расходует квоту.

Чтобы получить доступ к странице квот платформы Google Maps:

1. Откройте страницу платформы Google Maps в Cloud Console:

   Перейти на страницу платформы Google Карт.

2. В меню слева выберите «Квоты» .
3. Выберите API из раскрывающегося списка API.

Единицы квоты

В этой таблице показаны единицы квоты для API платформы Google Maps.

Отчеты о платежах

Просмотр отчета о платежах

Отчеты о выставлении счетов за использование продуктов платформы Google Maps доступны в Google Cloud Console. Дополнительную информацию см. в разделе «Выставление счетов» .

Чтобы получить доступ к отчетам о платежах:

1. Откройте страницу выбора проекта в Cloud Console:

   Страница выбора проекта

2. Выберите проект.
3. Выберите кнопку меню а затем выберите «Оплата» .
4. Если у вас несколько учетных записей выставления счетов, выберите «Перейти к связанной учетной записи выставления счетов» , чтобы открыть страницу «Обзор» для связанной учетной записи выставления счетов.
5. В меню слева выберите «Отчеты» , чтобы открыть страницу «Отчеты о платежах» для связанного платежного аккаунта.

Как читать диаграмму отчета о платежах

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

Совет: проанализируйте использование и стоимость каждого SKU.

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

Чтобы изменить вид отчета для отображения позиций по SKU:

1. На панели справа от диаграммы разверните фильтр «Группировать по» .
2. Выберите артикул .

Другие доступные фильтры отчетов о выставлении счетов включают «Диапазон времени », «Проекты », «Продукты» , «SKU» и «Местоположения» , которые позволяют фильтровать по тому, откуда обслуживаются запросы API .

Чтобы классифицировать источник использования в дополнение к продукту, сгруппируйте отчеты о выставлении счетов по одному из перечисленных значений. Три ключа, относящиеся к API платформы Google Maps, — это goog-maps-api-key-suffix (последние четыре символа ключа API), goog-maps-platform-type (платформа: Android, iOS, JavaScript или веб-сервис). и goog-maps-channel (установленное числовое значение канала из запроса API). Дополнительная информация о фильтрации и группировке .

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

Контролируйте и ограничивайте потребление

Чтобы помочь вам планировать бюджет и контролировать расходы, вы можете сделать следующее:

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

• Ограничьте ежедневное использование API , чтобы управлять расходами на использование платных API. Установив ограничения на количество запросов в день , вы можете ограничить свои расходы. Используйте простое уравнение, чтобы определить свой дневной лимит в зависимости от того, сколько вы готовы потратить. Например: (Месячные расходы /цена за каждый SKU)/30 = ограничение количества запросов в день (для одного API).

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

Чтобы отслеживать использование через числовые каналы, вы должны добавить параметр «канал» в свои запросы API. Единственными допустимыми значениями каналов являются числа от 0 до 999. Вот несколько примеров:

• API веб-службы геокодирования

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• API JavaScript Карт

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

Контролируйте использование канала прямо в отчете о выставлении счетов. Каналы будут отображаться в разделе «Ярлыки» как ключевой канал goog-maps-channel .

Чтобы отфильтровать отчет о платежах по SKU и каналу

1. Используйте фильтр «Группировать по SKU».
2. Выберите курсор « Ярлыки».
3. Выберите раскрывающийся список «Ключ» и выберите goog-maps-channel .
4. Откройте раскрывающийся список «Значение» и выберите числовые каналы, которые вы хотите отфильтровать.

Сгруппируйте по ключу метки goog-maps-channel, чтобы увидеть стоимость, генерируемую каждым каналом.

После того как вы включили данные об использовании канала в свои запросы, может пройти небольшая задержка (до 24 часов), прежде чем данные отразятся в вашем отчете о платежах.

Экспортируйте свои платежные данные с помощью BigQuery.

Вы также можете экспортировать свои платежные данные в BigQuery .

BigQuery Export позволяет автоматически экспортировать подробные данные Cloud Billing (например, данные об использовании и смете затрат) в течение дня в указанный вами набор данных BigQuery . Затем вы сможете получить доступ к своим платежным данным из BigQuery для детального анализа. Это дает дополнительный уровень детализации в понимании источника использования вашей платформы Google Maps.

Если вы хотите начать экспортировать BigQuery и запрашивать данные, вы можете попробовать образец запроса ниже. Прежде чем выполнить этот запрос, необходимо:

• Включите выставление счетов и экспорт счетов в BigQuery в своем аккаунте.
• Формат таблицы — PROJECT_ID . DATASET_NAME .gcp_billing_export v1 BILLING_ACCOUNT_ID , где:
• PROJECT_ID — это ваш фактический идентификатор проекта (например, «мой-проект-123456»).
• DATASET_NAME — это имя созданного вами набора данных (например, «SampleDataSet»).
• BILLING_ACCOUNT_ID — это ссылка на идентификатор вашего платежного аккаунта с префиксом «gcp_billing_export v1 » и заменой тире (-) на подчеркивание (_). Например, идентификатор платежного аккаунта 123456-7890AB-CDEF01 станет gcp_billing_export_v1_123456_789AB_CDEF01 .

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

Связанные ресурсы

Облачный биллинг:

• Создайте, измените или закройте свою учетную запись Cloud Billing.
• Изменение платежных настроек проекта
• Просматривайте отчеты о выставлении счетов и тенденции затрат
• Настройка бюджетов и оповещений о бюджете
• Ограничение использования API

• Оплата платформы Google Карт
• Руководство по оптимизации
• Рекомендации по использованию ключей API

Статус ответа и отчеты

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

Отчет об использовании в показателях платформы Google Maps обеспечивает детализацию HTTP response code class . Если вам нужен более высокий уровень детализации, см. Коды состояния ответов , доступные в мониторинге использования платформы Google Maps .

Отчеты о взаимодействии

Бизнес-аналитика

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

Возможности создания отчетов по бизнес-аналитике включают в себя:

• Просмотр общего снимка бизнес-аналитики, чтобы сразу увидеть ключевые тенденции в бизнес-аналитике.
• Детализация для анализа конкретной метрики в консоли для более глубокого понимания метрик.
• Экспорт показателей в CSV , чтобы вы могли анализировать данные бизнес-аналитики в своем любимом инструменте бизнес-анализа.

Доступные показатели вовлеченности включают в себя:

• Просмотры карты: отслеживайте виды на карте в результате панорамирования, масштабирования или наклона. Просмотры карты рассчитываются по почтовому индексу еженедельно (с воскресенья по субботу по тихоокеанскому времени). Новые данные публикуются еженедельно в первую среду после периода наблюдения.

Владельцы проектов и пользователи с ролью Maps Analytics Viewer могут просматривать бизнес-аналитику на странице показателей в Cloud Console. В проекте должен быть включен Maps JavaScript API .

Вы можете анализировать показатели вовлеченности прямо в консоли с помощью функций «Фильтр» и «Группировка по», чтобы более подробно изучить показатели. Например, вы можете выбрать фильтрацию по определенному региону, чтобы узнать, как меняются представления карты только для почтовых индексов в этом регионе. С другой стороны, вы можете сгруппировать данные по определенному региону, чтобы агрегировать взаимодействия внутри этого региона.

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

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

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

Бизнес-данные не следует использовать для оценки затрат на использование. Дополнительную информацию об использовании см. в отчетах об использовании .