Google Maps JavaScript API относится к набору облачных сервисов платформы Google Maps Platform и использует модель оплаты по фактическому потреблению. Каждый запрос к картографическим сервисам учитывается в статистике проекта Google Cloud и влияет на расход квоты.
Система квот выполняет несколько задач:
Понимание механизма тарификации особенно важно при разработке коммерческих веб-приложений, поскольку ошибки в архитектуре способны привести к значительному росту расходов.
Для работы Google Maps JavaScript API требуется:
После активации биллинга все обращения к сервисам начинают учитываться в рамках конкретного проекта.
С точки зрения тарификации Google Maps JavaScript API является лишь одной из множества служб платформы Google Maps Platform. Стоимость приложения зависит не только от отображения карты, но и от использования связанных сервисов:
Каждый сервис имеет собственную модель учета запросов.
В основе тарификации Google Maps Platform лежит понятие SKU (Stock Keeping Unit).
SKU представляет собой отдельную платную операцию или группу операций.
Например:
| Действие | Возможный SKU |
|---|---|
| Загрузка интерактивной карты | Dynamic Maps |
| Поиск места | Places Search |
| Автодополнение адреса | Autocomplete |
| Геокодирование адреса | Geocoding |
| Построение маршрута | Directions |
Стоимость определяется не самим фактом использования API, а количеством операций конкретного SKU.
При работе с Google Maps JavaScript API тарифицируются не все действия одинаково.
Наиболее распространённый сценарий — отображение интерактивной карты.
const map = new google.maps.Map(
document.getElementById("map"),
{
center: { lat: 51.1605, lng: 71.4704 },
zoom: 10
}
);Каждая загрузка карты может учитываться как отдельная операция Dynamic Maps.
Под загрузкой понимается создание экземпляра карты на странице.
Если пользователь обновил страницу:
F5 → новая загрузка картыЕсли открыта новая вкладка:
Новая вкладка → новая загрузка картыЕсли карта создаётся повторно после уничтожения объекта:
destroy() → create() → новая операцияИспользование панорам также может тарифицироваться отдельно.
const panorama =
new google.maps.StreetViewPanorama(
document.getElementById("street-view"),
{
position: {
lat: 40.6892,
lng: -74.0445
}
}
);Каждая загрузка панорамы учитывается по собственному SKU.
Google периодически обновляет ценовую модель.
Исторически платформа предоставляла ежемесячный кредит для покрытия небольших проектов. Размер такого кредита и условия его предоставления могут изменяться, поэтому актуальные значения необходимо проверять в документации Google Maps Platform.
Даже если проект находится в пределах бесплатного объёма использования, подключение биллинга обычно остаётся обязательным.
Типичный жизненный цикл выглядит следующим образом:
Запрос
↓
Учёт использования
↓
Применение бесплатного кредита
↓
Расчёт итоговой стоимостиЕсли расходы не превышают размер доступного кредита, фактическое списание средств может не происходить.
Квота — это ограничение на объём использования сервиса.
Существует несколько типов квот.
Ограничивают количество запросов за сутки.
Пример:
100 000 запросов в деньПосле исчерпания лимита сервис может начать возвращать ошибки.
Ограничивают количество обращений за единицу времени.
Пример:
3000 запросов в минутуили
50 запросов в секундуПодобные ограничения защищают инфраструктуру от всплесков нагрузки.
Администратор проекта может самостоятельно установить ограничения ниже максимальных значений Google.
Например:
Google разрешает:
100 000 запросов
Проект ограничен:
20 000 запросовТакой подход помогает контролировать бюджет.
Квоты настраиваются через консоль Google Cloud.
Для каждого API отображаются:
Особенно важно отслеживать:
Именно эти сервисы чаще всего становятся источником неожиданных расходов.
Google предоставляет подробную статистику использования сервисов.
Отслеживаются:
Пример сценария анализа:
Понедельник:
15 000 запросов
Вторник:
18 000 запросов
Среда:
120 000 запросовРезкий скачок в среду может указывать на:
Для предотвращения непредвиденных затрат рекомендуется настраивать бюджет.
Бюджет позволяет получать уведомления при достижении заданного порога.
Например:
Бюджет: 100 USD
Уведомления:
50%
75%
90%
100%После достижения порога отправляются сообщения администраторам проекта.
Неправильно настроенный API-ключ способен привести к огромному количеству несанкционированных запросов.
Рекомендуется ограничивать ключ:
example.com
*.example.comПример:
https://example.com/*Тогда использование ключа на стороннем сайте станет невозможным.
Разрешается использовать только необходимые сервисы.
Например:
Maps JavaScript APIЕсли приложению не нужен Geocoding API, доступ к нему лучше запретить.
Существует несколько распространённых ошибок.
Плохо:
setInterval(() => {
new google.maps.Map(
document.getElementById("map"),
options
);
}, 1000);Каждую секунду создаётся новая карта.
За сутки количество операций станет огромным.
Плохо:
input.addEventListener("keyup", () => {
geocoder.geocode(...);
});Каждое нажатие клавиши отправляет запрос.
При наборе адреса из 30 символов выполняется 30 обращений.
Лучше использовать задержку (debounce).
Автодополнение адресов является отдельным сервисом тарификации.
Неэффективный вариант:
autocomplete.search();
autocomplete.search();
autocomplete.search();выполняется многократно для одного и того же ввода.
Плохо:
geocoder.geocode({
address: "Moscow"
});Запрос выполняется снова и снова.
Лучше хранить уже полученные результаты:
cache["Moscow"] = result;Необязательно загружать карту сразу после открытия страницы.
Плохой вариант:
window.onl oad = initMap;Лучший подход:
button.addEventListener(
"click",
initMap
);Карта загружается только при необходимости.
Плохо:
new google.maps.Map(...);
new google.maps.Map(...);
new google.maps.Map(...);Лучше:
const map =
new google.maps.Map(...);Далее переиспользуется существующий объект.
Если адреса редко меняются, результаты геокодирования можно хранить в базе данных.
Схема:
Адрес
↓
Проверка локального кеша
↓
Нет данных?
↓
Google Geocoding API
↓
Сохранение результатаЭто значительно уменьшает количество запросов.
При большом количестве объектов возникает соблазн постоянно обновлять данные.
Например:
10000 markersИспользование кластеризации позволяет уменьшить нагрузку на клиентскую часть и сократить количество дополнительных операций.
new MarkerClusterer({
markers,
map
});Одна из наиболее распространённых ошибок.
Пример:
status === "OVER_QUERY_LIMIT"Причины:
Обработка:
if (status === "OVER_QUERY_LIMIT") {
console.log("Лимит превышен");
}Пример:
status === "REQUEST_DENIED"Причины:
Означает проблему с API-ключом.
Типичные причины:
При проектировании системы полезно заранее рассчитывать предполагаемую нагрузку.
Пример:
20 000 пользователей в деньКаждый пользователь:
1 загрузка карты
3 геокодирования
1 построение маршрутаИтого:
20 000 Dynamic Maps
60 000 Geocoding
20 000 DirectionsПосле определения количества операций по каждому SKU можно оценить ежемесячные расходы и сравнить их с действующими тарифами Google Maps Platform.
Для коммерческих приложений обычно применяется комплексный подход:
Такая архитектура позволяет сохранять предсказуемость затрат даже при значительном росте аудитории и интенсивном использовании Google Maps JavaScript API.