Отчеты, доступные на платформе Google Карт

Важно постоянно следить за количеством запросов, соблюдением квоты и расходами, связанными с платформой Google Карт. Мониторинг этих показателей позволяет отслеживать число запросов, сделанных в рамках проекта, оставаться в пределах лимитов, установленных для потребления ресурсов, и контролировать затраты c помощью функций для планирования бюджета. Также благодаря этим данным можно выявить нежелательное взаимодействие между вашими проектами и сервисами платформы Google Карт.

Cloud Console

Вы можете отслеживать количество запросов, соблюдение квоты и расходы, связанные с платформой Google Карт, в консоли Google Cloud Console (также называемой Cloud Console).

API и сервисы

В разделе API и сервисы в Cloud Console можно найти показатели всех API, включенных для проекта: API и SDK платформы Google Карт и других API Google и сервисов.

API и сервисы

Чтобы перейти в раздел "API и сервисы", выполните следующие действия:

  1. Откройте Cloud Console.
  2. Выберите проект.
  3. Нажмите кнопку меню Меню и выберите API и сервисы.

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

В разделе Платформа Google Карт в Cloud Console доступны показатели об использовании и квотах, связанных только с API и SDK платформы Google Карт (называемые здесь и далее API платформы Google Карт или просто API).

Панель управления Google Картами

Чтобы перейти в раздел "Платформа Google Карт", выполните следующие действия:

  1. Откройте Cloud Console.
  2. Выберите проект.
  3. Нажмите кнопку меню Меню, прокрутите вниз до пункта Other Google Products (Другие продукты Google) и выберите Google Maps Platform (Платформа Google Карт).

Billing (Оплата)

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

Панель управления оплатой

Чтобы перейти в раздел "Оплата", выполните следующие действия:

  1. Откройте Cloud Console.
  2. Выберите проект.
  3. Нажмите кнопку меню Меню и выберите Оплата.
  4. Если у вас несколько платежных аккаунтов, нажмите Открыть этот аккаунт.
    Откроется страница Общая информация со сведениями о связанном платежном аккаунте.
  5. В меню слева нажмите на Отчеты.
    Откроется страница Отчеты с информацией о расходах для связанного платежного аккаунта.

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

Показатели использования — это информация о том, сколько запросов было передано в API платформы Google Карт с учетными данными вашего проекта. Указываются как успешно выполненные запросы, так и запросы, которые приводят к ошибкам на стороне сервера или клиента. Учетные данные состоят из ключей API и идентификаторов клиента (для проектов пользователей, которые подписаны на план Premium или перешли на него).

Показатели использования представлены в таблицах ("Запросы", "Ошибки" и "Задержка") и на графиках ("Трафик", "Ошибки" и "Задержка"). Эти данные можно отфильтровать.

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

Панель управления в разделе "API и сервисы"

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

На странице "Панель управления" расположены три графика и таблица. Вы можете отфильтровать показатели использования, отображаемые в них, по периоду времени (от 1 часа до последних 30 дней).

В графике "Трафик" показано количество запросов в секунду (запросов/сек) для каждого API, в графике "Ошибки" отображается процент запросов, которые привели к ошибкам, для каждого API, а в графике "Задержка" вы увидите средние показатели задержки относительно запросов для каждого API.

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

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

Мониторинг API

Страница "Общая информация" в разделе "Google Карты"

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

Примечание. Если нажать на название включенного API, то откроется страница Показатели для этого API.

Общая информация

Страница "API" в разделе "Платформа Google Карт"

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

Примечание. Если нажать на название включенного API, то откроется страница Показатели для этого API.

API

Страница "Показатели" в разделе "Google Карты"

На странице Показатели в разделе "Google Карты" отображаются три графика: "Трафик", "Ошибки" и "Медианная задержка". Данные об использовании, показанные в этих графиках, можно сгруппировать по параметру "Код ответа", "API", "Способ вызова API" или "Учетные данные".

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

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

Показатели

Графики с данными, отфильтрованными по коду ответа

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

Статус ответа Класс кода ответа
(2xx, 3xx, 4xx, 5xx)
Примечания
OK 2xx Успешный ответ.

