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

Чтобы перейти в раздел "API и сервисы", выполните следующие шаги:
- Откройте Google Cloud Platform Console.
- Выберите проект.
- Нажмите кнопку меню
и выберите API и сервисы.
Google Карты
В разделе Google Карты в консоли Cloud Console доступны показатели об использовании и квотах, связанных только с API и SDK платформы Google Карт (называемые здесь и далее API платформы Google Карт или просто API).

Чтобы перейти в раздел "Google Карты", выполните следующие шаги:
- Откройте Google Cloud Platform Console.
- Выберите проект.
- Нажмите кнопку меню
, прокрутите вниз до пункта "Другие решения Google" и выберите Google Карты.
Оплата
В разделе Оплата в консоли Cloud Console можно найти информацию об оплате счетов и расходах, связанных с выбранным проектом.

Чтобы перейти в раздел "Оплата", выполните следующие шаги:
- Откройте Google Cloud Platform Console.
- Выберите проект.
- Нажмите кнопку меню
и выберите Оплата.
- Если у вас несколько платежных аккаунтов, нажмите Открыть этот аккаунт.
Откроется страница Общая информация со сведениями о связанном платежном аккаунте. - В меню слева нажмите на Отчеты.
Откроется страница Отчеты с информацией о расходах для связанного платежного аккаунта.
Отчеты об использовании
Показатели использования — это информация о том, сколько запросов было передано в API платформы Google Карт с учетными данными вашего проекта. Указываются как успешно выполненные запросы, так и запросы, которые приводят к ошибкам на стороне сервера или клиента. Учетные данные состоят из ключей API и идентификаторов клиента (для проектов пользователей, которые подписаны на план Premium или перешли на него).
Показатели использования представлены в таблицах ("Запросы", "Ошибки" и "Задержка") и на графиках ("Трафик", "Ошибки" и "Задержка"). Эти данные можно отфильтровать.
- Показатели использования для всех API можно отфильтровать по периоду времени и API. Вы также можете отследить трафик, ошибки и задержку, сгруппированные по коду ответа, API и учетным данным.
- Показатели использования для конкретного API можно отфильтровать по периоду времени, учетным данным, версиям и методам API. Кроме того, вы можете отследить трафик, ошибки и задержку, сгруппированные по коду ответа, методу и версии API, а также учетным данным.
Панель управления в разделе "API и сервисы"
На Панели управления в разделе "API и сервисы" можно найти общие сведения о показателях использования для всех API, включенных для проекта (API платформы Google Карт и других API и сервисов).
На странице "Панель управления" расположены три графика и таблица. Вы можете отфильтровать показатели использования, отображаемые в них, по периоду времени (от 1 часа до последних 30 дней).
В графике "Трафик" показано количество запросов в секунду (запросов/сек) для каждого API, в графике "Ошибки" отображается процент запросов, которые привели к ошибкам, для каждого API, а в графике "Задержка" вы увидите средние показатели задержки относительно запросов для каждого API.
Под графиками расположена таблица, в которой перечислены включенные API и сервисы. В столбце "Запросы" указано количество запросов (за выбранный период времени), а в столбце "Ошибки" – число запросов, которые привели к ошибкам. В столбце "Задержка" (средняя задержка и процентиль) отображаются показатели задержки для этих запросов.
Подробная информация доступна на странице Мониторинг данных об использовании API.

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

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

