Отчетность в 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 и сервисов:
- Откройте страницу выбора проекта в консоли облака:
- Выберите свой проект. Появится страница APIs & Services Dashboard.
Если страница не отображается, выберите кнопку менюи затем выберите API и службы .
Более подробную информацию см. в разделе Мониторинг использования API .
Обзорная страница Google Карт
Страница обзора Google Maps включает таблицу со списком включенных API и запросов на использование за последние 30 дней. Запросы по API также отображаются в виде графика. График выставления счетов показывает ваш текущий счет и общее использование за последние 3 месяца.
Чтобы получить доступ к странице обзора платформы Google Maps:
- Откройте страницу платформы Google Карт в консоли Cloud:
- В левом меню выберите Обзор .
Страница API и сервисов платформы Google Карт
Страница API и сервисов Google Maps содержит сетку плиток, представляющих API, SDK и другие сервисы, доступные для вашего проекта. В каждой плитке вы можете включить или отключить эту службу, выбрав Включить или Отключить , и вы можете получить доступ к информации об учетных данных, показателям и руководствам пользователя для включенных API. Вы также можете использовать фильтры страниц для просмотра включенных или отключенных сервисов и других категорий сервисов.
Чтобы получить доступ к странице API и сервисов платформы Google Карт:
- Откройте страницу платформы Google Карт в консоли Cloud:
- В левом меню выберите API и службы .
Страница показателей Google Maps
Страница Google Maps Metrics отображает три графика: Traffic, Errors и Median Latency. Данные об использовании в графиках можно сгруппировать по классу кода ответа, API, методу API, учетным данным, платформе и домену.
Под графиками на странице «Метрики» находится таблица API, в которой отображаются запросы, ошибки и задержки для выбранных вами API.
Используя раскрывающийся список API в верхней части, а также параметры группировки и фильтрации в правой панели, вы можете группировать и фильтровать отображаемые метрики использования, выбирая определенные или несколько API, учетные данные, классы кодов ответов, тип платформы и/или домен. Вы также можете выбрать период времени (от одного часа до последних 30 дней) и гранулярность (в секунду или день) для отображаемых метрик использования.
На следующих изображениях показаны фильтры платформы и домена для определенного API, когда в раскрывающемся списке «Группировать по» выбрана группировка по платформе и домену :
Чтобы получить доступ к странице показателей API платформы Google Карт:
- Откройте страницу платформы Google Карт в консоли Cloud:
- В левом меню выберите Метрики .
Отчетность по полномочиям
Вы можете фильтровать и группировать показатели по учетным данным, которые использовались для загрузки API.
Формат удостоверения | Значение |
---|---|
Имя ключа Например, «Ключ мобильного приложения» | Для загрузки API с помощью ?key=... использовался ключ API : имена ключей можно найти в консоли платформы Карт в разделе Ключи и учетные данные . |
Номер проекта Например, «номер_проекта:123456», где 123456 — номер вашего проекта. | Если вы видите эту учетную запись, есть две возможности:
|
Графы кодов ответов
Графики 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 Карт:
- Откройте страницу платформы Google Карт в консоли Cloud:
- В левом меню выберите Квоты .
- Выберите 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 .
Чтобы получить доступ к отчетам по выставлению счетов:
- Откройте страницу выбора проекта в консоли облака:
- Выберите проект.
- Выберите кнопку меню.
и затем выберите Выставление счетов .
- Если у вас несколько платежных аккаунтов, выберите Перейти к связанному платежному аккаунту , чтобы открыть страницу обзора для связанного платежного аккаунта.
- В левом меню выберите «Отчеты» , чтобы открыть страницу отчетов по выставлению счетов для связанного платежного аккаунта.
Как читать таблицу отчета по выставлению счетов
Отчеты по выставлению счетов отображают расходы с течением времени в виде составной линейной диаграммы. В представлении по умолчанию отображаются ежедневные расходы на использование в текущем месяце, сгруппированные по проектам (для всех продуктов), включая любые примененные кредиты на использование, а также общая прогнозируемая стоимость на весь текущий месяц. Каждая строка на диаграмме (и строка в сводной таблице) соответствует проекту, отсортированному по стоимости от наибольшего к наименьшему. Узнайте больше об интерпретации диаграммы отчета по выставлению счетов .

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


Чтобы изменить вид отчета для отображения позиций по артикулу:
- На панели справа от диаграммы разверните фильтр «Группировать по» .
- Выберите артикул .
Другие доступные фильтры отчетов по выставлению счетов включают «Диапазон времени» , «Проекты» , «Продукты» , «Артикул» и «Местоположения» , которые позволяют фильтровать по месту обработки запросов 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. Единственными допустимыми значениями каналов являются числа от 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 .

