В консоли Google Cloud функция отчетности в Google Maps Platform предоставляет набор предопределенных визуальных отчетов об использовании основных API, квотах и платежной информации. Используйте эти отчеты, чтобы определить количество выполненных вами вызовов API, насколько близки вы к достижению квот на использование API и отслеживать использование платежных ресурсов с течением времени.
К типам отчетов относятся:
- Отчеты об использовании : Отображает количество запросов, которые ваш проект отправляет к API платформы Google Maps, используя учетные данные, связанные с вашим проектом.
- Отчеты по квотам : отображают использование квот в виде графиков, которые можно сгруппировать по количеству запросов в минуту. Текущие лимиты квот для выбранных API отображаются в таблицах под графиками использования квот.
- Отчеты по выставлению счетов : отображают динамику затрат в виде линейного графика с накоплением. Просматривается использование квоты за текущий месяц, включая все примененные кредиты, а также общая прогнозируемая стоимость за весь текущий месяц.
- отчеты об активности пользователей : предоставляют бизнес-аналитику о том, как пользователи взаимодействуют с вашими картографическими приложениями.
Полный список статусов и кодов ответов, определяющих, будет ли запрос отображаться в отчетах «Использование» , «Квота» и «Выставление счетов» , см. в разделе «Статусы ответов и отчеты» .
Просматривайте отчеты об использовании платформы Google Maps, квотах и выставлении счетов с помощью консоли Cloud .
Отчеты об использовании
Использование зависит от количества запросов, которые ваш проект отправляет к API платформы Google Maps, используя учетные данные, связанные с вашим проектом. Запросы включают успешные запросы, запросы, приводящие к ошибкам сервера, и запросы, приводящие к ошибкам клиента. Учетные данные включают ключи API и идентификаторы клиентов (для проектов с тарифным планом Premium и проектов с перенесенным тарифным планом Premium). Для получения подробной информации см. Обзор тарифного плана Premium и информацию об использовании идентификатора клиента .
Показатели использования отображаются в таблицах (запросы, ошибки и задержка) и графиках (трафик, ошибки и задержка). В целях отслеживания:
Все API : Вы можете фильтровать и группировать метрики использования для всех API следующими способами:
- Фильтрация по временному периоду и API.
- Просмотрите данные о трафике, ошибках и задержках, сгруппированные по коду ответа, API и учетным данным.
Для конкретного API : Вы можете фильтровать и группировать метрики использования для конкретного API следующими способами:
- Фильтрация по временному периоду, версиям API, учетным данным и методам.
- Просматривайте трафик, ошибки и задержки, сгруппированные по коду ответа, методу и версии API, а также учетным данным.
Страница панели управления API и сервисами
Панель мониторинга API и сервисов предоставляет обзор показателей использования всех API, включенных для вашего проекта: API платформы Google Maps, а также других API и сервисов.
На странице «Панель управления» представлены три графика и таблица. Вы можете отфильтровать отображаемое на графиках и в таблицах использование, выбрав период времени от 1 часа до последних 30 дней.
График трафика показывает использование в запросах в минуту (QPM) для каждого API.
График ошибок показывает процент запросов, которые привели к ошибкам, для каждого API.
График задержки показывает медианную задержку запросов для каждого API.
Под графиками находится таблица со списком включенных API и сервисов. Запросы — это количество запросов (за выбранный период времени). Ошибки — это количество запросов, завершившихся ошибкой. Задержка (средняя задержка и процентиль) — это задержка для этих запросов.
Чтобы получить доступ к странице панели управления API и сервисами:
- Откройте страницу выбора проекта в консоли Cloud:
- Выберите свой проект. Откроется страница «Панель управления API и сервисами».
Если страница не отображается, нажмите кнопку меню.
а затем выберите API и сервисы .
Для получения более подробной информации см. раздел «Мониторинг использования API» .
Обзорная страница Google Maps
На странице обзора Google Maps представлена таблица со списком включенных API и запросов на использование за последние 30 дней. Запросы по API также отображаются в виде графика. График выставления счетов показывает ваш текущий счет и общее использование за последние 3 месяца.
Чтобы перейти на страницу обзора платформы Google Maps:
- Откройте страницу платформы Google Maps в консоли Cloud:
- В левом меню выберите «Обзор» .
Страница API и сервисов платформы Google Maps
На странице «API и сервисы Google Maps» представлена сетка плиток, отображающих API, SDK и другие сервисы, доступные для вашего проекта. В каждой плитке вы можете включить или отключить соответствующий сервис, выбрав «Включить» или «Отключить» , а также получить доступ к информации об учетных данных, метрикам и руководствам пользователя для включенных API. Вы также можете использовать фильтры страницы для просмотра включенных или отключенных сервисов и других категорий сервисов.
Чтобы получить доступ к странице API и сервисов платформы Google Maps:
- Откройте страницу платформы Google Maps в консоли Cloud:
- В левом меню выберите «API и сервисы» .
Страница метрик Google Maps
На странице метрик Google Maps отображаются три графика: трафик, ошибки и медианная задержка. Данные об использовании на графиках можно сгруппировать по классу кода ответа, API, методу API, учетным данным, платформе и домену.
Под графиками на странице «Метрики» находится таблица API, в которой отображаются запросы, ошибки и задержка для выбранных вами API.
Используя выпадающее меню API вверху и параметры группировки и фильтрации в правой панели, вы можете группировать и фильтровать отображаемые показатели использования, выбирая определенные или несколько API, учетные данные, классы кодов ответа, тип платформы и домен. Вы также можете выбрать период времени (от одного часа до последних 30 дней) и детализацию (посекундно или посуточно) для отображаемых показателей использования.
На следующих изображениях показаны фильтры «Платформа» и «Домен» для конкретного API при выборе группировки по платформе и домену в раскрывающемся списке «Группировка по»:
Чтобы получить доступ к странице метрик API платформы Google Maps:
- Откройте страницу платформы Google Maps в консоли Cloud:
- В левом меню выберите «Метрики» .
Отчетность по учетным данным
Вы можете фильтровать и группировать метрики по учетным данным, которые использовались для загрузки API.
| Формат учетных данных | Значение |
|---|---|
| Имя ключа Например, «Ключ мобильного приложения» | Для загрузки API использовался ключ API с параметром ?key=... : Названия ключей можно найти в консоли платформы карт в разделе «Ключи и учетные данные» . |
| Номер проекта Например, "project_number:123456", где 123456 — это номер вашего проекта. | Если вы видите эти учетные данные, возможны две ситуации:
|
Графики кодов ответов
Графики «Трафик по коду ответа» и «Ошибка по коду ответа» показывают распределение использования по классам кодов HTTP-ответов. В этой таблице показано соответствие между статусом ответа API платформы Google Maps и классом кода HTTP-ответа:
| статус API карт | Класс кода ответа HTTP — Отчет об использовании (2xx, 3xx, 4xx, 5xx) | Примечания |
|---|---|---|
| ХОРОШО | 2xx | Успешный ответ. Это платный запрос, который будет расходовать квоту. |
| ХОРОШО | 3xx | Успешный ответ. Это платный запрос, который будет расходовать квоту. Например, при успешном выполнении запроса на добавление фотографии возвращается перенаправление 302 на указанное изображение. |
| ДАННЫЕ НЕ ДОСТУПНЫ | 4xx ( 1 ) | Успешный ответ, указывающий на отсутствие доступных данных для указанных местоположений. Это платный запрос, который будет расходовать квоту. |
| НУЛЕВЫЕ РЕЗУЛЬТАТЫ | 4xx ( 1 ) | Успешный ответ не дал результата. Это платный запрос, который будет расходовать квоту. |
| НЕ НАЙДЕНО | 4xx ( 1 ) | В случае с API построения маршрутов (устаревшая версия) это сообщение указывает на то, что как минимум одно из местоположений, указанных в запросе (начальная точка, конечная точка или путевые точки), не удалось геолоцировать. Для API Places это сообщение указывает на то, что указанное местоположение (place_id) не найдено в базе данных Places. Это платный запрос, который будет расходовать квоту. |
| INVALID_REQUEST (недопустимое значение параметра), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED и другие. | 4xx | Ошибка вызвана недопустимым значением параметра. Для получения более подробной информации проверьте ответ API. Это платный запрос, который будет расходовать квоту. |
| ЗАПРОС_ОТКАЗАН | 4xx | Ошибка клиента, вызванная ошибкой аутентификации, ошибкой доступа и другими причинами. Для получения более подробной информации проверьте ответ API. |
| ПРЕВЫШЕНИЕ ДНЕВНОГО ЛИМИТА, OVER_QUERY_LIMIT, ИСТОЧНИК_ИСЧЕЗ, rateLimitExceeded, Превышен ежедневный лимит, userRateLimitExceeded | 4xx | Ошибка клиента вызвана слишком большим количеством запросов за допустимый период времени. Повторите запрос позже. Для получения более подробной информации проверьте ответ API. |
| INVALID_REQUEST (недопустимый или отсутствующий параметр, ошибка анализа или проверки запроса) | 4xx | Ошибка клиента вызвана некорректным запросом. Для получения более подробной информации проверьте ответ API. |
| NOT_FOUND (404) | 4xx | Для В сообщении об ошибке API Directions (устаревшая версия) указывается, что как минимум одно из мест, указанных в запросе (начальная точка, конечная точка или путевые точки), не удалось геолоцировать. В случае с API геолокации это сообщение указывает на то, что входных данных было недостаточно для получения приблизительной оценки местоположения. В случае API для дорог это сообщение указывает на то, что входные данные не удалось корректно связать с дорогами. Это платный запрос, который будет расходовать квоту. |
| НЕИЗВЕСТНАЯ ОШИБКА | 5xx | Ошибка сервера, указывающая на невозможность выполнения запроса: внутренняя ошибка, перегрузка службы, недоступность, истечение времени ожидания и другие. |
1. Для повышения согласованности сообщений об ошибках API платформы Google Maps переходят на следующие типы кодов: 1) с класса кодов HTTP-ответа 2xx на 4xx для статусов API карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS ; 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 Maps связано с этой миграцией, проверив, какой именно код ответа увеличился в обозревателе метрик ( подробнее об использовании мониторинга Google Cloud для платформы Google Maps).
Для получения более подробной информации о кодах состояния и сообщениях об ошибках см. документацию по ответам для интересующего вас API (например, ответы на запросы геокодирования или ответы на запросы маршрутов ).
Параметр атрибуции использования платформы Google Maps
Платформа Google Maps предоставляет множество примеров кода, которые помогут вам быстро начать работу. Например, вы можете использовать Quick Builder в консоли Cloud, следовать руководствам по внедрению отраслевых решений и учиться на примерах кода .
Чтобы понять, как используются наши решения, и найти способы их улучшения, Google включает параметр internal_usage_attribution_ids в вызовы API для сбора информации об использовании примеров кода:
- Параметр
internal_usage_attribution_idsможет быть включен по умолчанию в пример кода решения. - Этот параметр передает Google аналитические данные об использовании решения для повышения его качества в будущих итерациях.
- Вы можете отказаться от этого, удалив параметр
internal_usage_attribution_idsи его значение из примера кода. - Нет необходимости сохранять этот параметр. Удаление параметра не влияет на производительность.
- Этот параметр используется только для формирования отчетов об использовании примеров кода.
- Этот параметр отделен от любой аналитики и отчетности, специфичных для API. Это означает, что удаление параметра из примера кода решения не отключает внутреннюю отчетность API JavaScript для карт.
Отчеты по квотам
Квоты устанавливают ограничения на количество запросов, которые ваш проект может отправлять к API платформы Google Maps. Количество запросов может быть ограничено тремя способами: в день, в минуту и на пользователя в минуту. В рамках квоты учитываются только успешные запросы и запросы, вызывающие ошибки сервера. Запросы, не прошедшие аутентификацию, в квоту не учитываются.
Использование квот отображается в виде графиков на странице «Квоты» в консоли Cloud и может быть сгруппировано по количеству запросов в минуту. Текущие лимиты квот для выбранных API отображаются в таблицах под графиками использования квот.
Чтобы рассчитать поминутную квоту для любого продукта, соответствующего требованиям GMP API, воспользуйтесь этим калькулятором .
Страница квот 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 (API Maps Static, API Street View Static, API геокодирования, API Directions (Legacy), API Places, API часовых поясов, API геолокации и API высот), но есть и некоторые исключения:
- В API матрицы расстояний (устаревшая версия) единицей квоты является элемент, представляющий собой пару "пункт отправления - пункт назначения".
- В JavaScript API для работы с картами единицей квоты является загрузка карты.
- Для Maps SDK для Android и Maps SDK для iOS единицей квоты является запрос на просмотр улиц или загрузка панорамы. Загрузка карт предоставляется бесплатно и не расходует квоту.
Чтобы получить доступ к странице квот платформы Google Maps:
- Откройте страницу платформы Google Maps в консоли Cloud:
- В левом меню выберите «Квоты» .
- Выберите API из выпадающего списка API.
квотных единиц
В этой таблице показана единица квоты для API платформы Google Maps.
| API платформы Google Maps | Единица квоты |
|---|---|
| Карты | |
| 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 Запрос |
| SDK для навигации для Android | 1 Пункт назначения |
| SDK для навигации в iOS | 1 Пункт назначения |
| Места | |
| API мест | 1 Запрос |
| API для агрегирования мест | 1 Запрос |
| API проверки адресов | 1 Запрос |
| API геокодирования | 1 Запрос |
| API геолокации | 1 Запрос |
| API часовых поясов | 1 Запрос |
| Среда | |
| API качества воздуха (текущие условия и тепловая карта) | 1 Запрос |
| API качества воздуха (история) | 1 страница |
| API пыльцы | 1 Запрос |
| Солнечный API | 1 Запрос |
| API погоды | 1 Запрос |
Отчеты по выставлению счетов
Просмотрите отчет о выставленных счетах
Отчеты о выставлении счетов за использование продуктов платформы Google Maps доступны в консоли Google Cloud. Для получения дополнительной информации см. раздел «Выставление счетов» .
Для доступа к отчетам по выставлению счетов:
- Откройте страницу выбора проекта в консоли Cloud:
- Выберите проект.
- Выберите кнопку меню а затем выберите «Оплата» .
- Если у вас несколько платежных аккаунтов, выберите «Перейти к связанному платежному аккаунту» , чтобы открыть страницу обзора для связанного платежного аккаунта.
- В левом меню выберите «Отчеты» , чтобы открыть страницу отчетов по выставлению счетов для связанного платежного аккаунта.
Как читать диаграмму отчета о выставлении счетов
В отчетах по выставлению счетов стоимость отображается в виде линейного графика с накоплением. В режиме просмотра по умолчанию отображаются ежедневные затраты за текущий месяц, сгруппированные по проектам (для всех продуктов), включая любые примененные скидки за использование, а также общая прогнозируемая стоимость за весь текущий месяц. Каждая линия на графике (и строка в сводной таблице) соответствует проекту, отсортированному по стоимости от наибольшей к наименьшей. Подробнее об интерпретации графика в отчете по выставлению счетов можно узнать здесь .
Совет: Проанализируйте использование и стоимость каждой товарной позиции (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 для управления затратами на использование платных API. Устанавливая лимиты на количество запросов в день , вы можете ограничить свои расходы. Используйте формулу для определения вашего дневного лимита в зависимости от того, сколько вы хотите потратить. Например: (Ежемесячные расходы / цена за каждый SKU) / 30 = лимит запросов в день (для одного API).
Отслеживание использования по каждому каналу
Для отслеживания использования с помощью числовых каналов необходимо добавить параметр 'channel' к запросам 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 для автоматического экспорта подробных данных о выставлении счетов за облачные услуги (таких как данные об использовании и оценке стоимости) в течение дня в указанный вами набор данных BigQuery . Затем вы сможете получить доступ к данным о выставлении счетов из BigQuery для детального анализа. Это обеспечивает дополнительный уровень детализации в понимании источников использования платформы Google Maps.
Если вы хотите начать работу с экспортом данных в 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
- Платформа Google Maps: выставление счетов
- Руководство по оптимизации
- Рекомендации по использованию API-ключей
Статус ответа и отчеты
В таблице ниже показано соответствие между статусом API карт, кодом ответа HTTP, возвращаемым в ответах API карт, и классом кода ответа HTTP в отчете об использовании, а также указано, отображается ли соответствующий запрос в отчетах об использовании, квотах и выставлении счетов.
Отчет об использовании в метриках платформы Google Maps
Обеспечьте детализацию по HTTP response code class . Если вам требуется более высокий уровень детализации, см. раздел «Коды состояния ответа».
Доступно в системе мониторинга использования платформы Google Maps .
| Коды ответов, доступные в ответах API карт. | Доступно в отчете об использовании | Сообщили в | |||
|---|---|---|---|---|---|
| статус API карт | код ответа HTTP | класс кода ответа HTTP | Использование | Квота | Выставление счетов |
| ХОРОШО | 200, 204, 302 | 2xx, 3xx | Да | Да | Да |
| ДАННЫЕ НЕДОСТУПНЫ. НЕ НАЙДЕНО, НУЛЕВЫЕ РЕЗУЛЬТАТЫ | 200, 404 | 4xx 1 | Да | Да | Да |
| INVALID_REQUEST (недопустимое значение параметра), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, и т. д. | 200, 400 | 4xx | Да | Да | Да |
| INVALID_REQUEST (недопустимый/отсутствующий параметр, ошибка разбора запроса) | 200, 400 | 4xx | Да | Нет | Нет |
| ЗАПРОС_ОТКАЗАН | 200, 400, 403 | 4xx 1 | Да | Нет | Нет |
| ПРЕВЫШЕНИЕ ДНЕВНОГО ЛИМИТА, OVER_QUERY_LIMIT, ИСТОЧНИК_ИСЧЕЗ, Превышен ежедневный лимит, rateLimitExceeded, userRateLimitExceeded | 200, 403, 429 | 4xx 1 | Да | Нет | Нет |
| НЕИЗВЕСТНАЯ ОШИБКА | 200, 500, 503 | 5xx 1 | Да | Да | Нет |
1. Для повышения согласованности сообщений об ошибках API платформы Google Maps переходят на следующие типы кодов: 1) с класса кодов HTTP-ответа 2xx на 4xx для статусов API карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS ; 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 Maps связано с этой миграцией, проверив, какой именно код ответа увеличился в обозревателе метрик ( подробнее об использовании мониторинга Google Cloud для платформы Google Maps). | |||||
Отчеты об участии
Аналитика бизнеса
Платформа Google Maps предоставляет информацию о том, как пользователи взаимодействуют с вашими картами. Эта информация включает в себя ключевые показатели вовлеченности, такие как просмотры карты или взаимодействие с объектами интереса. Вы можете анализировать эти данные, чтобы выявлять популярные места для рекламы и маркетинга или оптимизировать пользовательский опыт.
Возможности формирования отчетов на основе бизнес-аналитики включают в себя:
- Просмотр сводной информации о бизнес-показателях позволяет быстро увидеть ключевые тенденции в этой области.
- Углубленный анализ конкретной метрики в консоли для более детального изучения показателей.
- Экспорт метрик в CSV-файлы для анализа данных бизнес-аналитики в вашем любимом инструменте бизнес-анализа.
Доступные показатели вовлеченности включают:
- Просмотры карты: Отслеживаются виды на карте, возникающие в результате панорамирования, масштабирования или наклона. Просмотры карты рассчитываются по почтовым индексам еженедельно (с воскресенья по субботу по тихоокеанскому времени). Новые данные публикуются еженедельно в первую среду после окончания периода наблюдений.
Владельцы проектов и пользователи с ролью « Просмотрщик аналитики карт» могут просматривать бизнес-аналитику на странице метрик в Cloud Console. Для этого в проекте должен быть включен API JavaScript для работы с картами .
Вы можете анализировать показатели вовлеченности непосредственно в консоли, используя функции фильтрации и группировки, чтобы более детально изучить метрики. Например, вы можете отфильтровать данные по определенному региону, чтобы узнать, как меняется количество просмотров карты только для почтовых индексов в этом регионе. С другой стороны, вы можете сгруппировать данные по определенному региону, чтобы агрегировать взаимодействия внутри этого региона.
Пользователи могут экспортировать весь набор данных или отфильтрованное представление в CSV для дальнейшего анализа в своем любимом инструменте бизнес-анализа. Вы можете загрузить данные за период до 90 дней, при этом файлы, содержащие более 60 000 ячеек, будут обрезаны. Экспорт данных карт в CSV может занять несколько минут в зависимости от выбранного временного диапазона.
Показатели бизнес-аналитики анонимизированы и, следовательно, отражают только общие тенденции взаимодействия с вашими картами. Низкие значения могут быть округлены до нуля, а вклад выбросов может быть уменьшен.
Вы можете управлять доступом к бизнес-аналитике для своего облачного проекта в консоли Google Cloud, используя разрешение Maps Analytics. Владельцы проектов получают это разрешение по умолчанию и могут предоставлять доступ другим пользователям по мере необходимости.
Аналитические данные компании не следует использовать для оценки ваших затрат на использование ресурсов. Для получения более подробной информации об использовании ресурсов обратитесь к отчетам об использовании .