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

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

Типы отчетов включают в себя:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обзорная страница Google Карт

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

Примечание: если вы выберете имя любого включенного API, вы будете перенаправлены на страницу показателей Google Maps для этого API.

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

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

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

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

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

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

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

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

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

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

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

Страница Google Maps Metrics отображает три графика: Traffic, Errors и Median Latency. Данные об использовании в графиках можно сгруппировать по классу кода ответа, API, методу API, учетным данным, платформе и домену.

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

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

Примечание: Параметры Platform и Domain в раскрывающемся списке Grouped by и фильтры Platform и Domain недоступны для выбора All Google Maps Platform APIs из раскрывающегося списка выбора API . Используйте выбор All Google Maps Platform APIs для высокоуровневого анализа: найдите API и методы, имеющие использование, проверьте частоту ошибок и использование по учетным данным. Выберите конкретный API из раскрывающегося списка выбора API для глубокого анализа одного конкретного API. При выборе конкретного API из раскрывающегося списка выбора API вы можете выполнить более детальный анализ использования API, такой как группировка и фильтрация по Platform и Domain .

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

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

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

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

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

Отчетность по полномочиям

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

Формат удостоверения	Значение
Имя ключа Например, «Ключ мобильного приложения»	Для загрузки API с помощью ?key=... использовался ключ API : имена ключей можно найти в консоли платформы Карт в разделе Ключи и учетные данные .
Номер проекта Например, «номер_проекта:123456», где 123456 — номер вашего проекта.	Если вы видите эту учетную запись, есть две возможности: Для API, которые принимают идентификаторы клиентов Maps Platform : для загрузки API использовался идентификатор клиента Maps Platform. Например, с помощью &client=gme-_mycompany_ . Эти API принимают клиентские IDS: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API (устаревший), Distance Matrix API (устаревший), Geocoding API, Time Zone API. Для получения дополнительной информации см. Управление идентификаторами клиентов Premium Plan . Для API, принимающих OAuth : API был загружен с использованием OAuth без ключа API.

Примечание: API платформы Карт, которые поддерживают как идентификаторы клиентов платформы Карт, так и OAuth, отсутствуют, поэтому вы можете определить, был ли загружен API с идентификатором клиента или OAuth, на основе того, какой API использовался.

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

Графики Traffic by response code и Error by response code разделяют использование по классу кода ответа HTTP. В этой таблице показано сопоставление между статусом ответа API платформы Google Карт и классом кода ответа HTTP:

