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

Отчеты на платформе 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

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

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

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

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

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

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

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

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

Снимок экрана: обзорная диаграмма, на которой показана таблица со списком включенных API и   Запросы API за последние 30 дней.

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

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

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

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

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

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

апис

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

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

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

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

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

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

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

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

Страница показателей с тремя графиками: трафик, ошибки и медианная задержка.

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

Фильтр «Платформа» отображается только в том случае, если выбран один API.Фильтр «Платформа» отображается только в том случае, если выбран один API.

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

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

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

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

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

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

Формат учетных данных Значение
Имя ключа
Например, «Ключ мобильного приложения».
Для загрузки API использовался ключ API с помощью ?key=... . Имена ключей можно найти в консоли платформы Maps в разделе «Ключи и учетные данные» .
Номер проекта
Например, «номер_проекта:123456», где 123456 — номер вашего проекта.
Если вы видите эти учетные данные, есть две возможности:
  1. Для API, которые принимают идентификаторы клиентов платформы Карт : для загрузки API использовался идентификатор клиента платформы Карт. Например, используя &client=gme-_mycompany_ .

    Эти API принимают клиентские IDS: API JavaScript Карт, Статический API Карт, Статический API просмотра улиц, API высот, API направлений, API матрицы расстояний, API геокодирования, API часовых поясов. Дополнительную информацию см. в разделе Управление идентификаторами клиентов плана Премиум .

  2. Для API, поддерживающих OAuth : API был загружен с использованием OAuth без ключа API.

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

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

Статус API Карт Класс кода ответа HTTP – отчет об использовании
(2хх, 3хх, 4хх, 5хх)
Примечания
ХОРОШО 2хх Успешный ответ.

Это платный запрос, на который будет использована квота.
ХОРОШО 3хх Успешный ответ.

Это платный запрос, на который будет использована квота.

Например, успешные запросы Place Photo возвращают 302-перенаправление на указанное изображение.
ДАННЫЕ_NOT_AVAILABLE 4xx ( 1 ) Успешный ответ указывает на отсутствие доступных данных для входных местоположений.

Это платный запрос, на который будет использована квота.
ZERO_RESULTS 4xx ( 1 ) Успешный ответ не дал результата.

Это платный запрос, на который будет использована квота.
НЕ НАЙДЕНО 4xx ( 1 ) Для 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 Cloud Console. Это показывает   квоты по API с помощью селектора, затем отображаются загрузки карт относительно установленных квот.   для рассматриваемого API.

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

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

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

  2. В меню слева выберите «Квоты» .
  3. Выберите 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 запрос
Навигационный SDK для Android 1 пункт назначения
Навигационный SDK для iOS 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. Дополнительную информацию см. в разделе «Выставление счетов» .

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

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

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

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

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

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

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

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

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

Отчет о платежах, сгруппированный по артикулам
Рисунок 2. Таблица выставления счетов, в которой показаны позиции использования и стоимости по SKU.
Скриншот фильтров отчета о платежах
Рисунок 3. Фильтры отчета о выставлении счетов.
Чтобы изменить вид отчета для отображения позиций по SKU:
  1. На панели справа от диаграммы разверните фильтр «Группировать по» .
  2. Выберите артикул .

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

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

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

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

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

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

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

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

  • API веб-службы геокодирования
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • API JavaScript Карт
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

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

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

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

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

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

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

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

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

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

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

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

Платформа Google Карт:

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

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

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