Это платный запрос, который будет учитываться в выделенной вам квоте.
OK 3xx Успешный ответ.

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

Например, успешные запросы фотографии места возвращают код ответа 302 и перенаправляют на соответствующее изображение.
DATA_NOT_AVAILABLE 2xx Успешный ответ. Он означает, что для указанных местоположений нет данных.

Это платный запрос, который будет учитываться в выделенной вам квоте.
ZERO_RESULTS 2xx Успешный ответ не вернул результат.

Это платный запрос, который будет учитываться в выделенной вам квоте.
NOT_FOUND 2xx При использовании Directions API это означает, что не удалось найти геокод как минимум для одного местоположения, указанного в параметрах запроса, таких как пункт отправления, пункт назначения или путевая точка.

Для Places API это означает, что указанное местоположение (place_id) отсутствует в базе данных Places.

Это платный запрос, который будет учитываться в выделенной вам квоте.
INVALID_REQUEST (недопустимое значение параметра),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED и т. д.
2xx Ошибка, вызванная недопустимым значением параметра, слишком большим количеством значений и т. д. Проверьте ответ API, чтобы получить больше информации.

Это платный запрос, который будет учитываться в выделенной вам квоте.
REQUEST_DENIED 4xx Ошибка клиента, вызванная ошибкой аутентификации, ошибкой доступа и т. д. Проверьте ответ API, чтобы получить больше информации.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateLimitExceeded,
dailyLimitExceeded,
userRateLimitExceeded
4xx Ошибка клиента, вызванная тем, что в разрешенный период времени отправлено слишком много запросов. Отправьте запрос повторно позже. Дополнительную информацию см. в ответе API.
INVALID_REQUEST (недопустимый параметр, отсутствующий параметр, ошибка анализа запроса) 4xx Ошибка клиента, вызванная недопустимым запросом. Дополнительную информацию см. в ответе API.
NOT_FOUND (404) 4xx При использовании Geolocation API это означает, что указанных данных недостаточно, чтобы определить местоположение.

Для Roads API это означает, что не удалось привязать указанные данные к Roads.

Это платный запрос, который будет учитываться в выделенной вам квоте.
UNKNOWN_ERROR 5xx Ошибка сервера, указывающая на то, что запрос невозможно обработать. Это может быть внутренняя ошибка, ошибка из-за перегрузки или недоступности сервиса, ошибка из-за превышения времени ожидания и т. д.

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

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

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

Мы стремимся улучшать наши решения и хотим понимать, как они работают в среде клиентов. Поэтому мы добавили в вызовы API параметр запроса solution_channel. С его помощью мы можем собирать информацию об использовании образца кода.

  • Параметр solution_channel используется в образце кода по умолчанию.
  • Он передает в Google обезличенные данные об адаптации решения. Мы используем эту информацию для улучшения качества наших продуктов.
  • Вы можете отказаться от передачи этих данных. Для этого удалите из образца кода параметр запроса solution_channel и его значение.
  • Вам не обязательно использовать этот параметр. Его удаление не повлияет на производительность.
  • Он используется только для передачи информации об использовании образца кода.
  • Параметр запроса не связан с функциями аналитики и отчетов API. Его удаление из образца кода решения не приведет к отключению внутренних отчетов Maps JavaScript API.

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

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

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

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

Страница "Квоты" в разделе "Google Карты"

На странице Квоты в разделе "Google Карты" представлена информация о том, сколько запросов можно отправить к выбранным API и какое количество уже было передано.

Диаграмма использования квот в Google Cloud Console показывает общий трафик, созданный вашими ключами API и идентификаторами клиента. Данные о трафике, связанном с передачей идентификаторов клиента, также отображаются на диаграмме "Показатели" в консоли Google Cloud Console. Подробная информация доступна в описании проблемы 158809616.

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