Статус API Карт	Класс кода ответа HTTP - Отчет об использовании (2xx, 3xx, 4xx, 5xx)	Примечания
ХОРОШО	2хх	Успешный ответ. Это платный запрос, который будет расходовать квоту.
ХОРОШО	3хх	Успешный ответ. Это платный запрос, который будет расходовать квоту. Например, успешные запросы Place Photo возвращают редирект 302 на указанное изображение.
ДАННЫЕ_НЕ_ДОСТУПНЫ	4xx ^( 1 )	Успешный ответ, указывающий на отсутствие доступных данных для входных местоположений. Это платный запрос, который будет расходовать квоту.
НУЛЕВЫЕ_РЕЗУЛЬТАТЫ	4xx ^( 1 )	Успешный ответ не дал результата. Это платный запрос, который будет расходовать квоту.
НЕ НАЙДЕНО	4xx ^( 1 )	Для API направлений (устаревшей версии) это сообщение указывает на то, что по крайней мере одно из местоположений, указанных в запросе в качестве источника, пункта назначения или путевых точек, не может быть геокодировано. Для API Places это сообщение означает, что указанное местоположение (place_id) не найдено в базе данных Places. Это платный запрос, который будет расходовать квоту.
INVALID_REQUEST (недопустимое значение параметра), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED и другие.	4хх	Ошибка вызвана недопустимым значением параметра. Проверьте ответ API для получения более подробной информации. Это платный запрос, который будет расходовать квоту.
ЗАПРОС_ОТКЛОНЕН	4хх	Ошибка клиента, вызванная ошибкой аутентификации, ошибкой доступа и др. Проверьте ответ API для получения более подробной информации.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, РЕСУРС_ИСЧЕРПАН, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4хх	Ошибка клиента, вызванная слишком большим количеством запросов за разрешенный период времени. Повторите запрос позже. Проверьте ответ API для получения более подробной информации.
INVALID_REQUEST (недопустимый или отсутствующий параметр, ошибка анализа или проверки запроса)	4хх	Ошибка клиента, вызванная недействительным запросом. Проверьте ответ API для получения более подробной информации.
НЕ НАЙДЕНО (404)	4хх	Для Directions API (устаревшая версия) — это сообщение указывает на то, что по крайней мере одно из местоположений, указанных в запросе в качестве исходной точки, пункта назначения или путевых точек, не может быть геокодировано. Для API геолокации это сообщение указывает на то, что входных данных недостаточно для оценки местоположения. Для API дорог это сообщение указывает на то, что входные данные не удалось разумно привязать к дорогам. Это платный запрос, который будет расходовать квоту.
НЕИЗВЕСТНАЯ_ОШИБКА	5хх	Ошибка сервера, указывающая на невозможность выполнения запроса: внутренняя ошибка, перегрузка службы, недоступность, истечение времени ожидания и другие.
^1 Для улучшения согласованности отчетов об ошибках API платформы Google Карт переходят: 1) с класса кода ответа HTTP 2xx на 4xx для статусов API Карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS - status , 2) с класса кода ответа HTTP 2xx на 4xx для статусов API Карт: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded , 3) ​​с класса кода ответа HTTP 2xx на 5xx для статуса API Карт: UNKNOWN_ERROR . Вы можете видеть оба кода ответа в течение переходного периода. Коды ответов, возвращаемые в ответах API Карт, не меняются. Подтвердите, что увеличение значений 4xx и/или 5xx в показателях платформы Google Карт связано с этой миграцией, проверив, какой именно код ответа увеличивается в обозревателе показателей ( узнайте больше об использовании Google Cloud Monitoring для платформы Google Карт).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Единица квоты представляет собой запрос для большинства API платформы Google Карт (Maps Static API, Street View Static API, Geocoding API, Directions API (устаревший), Places API, Time Zone API, Geolocation API и Elevation API), но есть некоторые исключения:

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

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

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

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

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

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

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

API платформы Google Карт	Единица квоты
Карты
Карт SDK для Android	1 Панорама
Карт SDK для iOS	1 Панорама
API фрагментов карты	1 Запрос
API карт с видом с воздуха	1 Запрос
Статический API Карт	1 Запрос
API JavaScript Карт	1 Загрузка карты
Статический API Street View	1 Запрос
API встраивания карт	1 Загрузка карты
Маршруты
API маршрутов (вычисление маршрутов)	1 Запрос
API маршрутов (вычислить матрицу маршрутов)	1 элемент (пара «источник-назначение»)
API маршрутов (устаревший)	1 Запрос
API матрицы расстояний (устаревший)	1 элемент (пара «источник-назначение»)
API дорог	1 Запрос
API оптимизации маршрута	1 Запрос
Навигационный SDK для Android	1 пункт назначения
Навигационный SDK для iOS	1 пункт назначения
Места
API мест	1 Запрос
API агрегатора мест	1 Запрос
API проверки адреса	1 Запрос
API геокодирования	1 Запрос
API геолокации	1 Запрос
API часового пояса	1 Запрос
Среда
API качества воздуха (текущие условия и HeatmapTile)	1 Запрос
API качества воздуха (история)	1 страница
API пыльцы	1 Запрос
Солнечный API	1 Запрос

Отчеты по выставлению счетов

Просмотр отчета о выставлении счетов

Отчеты по выставлению счетов за использование продуктов Google Maps Platform доступны в консоли Google Cloud. Для получения дополнительной информации см. раздел Billing .

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

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

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

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

Как читать таблицу отчета по выставлению счетов

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

Рисунок 1: Отчет о выставлении счетов, отображающий диаграмму и таблицу с использованием предустановленного вида по умолчанию.

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

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

Рисунок 2: Таблица выставления счетов, отображающая элементы данных об использовании и расходах по артикулу.