Чтобы отфильтровать отчет по счетам по артикулу и каналу
- Используйте фильтр «Группировать по артикулу».
- Выберите курсор «Метки ».
- Выберите раскрывающийся список «Ключ» и выберите goog-maps-channel .
- Выберите раскрывающийся список «Значение» и выберите числовые каналы, которые вы хотите отфильтровать.
Сгруппируйте по ключу метки 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
.
#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 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 Карт). |
Отчеты о взаимодействии
Бизнес-идеи
Платформа Google Карт дает вам представление о том, как пользователи взаимодействуют с вашими картами. Эти сведения включают ключевые показатели взаимодействия, такие как просмотры на карте или взаимодействия с POI. Вы можете анализировать эти сведения, чтобы выявить популярные местоположения для рекламы и маркетинга или оптимизировать пользовательский опыт.
Возможности отчетности по бизнес-аналитике включают в себя:
- Просмотр общего снимка бизнес-аналитики для быстрого просмотра ключевых тенденций в бизнес-аналитике
- Углубление анализа определенной метрики в консоли для более глубокого понимания метрик
- Экспорт показателей в CSV, чтобы вы могли анализировать данные бизнес-аналитики в своем любимом инструменте бизнес-анализа
Доступны следующие показатели вовлеченности:
- Просмотры карты: просмотры треков на карте, полученные в результате панорамирования, масштабирования или наклона. Просмотры карты вычисляются по почтовому индексу на еженедельной основе (с воскресенья по субботу по тихоокеанскому времени). Новые данные публикуются еженедельно в первую среду после периода наблюдения.
Владельцы проектов и пользователи с ролью Maps Analytics Viewer могут просматривать бизнес-аналитику на странице Metrics Page в Cloud Console. В проекте должен быть включен Maps JavaScript API .
Вы можете анализировать показатели вовлеченности непосредственно в консоли с помощью возможностей Фильтра и Группировки по, чтобы глубже погрузиться в показатели. Например, вы можете выбрать фильтрацию по определенному региону, чтобы узнать, как просмотры карты изменяются только для почтовых индексов в этом регионе. С другой стороны, вы можете захотеть сгруппировать по определенному региону, чтобы агрегировать взаимодействия в этом регионе.
Пользователи могут экспортировать весь набор данных или отфильтрованное представление в CSV для дальнейшего анализа в вашем любимом инструменте бизнес-анализа. Вы можете загружать до 90 дней за раз, и загрузки, превышающие 60 тыс. ячеек, будут усечены. Экспорт данных представлений карт в CSV может занять несколько минут в зависимости от выбранного временного диапазона.
Метрики бизнес-инсайтов анонимны и поэтому отражают только общие тенденции взаимодействия с вашими картами. Низкие значения могут быть округлены до нуля, а вклад выбросов может быть уменьшен.
Вы можете контролировать доступ к бизнес-аналитике для вашего проекта Cloud в Google Cloud Console с помощью разрешения Maps Analytics. Владельцы проектов получают это разрешение по умолчанию и могут предоставлять доступ другим пользователям по мере необходимости.
Бизнес-анализ не следует использовать для оценки расходов на использование. Для получения дополнительной информации об использовании см. отчеты об использовании .
,Отчетность в 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 и сервисов:
- Откройте страницу выбора проекта в консоли облака:
- Выберите свой проект. Появится страница 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 (Legacy) это сообщение указывает на то, что по крайней мере одно из мест, указанных в происхождении, назначении, назначении или путевых точках запроса, не может быть геокодирована. Для мест 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 (Legacy) , это сообщение указывает на то, что, по крайней мере, одно из мест, указанных в происхождении, назначении, назначении или путевых точках запроса, не может быть геокодирована. Для API геолокации это сообщение указывает на то, что входы были недостаточно для получения оценки местоположения. Для API дорог это сообщение указывает на то, что входные данные не могут быть разумно привязаны к дорогам. Это оплачиваемый запрос и будет потреблять квоту. |
Unknown_error | 5xx | Ошибка сервера, указывающая, что запрос не может быть выполнен: внутренняя ошибка, перегрузка службы, недоступная, время и другие. |
1 Чтобы улучшить согласованность отчетности по коду ошибок, API платформы Google Maps мигрируют: 1) Из Code Code http 2xx до 4xx для статусов API Maps: DATA_NOT_AVAILABLE , NOT_FOUND , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , ZERO_RESULTS , 3) от кода ответа http класс 2xx до 4xx для карт Статус API: userRateLimitExceeded . Вы можете увидеть оба кода ответов в течение переходного 2xx . Коды ответов REQUEST_DENIED возвращаемые в rateLimitExceeded API MAPS 5xx UNKNOWN_ERROR меняются . Убедитесь, что увеличение показателей 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, State View Static API, API геокодирования, направления API (Legacy), помещения API, API часового пояса, Geolocation API и API возвышения), но есть некоторые исключения:
- Для API матрицы расстояния (Legacy) единица квоты является элементом, которая является парой назначения происхождения.
- Для карт 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 (Legacy) | 1 запрос |
API матрицы расстояния (Legacy) | 1 элемент (пара-преодоление) Пара) |
Дороги API | 1 запрос |
Оптимизация маршрута API | 1 запрос |
Навигация SDK для Android | 1 пункт назначения |
Навигация SDK для iOS | 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-Map (установленное числовое значение канала из запроса 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 http 2xx до 4xx для статусов API Maps: DATA_NOT_AVAILABLE , NOT_FOUND , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , ZERO_RESULTS , 3) от кода ответа http класс 2xx до 4xx для карт Статус API: userRateLimitExceeded . Вы можете увидеть оба кода ответов в течение переходного 2xx . Коды ответов REQUEST_DENIED возвращаемые в rateLimitExceeded API MAPS 5xx UNKNOWN_ERROR меняются . Убедитесь, что увеличение показателей 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 не следует использовать для оценки ваших затрат на использование. Пожалуйста, обратитесь к отчетам об использовании для получения дополнительной информации об использовании.