На запросы, которые приводят к ошибкам клиента, например ошибкам аутентификации, авторизации, передачи недопустимого аргумента (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (недействительный параметр, ошибка обработки запроса)), квота не распространяется. Поэтому данные о таких запросах здесь не показываются.

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

  • Для Distance Matrix API единица квоты – это элемент, представленный двумя параметрами: пунктом отправления и пунктом назначения.
  • Для Maps JavaScript API единицей квоты является загрузка карты.
  • Для Maps SDK для Android и Maps SDK для iOS единица квоты – это запрос функции Просмотра улиц или загрузка панорамы. Загрузки карт предоставляются бесплатно и не учитываются в квоте.
Квоты

Единицы квот

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

API платформы Google Карт Единица квоты
Карты
Maps SDK для Android 1 панорама
Maps SDK для iOS 1 панорама
Maps Static API 1 запрос
Maps JavaScript API 1 загрузка карты
Street View Static API 1 запрос
Maps Embed API 1 загрузка карты
Routes
Directions API 1 запрос
Distance Matrix API 1 элемент (пара: пункты отправления и назначения)
Roads API 1 запрос
Places
Places API 1 запрос
Geocoding API 1 запрос
Geolocation API 1 запрос
Time Zone API 1 запрос

Отчеты о платежах

Как посмотреть отчеты о платежах

Отчеты о платежах для продуктов платформы Google Карт доступны в Google Cloud Console (см. раздел Оплата).

Как анализировать данные на графике отчетов о платежах

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

Отчеты о платежах
Рисунок 1. График и таблица с отчетом о платежах, вид по умолчанию.

Совет. Анализируйте использование сервисов и расходы по коду продукта.

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

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

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

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

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

Отслеживание потребляемых ресурсов и соблюдение квоты

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

  • Настройте оповещения о достижении определенной суммы затрат. Они не ограничивают использование API, а просто предупреждают вас о том, сколько вы потратили.
  • Ограничьте ежедневное использование API, чтобы не тратить лишнего на платные сервисы. Установив лимит на количество запросов в день, вы сможете управлять своим бюджетом. Воспользуйтесь простой формулой, чтобы определить дневное предельное значение в зависимости от того, сколько вы готовы потратить. Пример: (расходы за месяц / цена за каждый продукт) / 30 = ограничение на количество запросов в день (для одного API). Если вы используете несколько платных API, формулу необходимо скорректировать с учетом этих данных. Также не забывайте, что каждый месяц на использование платформы Google Карт предоставляется кредит в размере 200 долларов США.

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

Чтобы отслеживать использование по числовым каналам, добавьте параметр channel в запросы API. Единственно допустимые значения для этого параметра – это числа от 0 до 999. Ниже приведены примеры.

  • Geocoding Web Service API

    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API

    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

Данные об использовании каналов доступны в отчете о платежах. Каналы отображаются в разделе Ярлыки в раскрывающемся списке "Ключ": goog-maps-channel.

Фильтр для сортировки данных по ярлыкам
Рисунок 4. Фильтр для сортировки данных по коду продукта и каналам.
Как отфильтровать отчет о платежах по коду продукта и каналу
  1. Примените фильтр Группировать по для сортировки по коду продукта.
  2. Нажмите на Ярлыки.
  3. Нажмите на раскрывающийся список Ключ и выберите: goog-maps-channel.
  4. Нажмите на раскрывающийся список Значение и выберите числовое значение для каналов, по которым вы хотите отфильтровать данные.

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

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

Экспорт данных о платежах в BigQuery

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

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

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

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

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

  #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:

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

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

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

Статус ответа Класс кода ответа
(2xx, 3xx, 4xx, 5xx)
Отчет об использовании Отчет о квоте Отчет о платежах
OK 2xx,
3xx
Да Да Да
ZERO_RESULTS,
DATA_NOT_AVAILABLE,
NOT_FOUND
2xx Да Да Да
INVALID_REQUEST (недопустимое значение параметра),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED,
и т. д.
2xx Да Да Да
REQUEST_DENIED 4xx Да Нет Нет
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
4xx Да Нет Нет
INVALID_REQUEST (недопустимый параметр, ошибка анализа запроса) 4xx Да Нет Нет
NOT_FOUND (Geolocation API и Roads API) 4xx Да Да Да
UNKNOWN_ERROR 5xx Да Да Нет