Веб-справочник · № 16
Как вставить Яндекс Карту на сайт
Карта на странице контактов помогает клиенту найти офис или магазин. Разбираем три способа добавить Яндекс Карту — от готового кода конструктора до API — и как сделать так, чтобы она не тормозила сайт.
- Раздел
- Веб-справочник
- Обновлено
- Чтение
- ≈ 4 мин
Карта на сайте отвечает на вопрос «где вы находитесь» быстрее любого текста. Особенно она полезна для офлайн-бизнеса: салона, мастерской, магазина, клиники. Для онлайн-сервисов без офиса карта не нужна совсем.
Способ 1. Конструктор карт
Самый простой путь — конструктор карт Яндекса. В нём можно поставить метку, нарисовать маршрут или зону доставки, подписать точки и получить готовый код.
Порядок действий:
- Откройте конструктор карт Яндекса и войдите в аккаунт Яндекса.
- Найдите адрес и поставьте метку, добавьте подпись и описание.
- Если нужно, нарисуйте линию проезда или многоугольник зоны доставки.
- Нажмите «Сохранить и продолжить», выберите размер и тип кода: интерактивная карта, статическая или печатная.
- Скопируйте код и вставьте в страницу.
Конструктор отдаёт либо <script>, либо <iframe>. Интерактивную карту через скрипт удобно настраивать, но iframe проще сделать адаптивным и ленивым.
Способ 2. Виджет через iframe
Для одной точки на странице контактов подойдёт встраивание через iframe. Ссылку на карту с нужной меткой можно получить в конструкторе или в Яндекс Картах через «Поделиться».
<div class="map">
<iframe
src="https://yandex.ru/map-widget/v1/?um=constructor%3AВАШ_ИДЕНТИФИКАТОР&source=constructor"
title="Схема проезда к офису"
loading="lazy"
allowfullscreen>
</iframe>
</div>
.map {
aspect-ratio: 16 / 9;
border-radius: 8px;
overflow: hidden;
}
.map iframe {
width: 100%;
height: 100%;
border: 0;
}
@media (max-width: 600px) {
.map { aspect-ratio: 4 / 5; }
}
Свойство aspect-ratio держит пропорции карты на любом экране, а loading="lazy" откладывает загрузку iframe до тех пор, пока он не приблизится к видимой области. На телефонах карта выше — так её удобнее рассматривать.
Не забудьте атрибут title: программа экранного доступа прочитает его, чтобы объяснить, что внутри фрейма.
Способ 3. JavaScript API
API нужен, если карта — часть функциональности: несколько филиалов с фильтром, расчёт доставки, свои метки из базы. Для этого получите ключ в кабинете разработчика Яндекса и укажите в настройках ключа домен сайта, чтобы его не могли использовать чужие страницы.
У API есть бесплатный режим с ограничениями по числу запросов и условиям использования, а для коммерческих сценариев — платные тарифы. Актуальные условия проверьте в кабинете разработчика перед запуском.
Пример с актуальной третьей версией API:
<div id="map" style="height: 400px"></div>
<script src="https://api-maps.yandex.ru/v3/?apikey=ВАШ_КЛЮЧ&lang=ru_RU"></script>
<script>
async function initMap() {
await ymaps3.ready;
const { YMap, YMapDefaultSchemeLayer, YMapDefaultFeaturesLayer, YMapMarker } = ymaps3;
const map = new YMap(document.getElementById('map'), {
location: { center: [37.617635, 55.755814], zoom: 15 }
});
map.addChild(new YMapDefaultSchemeLayer());
map.addChild(new YMapDefaultFeaturesLayer());
const pin = document.createElement('div');
pin.className = 'pin';
pin.textContent = 'Мы здесь';
map.addChild(new YMapMarker({ coordinates: [37.617635, 55.755814] }, pin));
}
initMap();
</script>
Обратите внимание: в третьей версии координаты указываются в порядке «долгота, широта». Это частая причина того, что метка оказывается в океане.
Ленивая загрузка по клику
Даже с loading="lazy" карта загружается, как только человек к ней прокрутил. Если важна каждая доля секунды — например, на мобильной странице контактов, — можно показывать картинку-заглушку и подгружать карту по нажатию.
<button class="map-facade" data-src="https://yandex.ru/map-widget/v1/?um=constructor%3AВАШ_ИДЕНТИФИКАТОР">
<img src="/img/map-preview.webp" alt="Схема проезда: офис у метро" width="800" height="450">
<span>Показать интерактивную карту</span>
</button>
document.querySelectorAll('.map-facade').forEach((btn) => {
btn.addEventListener('click', () => {
const frame = document.createElement('iframe');
frame.src = btn.dataset.src;
frame.title = 'Схема проезда к офису';
frame.allowFullscreen = true;
btn.replaceWith(frame);
}, { once: true });
});
Альтернатива: статичная картинка со ссылкой
Часто интерактивная карта на сайте не нужна вовсе. Человек всё равно откроет навигатор в телефоне. Поэтому достаточно:
- картинки со схемой проезда (снимок карты или нарисованная схема с ориентирами);
- ссылки «Открыть в Яндекс Картах», ведущей на организацию или точку;
- текстового описания: адрес, вход, этаж, парковка, ближайшая остановка.
Такой блок весит десятки килобайт и работает мгновенно. Конструктор карт тоже умеет отдавать статичную карту-картинку.
Карта в WordPress
В редакторе блоков добавьте блок «Произвольный HTML» и вставьте код из конструктора или iframe из примера выше. Для страницы контактов этого достаточно. Плагины нужны, когда точек много и ими нужно управлять из админки.
Что ещё проверить
- Адрес на карте совпадает с адресом в тексте страницы и в карточке организации в Яндекс Бизнесе.
- Карта не перехватывает прокрутку страницы на телефоне — если перехватывает, используйте заглушку по клику.
- Рядом с картой есть адрес текстом: поисковики и люди читают его, а не карту.
Карта обычно соседствует с другими контактными элементами — полосой с телефоном и формой заявки. Что ещё должно быть на странице контактов небольшого сайта, разобрано в статье про сайт-визитку.
Частые вопросы
Нужен ли API-ключ, чтобы вставить Яндекс Карту?
Для карты из конструктора и для виджета-iframe ключ не нужен. Ключ требуется, если вы подключаете JavaScript API Яндекс Карт, чтобы программно добавлять метки, маршруты и свои элементы.
Почему карта замедляет сайт?
Скрипт карты и плитки загружаются вместе со страницей, даже если человек до карты не долистал. Решение — загружать карту только при приближении к ней или по клику, а до этого показывать картинку.
Можно ли вставить карту в WordPress?
Да. Код из конструктора вставляется блоком «Произвольный HTML». Есть и плагины для Яндекс Карт, но для одной точки на странице контактов они обычно избыточны.