Рисунок 3: Фильтры отчета по выставлению счетов.

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

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

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

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

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

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

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

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

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

  Примечание: Ваша реализация может использовать несколько платных API, которые в свою очередь используют несколько SKU, поэтому при необходимости скорректируйте уравнение. Учитывайте в своих расчетах объем бесплатного ежемесячного использования, который предоставляет каждый 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 .

Примечание: данные каналов недоступны для Maps SDK для Android, Maps SDK для iOS, Places API (новый), Places Aggregate API, Address Validation API, Aerial View API, Air Quality API, Map Tiles API, Maps Datasets API, Roads API, Routes API, Pollen API, Solar API и Route Optimization API.

Рисунок 4: Фильтр по артикулу и каналам

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

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

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

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

Экспортируйте данные о ваших счетах с помощью BigQuery

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

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

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

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

Примечание: Когда вы создаете новый DataSet, он сразу же появится в интерфейсе, но таблица для запроса пока не появится. Таблица будет автоматически сгенерирована через несколько часов. Затем потребуется около 24 часов, чтобы увидеть ваши данные. Ваш набор данных BigQuery отражает только данные об использовании и расходах, понесенных с даты, когда вы настроили экспорт счетов, и после. Другими словами, данные о счетах не добавляются задним числом, поэтому вы не увидите данные о счетах до того, как вы включили экспорт BigQuery.

  #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 Карт:

• Платформа Google Maps Billing
• Руководство по оптимизации
• Лучшие практики API-ключей

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

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

Примечание: По историческим причинам код ответа HTTP, возвращаемый в ответ на запросы API платформы Google Карт, может отличаться от кода ответа HTTP в отчетах об использовании ( метрики платформы Google Карт ). Метрики отчетов об использовании используют набор значений кодов ответа, которые соответствуют тем, которые используются в новых API. Это улучшает наблюдаемость использования API в метриках платформы Google Карт и мониторинге платформы Google Карт .

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

Коды ответов, доступные в ответах API Карт		Доступно в отчете об использовании	Сообщается
Статус API Карт	HTTP-код ответа	Класс кода ответа HTTP	Использование	Квота	Биллинг
ХОРОШО	200, 204, 302	2хх, 3хх	Да	Да	Да
ДАННЫЕ_НЕ_ДОСТУПНЫ, НЕ НАЙДЕНО, НУЛЕВЫЕ_РЕЗУЛЬТАТЫ	200, 404	4xx ^1	Да	Да	Да
INVALID_REQUEST (недопустимое значение параметра), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, и т. д.	200, 400	4хх	Да	Да	Да
INVALID_REQUEST (недопустимый/отсутствующий параметр, ошибка анализа запроса)	200, 400	4хх	Да	Нет	Нет
ЗАПРОС_ОТКЛОНЕН	200, 400, 403	4xx ^1	Да	Нет	Нет
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, РЕСУРС_ИСЧЕРПАН, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx ^1	Да	Нет	Нет
НЕИЗВЕСТНАЯ_ОШИБКА	200, 500, 503	5xx ^1	Да	Да	Нет
^1 Для улучшения согласованности отчетов об ошибках API платформы Google Карт переходят: 1) с класса кода ответа HTTP 2xx на 4xx для статусов API Карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS - status , 2) с класса кода ответа HTTP 2xx на 4xx для статусов API Карт: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded , 3) ​​с класса кода ответа HTTP 2xx на 5xx для статуса API Карт: UNKNOWN_ERROR . Вы можете видеть оба кода ответа в течение переходного периода. Коды ответов, возвращаемые в ответах API Карт, не меняются. Подтвердите, что увеличение значений 4xx и/или 5xx в показателях платформы Google Карт связано с этой миграцией, проверив, какой именно код ответа увеличивается в обозревателе показателей ( узнайте больше об использовании Google Cloud Monitoring для платформы Google Карт).

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

Этот продукт или функция являются экспериментальными (pre-GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях pre-GA могут быть несовместимы с другими версиями pre-GA. Предложения Pre-GA подпадают под действие специальных условий сервиса Google Maps Platform . Для получения дополнительной информации см. описания этапов запуска .

Бизнес-идеи

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

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

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

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

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

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

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

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

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

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

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