Гайды

Как добавить карту на сайт — 12 строк, без API-ключа и без Google

Иллюстрация: развёрнутая карта на столе с одной булавкой

Почти все думают, что карта на сайте — это Google Maps, а значит аккаунт, API-ключ и привязанная карта оплаты. Так вот: не значит. Есть связка, которой всё это не нужно вообще — библиотека Leaflet плюс тайлы OpenStreetMap. Двенадцать строк, никакой регистрации, работает в обычном HTML-файле. Сейчас сделаем.

Что мы соберём

Кусок страницы с настоящей интерактивной картой: её можно двигать, зумить, на ней стоит маркер с подписью. Всё, что нужно, — текстовый редактор и браузер. Никакого сервера и сборки.

Работает это так: Leaflet — маленькая библиотека, которая рисует карту и обрабатывает перетаскивание. OpenStreetMap — открытая карта мира, откуда приходят картинки-квадратики (их называют тайлами). Leaflet бесплатен по лицензии MIT, тайлы OSM — открытые данные.

1. Подключи Leaflet

В head страницы добавь стили и скрипт. Обрати внимание на номер версии — он тут не для красоты, вернёмся к этому в граблях.

<link rel="stylesheet" href="https://unpkg.com/[email protected]/dist/leaflet.css" />
<script src="https://unpkg.com/[email protected]/dist/leaflet.js"></script>

Это CDN — файлы приедут с чужого быстрого сервера, скачивать ничего не надо.

2. Сделай контейнер и задай ему высоту

В теле страницы — пустой блок, куда ляжет карта:

<div id="map"></div>

И обязательно высота в CSS:

#map { height: 400px; }

Это шаг, на котором спотыкаются девять человек из десяти. Без высоты блок схлопнется в ноль пикселей, карта отрисуется — и ты увидишь пустое место. Никакой ошибки в консоли при этом не будет.

3. Создай карту и выбери центр

Дальше JavaScript. Две цифры в квадратных скобках — широта и долгота центра, третья — начальный зум (чем больше, тем ближе; 12 — примерно город целиком):

const map = L.map('map').setView([55.7558, 37.6173], 12);

Свои координаты берутся за десять секунд: открой openstreetmap.org, кликни правой кнопкой по нужной точке и выбери «показать адрес» — числа будут в адресной строке.

4. Подложи тайлы и подпись

Сама по себе карта пустая — это только «холст». Картинки местности приходят отдельным слоем:

L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
  maxZoom: 19,
  attribution: '&copy; OpenStreetMap contributors'
}).addTo(map);

Подпись attribution — не опция, а условие использования: карту делают волонтёры, и ссылка на них обязательна. Сгенерированный ИИ код её частенько теряет — верни на место.

5. Поставь маркер

L.marker([55.7558, 37.6173])
  .addTo(map)
  .bindPopup('Мы здесь')
  .openPopup();

Всё. Открывай файл в браузере — карта двигается, маркер на месте, по клику всплывает подпись.

Что получится и три грабли

Готовый файл целиком:

<link rel="stylesheet" href="https://unpkg.com/[email protected]/dist/leaflet.css" />
<script src="https://unpkg.com/[email protected]/dist/leaflet.js"></script>
<style>#map { height: 400px; }</style>

<div id="map"></div>

<script>
  const map = L.map('map').setView([55.7558, 37.6173], 12);
  L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
    maxZoom: 19,
    attribution: '&copy; OpenStreetMap contributors'
  }).addTo(map);
  L.marker([55.7558, 37.6173]).addTo(map).bindPopup('Мы здесь').openPopup();
</script>

Теперь про то, что сломается:

  • Порядок координат. Leaflet ждёт широту, потом долготу. А формат GeoJSON и часть картографических сервисов — наоборот, долготу первой. Перепутал — маркер уезжает в океан. Если точка оказалась не там, первым делом поменяй числа местами.
  • Карта в скрытом блоке. Если контейнер сначала спрятан (вкладка, модалка, аккордеон), карта отрисуется по нулевому размеру и останется серой полосой. Лечится вызовом map.invalidateSize() после того, как блок показали.
  • Версия без номера. Ссылка вида unpkg.com/leaflet без @1.9.4 однажды отдаст следующий мажор с другим синтаксисом, и код молча перестанет работать. Пиши версию явно. На момент публикации стабильная — 1.9.4.

Дальше карту можно ставить на лендинг в блок «как нас найти», а маркеры расставлять циклом из массива точек.

Как поставить несколько маркеров сразу

Почти всегда точка не одна: филиалы, точки выдачи, места на карте города. Держи список отдельно от кода отрисовки и пройди по нему циклом — добавлять новую точку станет делом одной строки:

const points = [
  { coords: [55.7558, 37.6173], title: 'Главный офис' },
  { coords: [55.7601, 37.6186], title: 'Точка выдачи' },
];

points.forEach((p) => {
  L.marker(p.coords).addTo(map).bindPopup(p.title);
});

Если точек много и они разбросаны, полезен ещё один приём: вместо жёсткого центра попроси карту саму подобрать масштаб так, чтобы влезли все — map.fitBounds(points.map((p) => p.coords)).

Это правда бесплатно?

Библиотека — да, полностью. Тайлы OpenStreetMap для сайта-визитки или пет-проекта — тоже, но у их серверов есть правила использования: они не рассчитаны на серьёзный трафик и запрещают массовую выкачку. Если проект вырастет, тайлы берут у отдельного провайдера — код при этом меняется на одну строку, ту самую с адресом.

Чем это отличается от Google Maps?

Функциями внутри — многим (пробки, панорамы, свои маршруты). Порогом входа — почти всем: Google требует аккаунт, ключ и платёжные данные с самого начала, а лимиты считаются по каждому показу карты. Для «покажи, где мы находимся» это стрельба из пушки по воробьям.

А если у меня есть адрес, а не координаты?

Нужен геокодинг — превращение адреса в пару чисел. У OpenStreetMap для этого есть бесплатный сервис Nominatim со строгим ограничением по частоте запросов. Для одной статичной точки проще один раз посмотреть координаты руками и вписать их в код.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →