заказ/сайт Справочник заказчика сайта

Веб-справочник · № 16

Как вставить Яндекс Карту на сайт

Карта на странице контактов помогает клиенту найти офис или магазин. Разбираем три способа добавить Яндекс Карту — от готового кода конструктора до API — и как сделать так, чтобы она не тормозила сайт.

Раздел
Веб-справочник
Обновлено
Чтение
≈ 4 мин

Карта на сайте отвечает на вопрос «где вы находитесь» быстрее любого текста. Особенно она полезна для офлайн-бизнеса: салона, мастерской, магазина, клиники. Для онлайн-сервисов без офиса карта не нужна совсем.

Способ 1. Конструктор карт

Самый простой путь — конструктор карт Яндекса. В нём можно поставить метку, нарисовать маршрут или зону доставки, подписать точки и получить готовый код.

Порядок действий:

  1. Откройте конструктор карт Яндекса и войдите в аккаунт Яндекса.
  2. Найдите адрес и поставьте метку, добавьте подпись и описание.
  3. Если нужно, нарисуйте линию проезда или многоугольник зоны доставки.
  4. Нажмите «Сохранить и продолжить», выберите размер и тип кода: интерактивная карта, статическая или печатная.
  5. Скопируйте код и вставьте в страницу.

Конструктор отдаёт либо <script>, либо <iframe>. Интерактивную карту через скрипт удобно настраивать, но iframe проще сделать адаптивным и ленивым.

Способ 2. Виджет через iframe

Для одной точки на странице контактов подойдёт встраивание через iframe. Ссылку на карту с нужной меткой можно получить в конструкторе или в Яндекс Картах через «Поделиться».

<div class="map">
  <iframe
    src="https://yandex.ru/map-widget/v1/?um=constructor%3AВАШ_ИДЕНТИФИКАТОР&amp;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=ВАШ_КЛЮЧ&amp;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>

Обратите внимание: в третьей версии координаты указываются в порядке «долгота, широта». Это частая причина того, что метка оказывается в океане.

Короче говоря. Для одной точки хватит iframe из конструктора с ленивой загрузкой. API с ключом нужен только когда карта — часть функциональности сайта.

Ленивая загрузка по клику

Даже с 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». Есть и плагины для Яндекс Карт, но для одной точки на странице контактов они обычно избыточны.

Заявка

Нужен сайт? Оставьте заявку

Опишите задачу в двух-трёх предложениях: что за бизнес, какой сайт нужен и к какому сроку. Свяжемся, уточним детали и сориентируем по бюджету и срокам.