Страница "Учетные данные" в разделе "Google Карты"
На странице Учетные данные в разделе "Google Карты" отображаются данные, которые вы создали для аутентификации, например ключи API, идентификаторы клиента с токенами OAuth и/или ключи аккаунта. В таблицах на этой странице перечислены атрибуты, которые идентифицируют учетные данные, включая название учетных данных, дату создания, установленные ограничения, а также номер ключа API, номер идентификатора клиента и адрес электронной почты для сервисного аккаунта.
Также доступны сведения об использовании ключей API и ключей сервисных аккаунтов.
- Использование этого сервиса за последние 30 дней: сколько раз использовались учетные данные для вызова этого сервиса. Учитываются ситуации с использованием данных бесплатно и по тарифу.
- Использование всех сервисов за последние 30 дней: сколько раз использовались учетные данные для вызова какого-либо сервиса. Учитываются ситуации с использованием данных бесплатно и по тарифу.
Под 'этим сервисом" подразумевается выбранный в данный момент API Google Карт, а под "всеми сервисами" — любые без исключения API Google Карт, которые используют учетные данные.
Страница "Показатели" в разделе "Google Карты"
На странице Показатели в разделе "Google Карты" можно выбрать до 10 графиков с информацией о трафике, ошибках и задержке. Данные могут группироваться по коду ответа, API или учетным данным. Вы можете отфильтровать результаты по одному или нескольким API.
На странице "Показатели" под графиками находится таблица с данными об API, в которой отображаются запросы, ошибки и задержка для выбранных API.
В раскрывающемся меню "API" вы можете выбрать версию, учетные данные и методы API. Также данные в графиках можно отфильтровать по периоду времени (от 1 часа до последних 30 дней).
Показатели об использовании в графиках с информацией о трафике, ошибках и задержке можно сгруппировать по методу и версии API, коду ответа и учетным данным.

Графики с данными, отфильтрованными по коду ответа
Сведения в графиках о трафике и ошибках, отфильтрованных по коду ответа, распределяются на основе класса кода ответа. В таблице ниже описаны статусы ответа и соответствующие классы кода ответа для API, доступных на платформе Google Карт.
Статус ответа | Класс кода ответа (2xx, 4xx, 5xx) |
Примечания |
---|---|---|
OK | 2xx | Успешный ответ. Это платный запрос, который будет учитываться в выделенной вам квоте. |
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 Platform Console (см. Оплата).
Как анализировать данные в графике отчетов о платежах
В отчетах о платежах расходы отображаются за определенный период времени в виде графика. По умолчанию мы видим ежедневные затраты за текущий месяц, сгруппированные по проектам (для всех продуктов), включая все примененные кредиты, а также общую прогнозируемую сумму на весь текущий месяц. Каждая линия на графике (и строка в сводной таблице) соответствует проектам, отсортированным от наиболее до менее затратных. Подробнее о том, как анализировать данные из графика отчетов о платежах…

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


Чтобы отсортировать строки отчета по коду продукта, выполните следующие действия.
- На панели справа от графика разверните фильтр Группировать по.
- Выберите Код продукта.
Для сортировки данных в отчете о платежах можно использовать такие фильтры, как Период, Проекты, Продукты и Коды продуктов.
Вы можете изменить внешний вид графика и убрать из отчета данные о кредитах, сняв флажок в поле Включать кредиты в стоимость на панели справа.
Отслеживание потребляемых ресурсов и соблюдение квоты
Чтобы планировать бюджет и контролировать расходы, выполните следующие действия.
- Настройте оповещение о бюджете, чтобы следить за тем, как увеличиваются затраты. Благодаря оповещению вы узнаете, что ваши расходы приближаются к установленной сумме, однако использование 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>
Примечание. В настоящий момент данные по каналам недоступны для следующих продуктов:
Данные об использовании каналов доступны в отчете о платежах. Каналы отображаются под "Ярлыками" в раскрывающемся списке "Ключ": goog-maps-channel.

Чтобы отфильтровать отчет о платежах по коду продукта и каналу, выполните следующие шаги:
- Примените фильтр Группировать по для сортировки по коду продукта.
- Нажмите на Ярлыки.
- Нажмите на раскрывающийся список Ключ и выберите: goog-maps-channel.
- Нажмите на раскрывающийся список Значение и выберите числовое значение для каналов, по которым вы хотите отфильтровать данные.
Можно также сгруппировать данные по ключу ярлыка: 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:
- Создание, изменение или закрытие платежного аккаунта Cloud
- Изменение настроек оплаты для проекта
- Просмотр отчетов о платежах и динамики стоимости
- Настройка бюджетов и оповещений о бюджете
- Ограничение использования API
Платформа Google Карт:
Статус ответов и отчеты
В таблице ниже перечислены статусы ответа и классы кода ответа, а также указаны связанные с ними запросы, которые могут отображаться в отчетах об использовании, о квоте и/или о платежах.
Статус ответа | Класс кода ответа (2xx, 4xx, 5xx) |
Отчет об использовании | Отчет о квоте | Отчет о платежах |
---|---|---|---|---|
OK | 2xx | Да | Да | Да |
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 | Да | Да | Нет |