Как добавить карту на сайт — 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: '© 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: '© 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 коротких урока на телефоне.





