Отчеты, доступные на платформе 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. Нажмите кнопку меню Меню, прокрутите вниз до пункта "Другие решения Google" и выберите Платформа Google Карт.

Оплата

В разделе Оплата в 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 Карты" можно выбрать до 10 графиков с информацией о трафике, ошибках и задержке. Данные могут группироваться по коду ответа, API или учетным данным. Вы можете отфильтровать результаты по одному или нескольким API.

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

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

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

Показатели

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

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

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

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

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

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

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

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

Это платный запрос, который будет учитываться в выделенной вам квоте.
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.

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

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

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

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

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

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

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

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

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

На этой странице предоставляются сведения только о запросах, использующих квоту. Это успешные запросы (OK, ZERO_RESULTS) и запросы, вызывающие ошибки сервера (NOT_FOUND, 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, чтобы не тратить лишнего на платные сервисы. Установив лимит на количество запросов в день, вы сможете управлять своим бюджетом. Воспользуйтесь простой формулой, чтобы определить дневное предельное значение в зависимости от того, сколько вы готовы потратить. Пример: (расходы за месяц / цена за каждый продукт) / 30 = ограничение на количество запросов в день (для одного API). Если вы используете несколько платных API, формулу необходимо скорректировать с учетом этих данных. Также не забывайте, что каждый месяц на использование платформы Google Карт предоставляется кредит в размере 200 долларов США.

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

Помимо сортировки по продукту, вы можете отслеживать источники использования через многочисленные каналы. Для этого в запросы необходимо добавить параметр channel. Единственно допустимые значения для этого параметра – это числа от 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>

Примечание. В настоящий момент данные по каналам недоступны для кода Geolocation.

Данные об использовании каналов доступны в отчете о платежах. Каналы отображаются под "Ярлыками" в раскрывающемся списке "Ключ": 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,
NOT_FOUND		 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 Да Да Да
INVALID_REQUEST (недопустимое значение параметра),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED,
и т. д. 		4xx Да Да Да
UNKNOWN_ERROR 5xx Да Да Нет