Фраза «карта грузится долго» объединяет несколько разных задержек. Иногда браузер пять секунд ждёт сторонний SDK, иногда карта появляется быстро, но затем зависает на двух тысячах маркеров, а иногда основной поток уже занят другим виджетом. Ускорение начинается не со смены провайдера, а с четырёх отметок времени на одной и той же странице.
Проверяйте холодную загрузку без расширений и с ограничением сети и процессора, а затем обычную повторную. Если проблема проявляется только на первом входе, смотрите размер и очередь запросов. Если интерфейс тормозит после появления подложки, исследуйте количество DOM-объектов, обработчики и преобразование данных.
Размечаем путь до полезной карты
| Этап | Начало и конец | Что подозревать при задержке |
|---|---|---|
| SDK | запрос скрипта → API доступен | DNS, TLS, блокировка, лишние библиотеки |
| контейнер | API доступен → карта создана | синхронный код и повторная инициализация |
| данные | fetch объектов → JSON разобран | тяжёлый ответ, нет фильтра по области |
| маркеры | данные готовы → видимые точки готовы | тысячи элементов без кластеризации |
| взаимодействие | жест пользователя → обновлён экран | дорогие listeners и перерисовки |
В DevTools сохраните waterfall и Performance trace. Метка load страницы сама по себе не подходит: карта может быть ниже первого экрана и не нужна пользователю сразу. Дополните технические цифры пользовательским событием — моментом, когда видимая область стала интерактивной и первый клик по маркеру обработался.
Карту ниже первого экрана не обязательно загружать в head
const host = document.querySelector('#map');
const observer = new IntersectionObserver(async ([entry]) => {
if (!entry.isIntersecting) return;
observer.disconnect();
const { Map } = await google.maps.importLibrary('maps');
startMap(new Map(host, mapOptions));
}, { rootMargin: '300px' });
observer.observe(host);IntersectionObserver позволяет начать работу незадолго до появления блока в viewport без постоянного опроса scroll. Оставьте у контейнера заданную высоту, чтобы страница не прыгала. Для важной карты в первом экране отсрочка не нужна — там полезнее ранняя загрузка с async и отказ от необязательных библиотек.
Документация Google Maps JavaScript API рекомендует асинхронную загрузку и поддерживает importLibrary для получения библиотек по требованию. Прямой script с длинным списком libraries загружает всё сразу. Проверьте, действительно ли стартовой карте нужны places, geometry, drawing и visualization, а также не вставлен ли загрузчик дважды разными компонентами.
Сотни точек превращаются в несколько кластеров
Не создавайте маркер для каждого объекта страны, когда пользователь видит один город. Сервер может принять bbox и zoom, вернуть только нужные поля и ограничить число объектов. На клиенте близкие точки объединяются в кластеры. Официальный пример Google показывает MarkerClusterer именно для управления множеством маркеров.
- передавайте координаты, ID и короткую подпись, а детали запрашивайте при открытии карточки;
- округляйте и дедуплицируйте одинаковые координаты до создания маркеров;
- не перерисовывайте все точки на каждое событие bounds_changed;
- используйте debounce для серверного запроса после остановки перемещения;
- отменяйте устаревший fetch, чтобы поздний ответ не заменил новую область;
- профилируйте собственный HTML маркера: сложная тень и изображение тоже имеют цену.
Кешируем данные, а не чужую логику
Статические координаты точек можно отдавать с ETag или версией набора, но условия использования картографического провайдера для тайлов и геоданных нужно соблюдать отдельно. Не пытайтесь ускорить страницу самодельным долговременным кешированием чужих ответов без проверки лицензии. Лучше уменьшите собственный JSON и обновляйте только изменившиеся объекты.
Если карта открывается в модальном окне или вкладке с display:none, инициализируйте её после того, как контейнер получил размеры, либо вызовите предусмотренное API обновление области. Нулевая ширина на старте часто выглядит как долгая загрузка или серое поле, хотя сеть уже закончила работу.
Контрольная серия не ограничивается быстрым ноутбуком
- Снять базовые цифры на desktop и мобильном профиле с холодным кешем.
- Убрать повторную загрузку SDK и необязательные библиотеки.
- Перенести инициализацию к моменту реальной видимости блока.
- Включить выборку по области и кластеризацию маркеров.
- Повторить trace с тем же набором данных и проверить первый клик.
- Добавить мониторинг ошибок SDK и размера ответа объектов.
Для предметного разбора достаточно URL страницы, waterfall, Performance trace, количества точек в ответе и кода инициализации без API-ключа. Итогом должен стать не субъективный вывод «стало быстрее», а таблица времени SDK, данных и маркеров до и после на одинаковом профиле.