Отчеты на платформе Google Maps предоставляют набор предопределенных визуальных отчетов об основном использовании API, квотах и платежной информации в Google Cloud Console. Используйте эти отчеты, чтобы определить количество совершенных вами вызовов API, насколько вы близки к достижению квоты на использование API, а также отслеживать использование счетов с течением времени.
К типам отчетов относятся:
- Отчеты об использовании . Сообщают о количестве запросов, которые ваш проект отправляет к API платформы Google Maps с использованием учетных данных, связанных с вашим проектом.
- Отчеты о квотах : отчеты об использовании квот в виде графиков, которые можно сгруппировать по количеству запросов в минуту. Текущие ограничения квот для выбранных API отображаются в таблицах под графиками использования квот.
- Отчеты о выставлении счетов : отчеты о расходах с течением времени в виде составной линейной диаграммы. Просмотрите использование квоты в текущем месяце, включая все примененные кредиты за использование, а также общую прогнозируемую стоимость за весь текущий месяц.
- отчеты 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 и сервисами:
- Откройте страницу выбора проекта в Cloud Console:
- Выберите свой проект. Появится страница панели мониторинга API и служб.
Если страница не отображается, выберите кнопку меню
а затем выберите API и службы .
Дополнительную информацию см. в разделе Мониторинг использования API .
Страница обзора Google Карт
На странице «Обзор Карт Google» есть таблица со списком включенных API и запросов на использование за последние 30 дней. Запросы по API также отображаются в виде графика. График выставления счетов показывает текущий счет и общий объем использования за последние 3 месяца.
Чтобы получить доступ к странице обзора платформы Google Maps:
- Откройте страницу платформы Google Maps в Cloud Console:
- В меню слева выберите Обзор .
Страница API и сервисов платформы Google Карт
Страница API и сервисы Google Maps содержит сетку плиток, представляющих API, SDK и другие сервисы, доступные для вашего проекта. На каждой плитке вы можете включить или отключить эту службу, выбрав «Включить» или «Отключить» , а также получить доступ к информации об учетных данных, метрикам и руководствам пользователя для включенных API. Вы также можете использовать фильтры страниц для просмотра включенных или отключенных служб и других категорий услуг.
Чтобы получить доступ к странице API и сервисов платформы Google Maps:
- Откройте страницу платформы Google Maps в Cloud Console:
- В меню слева выберите API и сервисы .
Страница показателей Google Карт
На странице показателей Google Maps отображаются три графика: трафик, ошибки и медианная задержка. Данные об использовании на графиках можно сгруппировать по классу кода ответа, API, методу API, учетным данным, платформе и домену.
Под графиками страница «Метрики» содержит таблицу API, в которой показаны запросы, ошибки и задержка для выбранных вами API.
Используя раскрывающийся список API вверху, а также параметры группировки и фильтрации на правой панели, вы можете группировать и фильтровать отображаемые показатели использования, выбирая определенные или несколько API, учетные данные, классы кода ответа, тип платформы и/или домен. Вы также можете выбрать период времени (от одного часа до последних 30 дней) и степень детализации (в секунду или день) для отображаемых показателей использования.
На следующих изображениях показаны фильтры «Платформа» и «Домен» для одного API, когда в раскрывающемся списке «Сгруппировано по» выбрана группировка по платформе и домену :
Чтобы получить доступ к странице показателей API платформы Google Карт:
- Откройте страницу платформы Google Maps в Cloud Console:
- В меню слева выберите Метрики .
Отчеты о учетных данных
Вы можете фильтровать и группировать метрики по учетным данным, которые использовались для загрузки API.
| Формат учетных данных | Значение |
|---|---|
| Имя ключа Например, «Ключ мобильного приложения». | Для загрузки API использовался ключ API с помощью ?key=... . Имена ключей можно найти в консоли платформы Maps в разделе «Ключи и учетные данные» . |
| Номер проекта Например, «номер_проекта:123456», где 123456 — номер вашего проекта. | Если вы видите эти учетные данные, есть две возможности:
|
Графики кодов ответов
Графики «Трафик по коду ответа» и «Ошибка по коду ответа» разделяют использование по классам кода ответа HTTP. В этой таблице показано соответствие между статусом ответа API платформы Google Карт и классом кода ответа HTTP:
| Статус API Карт | Класс кода ответа HTTP – отчет об использовании (2хх, 3хх, 4хх, 5хх) | Примечания |
|---|---|---|
| ХОРОШО | 2хх | Успешный ответ. Это платный запрос, на который будет использована квота. |
| ХОРОШО | 3хх | Успешный ответ. Это платный запрос, на который будет использована квота. Например, успешные запросы Place Photo возвращают 302-перенаправление на указанное изображение. |
| ДАННЫЕ_NOT_AVAILABLE | 4хх ( 1 ) | Успешный ответ указывает на отсутствие доступных данных для входных местоположений. Это платный запрос, на который будет использована квота. |
| ZERO_RESULTS | 4хх ( 1 ) | Успешный ответ не дал результата. Это платный запрос, на который будет использована квота. |
| НЕ НАЙДЕНО | 4хх ( 1 ) | Для Directions API это сообщение означает, что по крайней мере одно из местоположений, указанных в источнике, пункте назначения или путевых точках запроса, не может быть геокодировано. Для API Places это сообщение означает, что указанное местоположение (place_id) не найдено в базе данных Places. Это платный запрос, на который будет использована квота. |
| INVALID_REQUEST (неверное значение параметра), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED и другие. | 4хх | Ошибка, вызванная неверным значением параметра. Для получения более подробной информации проверьте ответ API. Это платный запрос, на который будет использована квота. |
| REQUEST_DENIED | 4хх | Ошибка клиента, вызванная ошибкой аутентификации, ошибкой доступа и другими. Для получения более подробной информации проверьте ответ API. |
| OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, РЕСУРС_EXHAUSTED, предел лимита превышения, ежедневный лимит превышен, userRateLimitExceeded | 4хх | Ошибка клиента, вызванная слишком большим количеством запросов за разрешенный период времени. Повторите запрос позже. Для получения более подробной информации проверьте ответ API. |
| INVALID_REQUEST (неверный или отсутствующий параметр, ошибка анализа запроса или проверки) | 4хх | Ошибка клиента, вызванная недействительным запросом. Проверьте ответ API для получения более подробной информации. |
| НЕ_НАЙДЕНО (404) | 4хх | Для API геолокации это сообщение означает, что входных данных недостаточно для оценки местоположения. Для Roads API это сообщение означает, что входные данные не могут быть разумно привязаны к дорогам. Это платный запрос, на который будет использована квота. |
| НЕИЗВЕСТНАЯ_ОШИБКА | 5хх | Ошибка сервера, указывающая, что запрос не может быть выполнен: внутренняя ошибка, служба перегружена, недоступна, истекло время ожидания и другие. |
1. Чтобы улучшить согласованность отчетов по кодам ошибок, API платформы Google Карт переходят: 1) с класса кода ответа HTTP 2xx на 4xx для статусов API Карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS - status , 2) с класса кода ответа HTTP 2xx на 4xx для статусов Maps API: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded , 3) из класса кода ответа HTTP от 2xx до 5xx для статуса Maps API: UNKNOWN_ERROR . Оба кода ответа можно увидеть в течение переходного периода. Коды ответов, возвращаемые в ответах Maps API, не изменяются. Подтвердите, что увеличение 4xx и/или 5xx в показателях платформы Google Maps связано с этой миграцией, проверив, какой именно код ответа увеличивается в обозревателе метрик ( узнайте больше об использовании Google Cloud Monitoring для платформы Google Maps). | ||
Дополнительные сведения о кодах состояния и сообщениях об ошибках см. в документации по ответам для интересующего вас 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:
- Откройте страницу платформы Google Maps в Cloud Console:
- В меню слева выберите «Квоты» .
- Выберите API из раскрывающегося списка API.
Единицы квоты
В этой таблице показаны единицы квоты для API платформы Google Maps.
| API платформы Google Карт | Единица квоты |
|---|---|
| Карты | |
| SDK Карт для Android | 1 Панорама |
| SDK Карт для iOS | 1 Панорама |
| API плиток карты | 1 запрос |
| API карт с высоты птичьего полета | 1 запрос |
| Статический API карт | 1 запрос |
| API JavaScript Карт | 1 загрузка карты |
| Статический API просмотра улиц | 1 запрос |
| API для встраивания карт | 1 загрузка карты |
| Маршруты | |
| API маршрутов (вычисление маршрутов) | 1 запрос |
| API маршрутов (вычисление матрицы маршрутов) | 1 элемент (пара отправитель-назначение) |
| API маршрутов | 1 запрос |
| API матрицы расстояний | 1 элемент (пара отправитель-назначение) |
| API дорог | 1 запрос |
| API оптимизации маршрутов | 1 запрос |
| Места | |
| API мест | 1 запрос |
| API проверки адреса | 1 запрос |
| API геокодирования | 1 запрос |
| API геолокации | 1 запрос |
| API часового пояса | 1 запрос |
| Среда | |
| API качества воздуха (CurrentConditions и HeatmapTile) | 1 запрос |
| API качества воздуха (история) | 1 страница |
| API пыльцы | 1 запрос |
| Солнечный API | 1 запрос |
Платежные отчеты
Просмотр отчета о платежах
Отчеты о выставлении счетов за использование продуктов платформы Google Maps доступны в Google Cloud Console. Дополнительную информацию см. в разделе «Выставление счетов» .
Чтобы получить доступ к отчетам о платежах:
- Откройте страницу выбора проекта в Cloud Console:
- Выберите проект.
- Выберите кнопку меню а затем выберите «Оплата» .
- Если у вас несколько учетных записей выставления счетов, выберите « Перейти к связанной учетной записи выставления счетов» , чтобы открыть страницу «Обзор» для связанной учетной записи выставления счетов.
- В меню слева выберите «Отчеты» , чтобы открыть страницу «Отчеты о платежах» для связанного платежного аккаунта.
Как читать диаграмму отчета о платежах
Отчеты о выставлении счетов отображают затраты с течением времени в виде составной линейной диаграммы. В представлении по умолчанию отображаются ежедневные затраты на использование в текущем месяце, сгруппированные по проектам (для всех продуктов), включая все примененные кредиты на использование, а также общие прогнозируемые затраты за весь текущий месяц. Каждая строка на диаграмме (и строка в сводной таблице) соответствует проекту, отсортированному по стоимости от наибольшего к наименьшему. Узнайте больше об интерпретации диаграммы отчета о платежах .
Совет: проанализируйте использование и стоимость каждого SKU.
Чтобы более точно понять детали модели ценообразования с оплатой по мере использования и то, как она влияет на вашу реализацию, посмотрите на использование и стоимость по SKU.
Чтобы изменить вид отчета для отображения позиций по SKU:
- На панели справа от диаграммы разверните фильтр «Группировать по ».
- Выберите артикул .
Другие доступные фильтры отчетов о выставлении счетов включают «Диапазон времени» , «Проекты» , «Продукты» , «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 и каналу
- Используйте фильтр « Группировать по SKU».
- Выберите курсор «Ярлыки» .
- Выберите раскрывающийся список «Ключ» и выберите goog-maps-channel .
- Откройте раскрывающийся список «Значение» и выберите числовые каналы, которые вы хотите отфильтровать.
Сгруппируйте по ключу метки 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
Статус ответа и отчеты
В таблице ниже показано сопоставление между статусом API Карт, кодом ответа HTTP, возвращаемым в ответах API Карт, и классом кода ответа HTTP в отчете об использовании, а также указано, отображается ли соответствующий запрос в отчетах об использовании, квоте и выставлении счетов.
Отчет об использовании в показателях платформы Google Maps обеспечивает детализацию HTTP response code class . Если вам нужен более высокий уровень детализации, см. Коды состояния ответов, доступные в мониторинге использования платформы Google Maps .
| Коды ответов, доступные в ответах Maps API | Доступно в отчете об использовании | Сообщено | |||
|---|---|---|---|---|---|
| Статус API Карт | HTTP-код ответа | Класс кода ответа HTTP | Использование | Квота | Биллинг |
| ХОРОШО | 200, 204, 302 | 2хх, 3хх | Да | Да | Да |
| ДАННЫЕ_НЕ_AVAILABLE, НЕ НАЙДЕНО, ZERO_RESULTS | 200, 404 | 4хх 1 | Да | Да | Да |
| INVALID_REQUEST (недопустимое значение параметра), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, и т. д. | 200, 400 | 4хх | Да | Да | Да |
| INVALID_REQUEST (неверный/отсутствующий параметр, ошибка анализа запроса) | 200, 400 | 4хх | Да | Нет | Нет |
| REQUEST_DENIED | 200, 400, 403 | 4хх 1 | Да | Нет | Нет |
| OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, РЕСУРС_EXHAUSTED, ежедневный лимит превышен, предел скоростиПревышен, userRateLimitExceeded | 200, 403, 429 | 4хх 1 | Да | Нет | Нет |
| НЕИЗВЕСТНАЯ_ОШИБКА | 200, 500, 503 | 5хх 1 | Да | Да | Нет |
1. Чтобы улучшить согласованность отчетов по кодам ошибок, API платформы Google Карт переходят: 1) с класса кода ответа HTTP 2xx на 4xx для статусов API Карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS - status , 2) с класса кода ответа HTTP 2xx на 4xx для статусов Maps API: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded , 3) из класса кода ответа HTTP от 2xx до 5xx для статуса Maps API: UNKNOWN_ERROR . Оба кода ответа можно увидеть в течение переходного периода. Коды ответов, возвращаемые в ответах Maps API, не изменяются. Подтвердите, что увеличение 4xx и/или 5xx в показателях платформы Google Maps связано с этой миграцией, проверив, какой именно код ответа увеличивается в обозревателе метрик ( узнайте больше об использовании Google Cloud Monitoring для платформы Google Maps). | |||||
Отчеты о взаимодействии
Бизнес-аналитика
Платформа Google Maps дает вам представление о том, как пользователи взаимодействуют с вашими картами. Эта информация включает в себя ключевые показатели взаимодействия, такие как просмотры на карте или взаимодействие с POI. Вы можете проанализировать эту информацию, чтобы выявить популярные места для рекламы и маркетинга или оптимизировать взаимодействие с пользователем.
Возможности создания отчетов по бизнес-аналитике включают в себя:
- Просмотр общего снимка бизнес-аналитики , чтобы сразу увидеть ключевые тенденции в бизнес-аналитике.
- Детализация для анализа конкретной метрики в консоли для более глубокого понимания метрик.
- Экспорт показателей в CSV , чтобы вы могли анализировать данные бизнес-аналитики в своем любимом инструменте бизнес-анализа.
Доступные показатели вовлеченности включают в себя:
- Просмотры карты: отслеживайте виды на карте в результате панорамирования, масштабирования или наклона. Просмотры карты рассчитываются по почтовому индексу еженедельно (с воскресенья по субботу по тихоокеанскому времени). Новые данные публикуются еженедельно в первую среду после периода наблюдения.
Владельцы проектов и пользователи с ролью Maps Analytics Viewer могут просматривать бизнес-аналитику на странице показателей в Cloud Console. В проекте должен быть включен Maps JavaScript API .
Вы можете анализировать показатели вовлеченности прямо в консоли с помощью функций «Фильтр» и «Группировка по», чтобы более подробно изучить показатели. Например, вы можете выбрать фильтрацию по определенному региону, чтобы узнать, как меняются представления карты только для почтовых индексов в этом регионе. С другой стороны, вы можете сгруппировать данные по определенному региону, чтобы агрегировать взаимодействия внутри этого региона.
Пользователи могут экспортировать весь набор данных или отфильтрованное представление в CSV для дальнейшего анализа с помощью вашего любимого инструмента бизнес-анализа. Вы можете загружать до 90 дней за раз, а загрузки размером более 60 000 ячеек будут обрезаны. Экспорт данных видов карты в CSV может занять несколько минут в зависимости от выбранного диапазона времени.
Показатели бизнес-аналитики анонимизированы и поэтому отражают только общие тенденции взаимодействия с вашими картами. Низкие значения могут быть округлены до нуля, а вклад выбросов может быть уменьшен.
Вы можете контролировать доступ к бизнес-аналитике вашего облачного проекта в Google Cloud Console, используя разрешение Maps Analytics. Владельцам проектов это разрешение предоставляется по умолчанию, и они могут при необходимости предоставлять доступ другим пользователям.
Бизнес-аналитика не должна использоваться для оценки затрат на использование. Дополнительную информацию об использовании см. в отчетах об использовании .
Локатор Плюс
Для пользователей Locator Plus аналитическая панель помогает анализировать и получать ценную информацию на основе ваших данных, давая четкое представление о том, насколько хорошо ваши покупатели взаимодействуют с вашим поиском магазинов. Вы можете измерять свою эффективность еженедельно, включая количество просмотров, количество взаимодействий с поиском и информацией о местах, а также общий уровень вовлеченности. Кроме того, панель мониторинга предоставляет важные показатели сравнения вашей реализации с другими ритейлерами.
- Перейдите в Locator Plus в Google Cloud Console.
- Перейдите в раздел «Отчеты о взаимодействии» в Google Cloud Console, чтобы увидеть панель аналитики.
Отчет о сравнительном анализе позволяет сравнить ваши данные с совокупными отраслевыми данными других компаний, которые делятся своими данными. Сравнение предоставляет ценный контекст, помогая вам поставить значимые цели, получить представление о тенденциях в отрасли и узнать, как ваши дела по сравнению с конкурентами.
Чтобы просмотреть данные сравнительного анализа, данные о вашем взаимодействии анонимно включаются в тесты Google. Чтобы отказаться от анонимного просмотра и включения данных о вашем взаимодействии в отчеты по сравнительному анализу, отправьте заявку в службу поддержки . Запрос в службу поддержки обычно решается в течение 3 дней.
,Отчеты на платформе Google Maps предоставляют набор предопределенных визуальных отчетов об основном использовании API, квотах и платежной информации в Google Cloud Console. Используйте эти отчеты, чтобы определить количество совершенных вами вызовов API, насколько вы близки к достижению квоты на использование API, а также отслеживать использование выставления счетов с течением времени.
К типам отчетов относятся:
- Отчеты об использовании . Сообщают о количестве запросов, которые ваш проект отправляет к API платформы Google Maps с использованием учетных данных, связанных с вашим проектом.
- Отчеты о квотах : отчеты об использовании квот в виде графиков, которые можно сгруппировать по количеству запросов в минуту. Текущие ограничения квот для выбранных API отображаются в таблицах под графиками использования квот.
- Отчеты о выставлении счетов : отчеты о затратах с течением времени в виде составной линейной диаграммы. Просмотрите использование квоты в текущем месяце, включая все примененные кредиты за использование, а также общую прогнозируемую стоимость за весь текущий месяц.
- отчеты 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 и службы. Запросы — количество запросов (за выбранный период времени). Ошибки — это количество этих запросов, которые привели к ошибкам. Задержка (средняя задержка и процентиль) является задержкой для этих запросов.
Чтобы получить доступ к странице DANSBOARD API & Services:
- Откройте страницу селектора проектов в облачной консоли:
- Выберите свой проект. Появится страница Dashboard API & Services.
Если страница не отображается, выберите кнопку меню а затем выберите API и сервисы .
Для получения дополнительной информации см. Мониторинг использования вашего API .
Страница обзора карт Google
Страница обзора Google Maps включает API -интерфейсы с включенными списками таблицы и запросы на использование за последние 30 дней. Запросы по API также показаны в форме графика. График выставления счетов показывает ваш текущий счет и общее использование за последние 3 месяца.
Чтобы получить доступ к странице обзора платформы Google Maps:
- Откройте страницу платформы Google Maps в облачной консоли:
- В левом меню выберите обзор .
Google Maps Platform Platform Apis и страница услуг
На странице API и сервисов Google Maps содержится сетка плиток, представляющих API, SDK и другие услуги, доступные для вашего проекта. В рамках каждой плитки вы можете включить или отключить эту службу, выбрав Enable или отключить , и вы можете получить доступ к информации о учетных данных, показателях и руководствах пользователей для включенных API. Вы также можете использовать фильтры страницы для просмотра включенных или отключенных служб и других категорий услуг.
Чтобы получить доступ к странице API и сервисов платформы Google Maps:
- Откройте страницу платформы Google Maps в облачной консоли:
- В левом меню выберите API и услуги .
Страница метрики Google Maps
На странице метрик Google Maps отображается три графика: трафик, ошибки и медианную задержку. Данные об использовании на графиках могут быть сгруппированы с помощью класса кода ответа, API, метода API, учетных данных, платформы и домена.
Под графиками страница метрик включает в себя таблицу API, которая показывает запросы, ошибки и задержку для выбранных вами API.
Используя раскрывающую очередь API вверху, а также параметры группировки и фильтрации на правой панели, вы можете группировать и фильтровать показатели использования, выбрав конкретные или несколько API, учетные данные, классы кода ответа, тип платформы и/или домен. Вы также можете выбрать период времени (от одного часа до последних 30 дней) и гранулярность (в секунду или день) для показа показателей использования.
Следующие изображения показывают платформу и доменные фильтры для одного API, когда группировка по платформе и домену выбирается в сгруппированном списке:
Чтобы получить доступ к странице Metrics Platform Platform Platform Platform:
- Откройте страницу платформы Google Maps в облачной консоли:
- В левом меню выберите метрики .
Учетные данные
Вы можете фильтровать и групповые метрики с помощью учетных данных, которые использовались для загрузки API.
| Формат полномочий | Значение |
|---|---|
| Ключевое имя Например, «Ключ мобильного приложения» | Ключ API использовался для загрузки API с использованием ?key=... : Вы можете найти имена ключей на консоли платформы Maps под ключами и учетными данными . |
| Номер проекта Например, «Project_number: 123456», где 123456 - это номер вашего проекта. | Есть две возможности, если вы видите этот учетный данных:
|
Графики кода ответа
График трафика по коду ответа и ошибки по коду ответа разделяет использование с помощью класса кода ответа http. В этой таблице показано отображение между статусом ответа API платформы Google Maps и классом кода ответа HTTP:
| Карты статуса API | Http code code - отчет об использовании (2xx, 3xx, 4xx, 5xx) | Примечания |
|---|---|---|
| ХОРОШО | 2хх | Успешный ответ. Это оплачиваемый запрос и будет потреблять квоту. |
| ХОРОШО | 3xx | Успешный ответ. Это оплачиваемый запрос и будет потреблять квоту. Например, Place Photo Успешные запросы возвращают 302 перенаправления на указанное изображение. |
| Data_not_available | 4xx ( 1 ) | Успешный ответ, указывающий на то, что нет доступных данных для входных местоположений. Это оплачиваемый запрос и будет потреблять квоту. |
| Zero_Results | 4xx ( 1 ) | Успешный ответ не вернул результат. Это оплачиваемый запрос и будет потреблять квоту. |
| НЕ НАЙДЕНО | 4xx ( 1 ) | Для API направлений это сообщение указывает, что по крайней мере одно из мест, указанных в происхождении, пункте назначения или путевых точках запроса, не может быть геокодирована. Для мест API это сообщение указывает, что указанное местоположение (Place_id) не было найдено в базе данных мест. Это оплачиваемый запрос и будет потреблять квоту. |
| Invalid_Request (значение неверного параметра), Max_waypoints_exeeded, Max_route_length_exeeded и другие. | 4xx | Ошибка, вызванная неверным значением параметра. Проверьте ответ API для получения более подробной информации. Это оплачиваемый запрос и будет потреблять квоту. |
| Request_denied | 4xx | Клиентская ошибка, вызванная ошибкой аутентификации, ошибкой доступа и другими. Проверьте ответ API для получения более подробной информации. |
| Over_daily_limit, Over_query_limit, Resource_exhausted, ratelimitexeded, DailyLimitexeded, USERRATELIMITEXEDED | 4xx | Клиентская ошибка, вызванная слишком большим количеством запросов за разрешенный период времени. Повторите запрос позже. Проверьте ответ API для получения более подробной информации. |
| Invalid_Request (недействительный или отсутствующий параметр, анализ запросов или ошибка проверки) | 4xx | Клиентская ошибка, вызванная недействительным запросом. Проверьте ответ API для получения более подробной информации. |
| Not_found (404) | 4xx | Для API геолокации это сообщение указывает на то, что входы были недостаточно для получения оценки местоположения. Для API дорог это сообщение указывает на то, что входные данные не могут быть разумно привязаны к дорогам. Это оплачиваемый запрос и будет потреблять квоту. |
| Unknown_error | 5xx | Ошибка сервера, указывающая, что запрос не может быть выполнен: внутренняя ошибка, перегрузка службы, недоступная, время и другие. |
1 Чтобы улучшить согласованность отчетности по коду ошибок, API платформы Google Maps мигрируют: 1) из Code Code 2xx 2xx до 4xx для статусов API Maps: DATA_NOT_AVAILABLE , NOT_FOUND 4xx ZERO_RESULTS Для статусов API MAPS: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded , 3) от http -кода класса 2xx до 5xx для карт Статус API: UNKNOWN_ERROR . Вы можете увидеть оба кода ответов в течение переходного периода. Коды ответов, возвращаемые в ответах API MAPS, не меняются. Убедитесь, что увеличение показателей 4xx и/или 5xx в Google Maps Platform Metrics связано с этой миграцией, проверяя, какой точный код ответа увеличивается в исследователе метрик ( узнайте больше об использовании мониторинга Google Cloud для платформы Google Maps). | ||
Для получения дополнительной информации о кодах статуса и сообщениях об ошибках см. Документацию ответа для API, в котором вы заинтересованы (например, ответы на геокодирование или ответы на направлениях ).
Google Maps Solutions Parameters
Platform Platform Google Maps предоставляет много типов примеров кода, чтобы помочь вам быстро начать работу. Например, вы можете использовать быстрый строитель в облачной консоли, следовать руководствам по реализации отраслевых решений и учиться у CodeLabs .
Чтобы понять использование и способы улучшения наших решений, Google включает в себя параметр запроса solution_channel в вызовах API для сбора информации об использовании кода:
- Параметр запроса
solution_channelвключен по умолчанию в пример решения. - Параметр запроса возвращает аналитику по принятию решений в Google, чтобы улучшить качество решения в будущих итерациях.
- Вы можете отказаться, удалив параметр запроса
solution_channelи его значение из примера кода. - Нет необходимости сохранить параметр. Удаление параметра запроса не влияет на производительность.
- Параметр запроса используется только для отчетности об использовании кода.
- Параметр запроса отделен от любой API-специфической аналитики и отчетности. Это означает, что удаление параметра из кода выборки решения не отключает отчеты о внутренних картах JavaScript API.
Квота отчеты
Квоты устанавливают ограничения на количество запросов, которые ваш проект может сделать на API платформы Google Maps. Запросы могут быть ограничены тремя способами: в день, в минуту и на пользователя в минуту. Только успешные запросы и запросы, которые вызывают ошибки сервера, счисляются против квоты. Запросы о том, что аутентификация неудачной не учитывается против квоты.
Использование квот отображается на графиках на странице квот в облачной консоли и может быть сгруппировано по запросам в минуту. Текущие пределы квот для выбранных API отображаются в таблицах под графиками использования квот.
Чтобы получить значение квоты для каждого продукта GMP API, используйте этот калькулятор .
Страница квотов Google Maps
На странице квот Google Maps показаны ограничения квот и потребление квот для конкретного выбранного вами API.
Диаграмма использования квот на консоли Google Cloud показывает общий трафик для ваших ключей API и идентификаторов клиентов. Трафик идентификатора клиента также доступен в диаграмме метрик на облачной консоли.
На странице показаны только запросы, которые потребляют квоту: успешные запросы ( OK , ZERO_RESULTS , DATA_NOT_AVAILABLE ) и запросы, которые вызывают ошибки сервера ( NOT_FOUND , INVALID_REQUEST/INVALID_VALUE (значение неверного параметра), UNKNOWN_ERROR ).
Запросы, которые вызывают ошибки клиента - аутентификация, авторизация и ошибки неверных аргументов ( REQUEST_DENIED , OVER_QUERY_LIMIT , INVALID_REQUEST (неверный параметр, ошибка анализа запросов)) - не потребляйте квоту и не отображаются.
Квота является запросом для большинства API платформы Google Maps (карты статического API, Static View Static API, API геокодирования, направления API, помещения API, API часового пояса, Geolocation API и API возвышения), но есть некоторые исключения :
- Для API матрицы расстояния единица квоты является элементом, которая является парой назначения происхождения.
- Для карт JavaScript API блок квоты представляет собой загрузку карты.
- Для карт SDK для Android и Maps SDK для iOS подразделение квоты представляет собой запрос на уличный вид или нагрузку панорамы. Нагрузки на карты доступны бесплатно и не потребляют квоту.
Чтобы получить доступ к квотам платформы Google Maps Page:
- Откройте страницу платформы Google Maps в облачной консоли:
- В левом меню выберите квоты .
- Выберите API в раскрывающемся списке API.
Квота единицы
В этой таблице показана единица квот для API платформы Google Maps.
| Google Maps Platform API | Квота |
|---|---|
| Карты | |
| Карты SDK для Android | 1 панорама |
| Карты SDK для iOS | 1 панорама |
| Карта плитки API | 1 запрос |
| Карты Aerial View API | 1 запрос |
| Карты статического API | 1 запрос |
| Карты JavaScript API | 1 нагрузка на карту |
| Street View Static API | 1 запрос |
| Карты внедряют API | 1 нагрузка на карту |
| Маршруты | |
| Маршруты API (вычислительные маршруты) | 1 запрос |
| Маршруты API (матрица вычисления маршрутов) | 1 элемент (пара-преодоление) Пара) |
| Направления API | 1 запрос |
| Матрица дистанции API | 1 элемент (пара-преодоление) Пара) |
| Дороги API | 1 запрос |
| Оптимизация маршрута API | 1 запрос |
| Места | |
| Помещает API | 1 запрос |
| АРДАРАТАЦИЯ API | 1 запрос |
| Геокодирование API | 1 запрос |
| Geolocation API | 1 запрос |
| API часового пояса | 1 запрос |
| Среда | |
| API качества воздуха (CurrentConditions и Heatmaptile) | 1 запрос |
| API качества воздуха (история) | 1 страница |
| Пыльца API | 1 запрос |
| Солнечный API | 1 запрос |
Биллинг отчеты
Просмотреть свой отчет о выставлении счетов
Биллинг отчеты для использования продуктами платформы Google Maps доступны в Cloud Console Google. Для получения дополнительной информации см. Биллинг .
Чтобы получить доступ к отчетам о выставлении счетов:
- Откройте страницу селектора проектов в облачной консоли:
- Выберите проект.
- Выберите кнопку меню а затем выберите Биллинг .
- Если у вас есть несколько учетных записей выставления счетов, выберите «Перейти в связанный биллинг -аккаунт» , чтобы открыть обзорную страницу для связанной биллинговой учетной записи.
- В левом меню выберите отчеты , чтобы открыть страницу Billing Reports для связанной биллинговой учетной записи.
Как прочитать диаграмму отчетов о биллинге
Биллинг сообщает о заговоре со временем в качестве складывающейся линейной диаграммы. В представлении по умолчанию отображаются текущие ежедневные затраты, специфичные для использования, сгруппированные по проекту (для всех продуктов), включая любые применяемые кредиты для конкретного использования, а также общую прогнозируемую стоимость всего текущего месяца. Каждая строка в диаграмме (и строка в сводной таблице) соответствует проекту, которая занимает наибольшее до наименьшего по стоимости. Узнайте больше о интерпретации диаграммы отчетов счетов .
Совет: проанализируйте использование и стоимость за SKU
Чтобы более точно понять детали модели ценообразования оплаты как вы, и то, как она влияет на вашу реализацию, посмотрите на ваше использование и стоимость SKU.
Чтобы изменить представление отчета, чтобы отобразить строки на SKU:
- На панели справа от диаграммы расширить группу фильтром.
- Выберите SKU .
Другие доступные фильтры отчетов с выставлением счетов включают в себя диапазон времени , проекты , продукты , SKU и местоположения , которые позволяют вам фильтровать, откуда обслуживаются запросы API .
Чтобы классифицировать источник вашего использования в дополнение к продукту, Group Billing Reports от одного из перечисленных значений. Три ключа, которые относятся к API платформы Google Maps,-это Goog-Maps-Api-Key-Suffix (последние четыре символа клавиши API), Goog-Maps-Platform-Type (платформа: Android, iOS, JavaScript или Webservice) и Goog-Maps-Channel (установленное числовое значение канала из запроса API). Более подробная информация о фильтрации и группировке .
Вы можете изменить представление диаграммы, чтобы исключить кредиты, специфичные для использования, очистив флажок «Включите кредиты» в правой панели.
Контролировать и ограничить потребление
Чтобы помочь вам спланировать бюджет и контролировать затраты, вы можете сделать следующее:
- Установите предупреждение о бюджете , чтобы отследить, как ваши расходы растут к определенной сумме. Установка бюджета не ограничивает использование API, оно предупреждает вас только тогда, когда ваша сумма расходов приближается к указанной сумме.
Завершите свое ежедневное использование API , чтобы управлять вашей стоимостью использования оплачиваемых API. Установив ограничения на запросы в день , вы можете ограничить свои расходы. Используйте простое уравнение, чтобы определить свою ежедневную ограничение в зависимости от того, сколько вы хотите потратить. Например: (ежемесячные расходы /цена на каждый SKU) /30 = запросы в день CAP (для одного 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 - Карты JavaScript API
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
Следите за использованием канала непосредственно в вашем отчете о выставлении счетов. Каналы будут отражаться под этикетками как ключ GOOG-MAPS-канал .
Чтобы отфильтровать свой отчет по выставлению счетов Sku и Channel
- Используйте группу от Sku Filter.
- Выберите «Лейкс» .
- Выберите раскрытие клавиши и выберите Goog-Maps Channel .
- Выберите раскрытие значения и выберите численные каналы, которые вы хотите отфильтровать.
Group By Label Key Goog-Maps Channel, чтобы увидеть стоимость, генерируемой каждым каналом.
После того, как вы внедрили данные об использовании каналов в ваших запросах, может быть короткая задержка (до 24 часов), прежде чем данные будут отражены в вашем отчете о выставлении счетов.
Экспортируйте данные о выставлении счетов с помощью BigQuery
Вы также можете экспортировать данные о выставлении счетов в BigQuery .
BigQuery Export позволяет вам автоматически экспортировать подробные данные об облачных выставлениях (например, данные об использовании и оценке затрат) в течение дня в набор данных BigQuery , который вы указываете. Затем вы можете получить доступ к своим биллинговым данным от BigQuery для подробного анализа. Это дает дополнительный слой детализации в понимании источника использования платформы Google Maps.
Если вы хотите начать с экспорта BigQuery Export и запросить данные, вы можете попробовать пример запроса ниже. До запуска этого запроса вы должны:
- Включите экспорт биллинга и биллинга на свой счет.
- Формат таблицы - PROJECT_ID . DATASET_NAME .gcp_billing_export v1 BILLING_ACCOUNT_ID где:
- PROJECT_ID -ваш фактический идентификатор проекта (например, «My-Project-123456»).
- DATASET_NAME - это имя созданного вами набора данных (например, «smapredataset»).
- 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
Связанные ресурсы
Облачный биллинг:
- Создать, изменить или закрыть свой аккаунт по облачным выставлениям
- Изменить настройки выставления счетов проекта
- Посмотреть ваши отчеты о выставлении счетов и тенденции стоимости
- Установить бюджеты и бюджетные оповещения
- Закрытие использования API
Статус ответа и отчеты
В таблице ниже показано отображение между статусом API MAPS, кодом ответа HTTP, возвращаемом в ответах API MAPS и классом кода ответа HTTP в отчете об использовании, и указывает, появляется ли соответствующий запрос в отчетах об использовании, квотах и выставлении счетов.
Отчет об использовании в метриках платформы Google Maps предоставляет HTTP response code class Granularity. Если вам нужен более высокий уровень гранулярности, см. Коды состояния ответа, доступные в мониторинге использования платформы Google Maps .
| Коды ответов, доступные в ответах API MAPS | Доступно в отчете об использовании | Сообщается | |||
|---|---|---|---|---|---|
| Карты статуса API | Http -код ответа | Http code code code | Использование | Квота | Биллинг |
| ХОРОШО | 200, 204, 302 | 2xx, 3xx | Да | Да | Да |
| Data_not_available, НЕ НАЙДЕНО, Zero_Results | 200, 404 | 4xx 1 | Да | Да | Да |
| Invalid_Request (значение неверного параметра), Max_route_length_exeededed, Max_waypoints_exeeded, и т. д. | 200, 400 | 4xx | Да | Да | Да |
| Invalid_Request (Invalid/отсутствующий параметр, ошибка анализа запроса) | 200, 400 | 4xx | Да | Нет | Нет |
| Request_denied | 200, 400, 403 | 4xx 1 | Да | Нет | Нет |
| Over_daily_limit, Over_query_limit, Resource_exhausted, DailyLimitexeded, ratelimitexeded, USERRATELIMITEXEDED | 200, 403, 429 | 4xx 1 | Да | Нет | Нет |
| Unknown_error | 200, 500, 503 | 5xx 1 | Да | Да | Нет |
1 Чтобы улучшить согласованность отчетности по коду ошибок, API платформы Google Maps мигрируют: 1) из Code Code 2xx 2xx до 4xx для статусов API Maps: DATA_NOT_AVAILABLE , NOT_FOUND 4xx ZERO_RESULTS Для статусов API MAPS: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded , 3) от http -кода класса 2xx до 5xx для карт Статус API: UNKNOWN_ERROR . Вы можете увидеть оба кода ответов в течение переходного периода. Коды ответов, возвращаемые в ответах API MAPS, не меняются. Убедитесь, что увеличение показателей 4xx и/или 5xx в Google Maps Platform Metrics связано с этой миграцией, проверяя, какой точный код ответа увеличивается в исследователе метрик ( узнайте больше об использовании мониторинга Google Cloud для платформы Google Maps). | |||||
Отчеты о взаимодействии
Бизнес-аналитика
Платформа Google Maps дает вам представление о том, как пользователи взаимодействуют с вашими картами. Эти идеи включают ключевые показатели взаимодействия, такие как представления на карте или взаимодействие с POI. Вы можете проанализировать эти идеи, чтобы раскрыть популярные места для рекламы и маркетинга или оптимизировать ваш пользовательский опыт.
Способность отчетности бизнеса включает в себя:
- Просмотр моментального снимка Business Insights , чтобы увидеть ключевые тенденции в бизнесе с первого взгляда.
- Бурение, чтобы проанализировать конкретную метрику в консоли, чтобы глубоко погрузиться в понимание метрик более подробно
- Экспорт метрик в CSV , чтобы вы могли проанализировать данные бизнеса в своем любимом инструменте бизнес -анализа
Доступны показатели взаимодействия включают:
- Просмотры карты: Просмотры отслеживания на карте, возникающие в результате сковородок, масштабирования или наклонов. Просмотры карты вычисляются по почтовым коде еженедельно (время с воскресенья по субботу Тихоокеанского региона). Новые данные публикуются еженедельно в первую среду после периода наблюдения.
Владельцы проектов и пользователи с роли просмотра Analytics Maps могут просмотреть бизнес на странице метрик в Cloud Console. Проект должен иметь карты JavaScript API .
Вы можете проанализировать метрики взаимодействия непосредственно в консоли с фильтром и группой с помощью возможностей для глубокого погружения в метрики более подробно. Например, вы можете выбрать фильтровать по конкретному региону, чтобы узнать, как представления карт являются трендом только для почтовых кодов в этом регионе. С другой стороны, вы можете захотеть группировать по определенной области для объединения взаимодействий в этом регионе.
Пользователи могут экспортировать весь набор данных или отфильтрованное представление в CSV для дальнейшего анализа в вашем любимом инструменте бизнес -анализа. Вы можете скачать до 90 дней за раз, и загрузки более 60 тыс. Клеток будут усечены. Экспорт данных карт в CSV может занять несколько минут в зависимости от выбранного временного диапазона.
Метрики Business Insights являются анонимизированными и, следовательно, отражают только общие тенденции в взаимодействии с вашими картами. Низкие количества могут быть округлены до нуля, а вклады от выбросов могут быть уменьшены.
Вы можете контролировать доступ к бизнесу для вашего облачного проекта в консоли Cloud Google, используя разрешение на аналитику MAPS. Владельцам проектов предоставляется это разрешение по умолчанию и может предоставить доступ к другим пользователям по мере необходимости.
Business Insights не следует использовать для оценки ваших затрат на использование. Пожалуйста, обратитесь к отчетам об использовании для получения дополнительной информации об использовании.
Локатор плюс
Для пользователей Locator Plus аналитическая панель помогает вам анализировать и генерировать информацию из ваших данных, давая четкое представление о том, насколько хорошо ваши покупатели взаимодействуют с вашим локатором магазина. Вы можете измерить неделю своей производительности за неделю, в том числе количество просмотров, количество взаимодействий с поиском и деталями места, а также общий уровень взаимодействия. Кроме того, инструментальная панель предоставляет важные тесты о том, как ваша реализация сравнивается с другими ритейлерами.
- Перейдите в Locator Plus в консоли Google Cloud.
- Перейдите в раздел отчетов об участии Google Cloud Console, чтобы увидеть панель аналитики.
Отчет о сравнительном анализе позволяет сравнить ваши данные с агрегированными отраслевыми данными от других компаний, которые делятся своими данными. Сравнение обеспечивает ценный контекст, помогая вам установить значимые цели, получить представление о тенденциях отрасли и выяснить, как у вас дела по сравнению с вашими конкурентами.
Чтобы увидеть данные анализа, ваши данные о взаимодействии включены анонимно в контрольные показатели Google. Чтобы отказаться от просмотра, так и включения данных о взаимодействии анонимно в сравнительные отчеты, подайте билет на поддержку . Билет поддержки, как правило, будет разрешен в течение 3 дней.