Как встроить Яндекс.Карты с объектами недвижимости на сайт

Интерактивная карта помогает выбрать квартиру, дом или комнату, оценив район и соседние объекты. Встроить карту Яндекс.Карт с объектами недвижимости на сайт можно через JavaScript API: метки показывают цену и адрес, а карточка ведёт к полному объявлению.

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

Подготовка каталога объектов

Начните с единого каталога: выгрузите данные из CMS или подготовьте JSON. Для каждого объекта нужны идентификатор, название, координаты, цена, площадь, число комнат, адрес и ссылка на объявление. Координаты задавайте в порядке широты и долготы, например [55.75, 37.61].

Для контекста о рынке и проверки формулировок полезен архив новостей недвижимости. Перед публикацией удаляйте закрытые позиции и не оставляйте в каталоге объявления о недвижимости, которая больше не сдаётся.

Подключение API и создание карты

Получите ключ в кабинете разработчика Яндекса и ограничьте его доменом сайта. Подключение выполняется скриптом, а создание карты — после события готовности API. Секретные серверные ключи в этот код не помещайте.

<div id="property-map" style="width: 100%; height: 520px;"></div>
<script src="https://api-maps.yandex.ru/2.1/?apikey=ВАШ_КЛЮЧ&lang=ru_RU" type="text/javascript"></script>

Затем передайте карте координаты центра и масштаб. Значение center показывает общий район, а не обязательно один из объектов.

var map;

ymaps.ready(function () {
  map = new ymaps.Map("property-map", {
    center: [55.751244, 37.618423],
    zoom: 11
  });
});

Для нескольких городов используйте отдельные карты или пересчитывайте центр по выбранным меткам. Случайный центр может скрыть часть объявлений.

Добавление меток и карточек объектов

В тот же файл добавьте загрузку данных. Каждую позицию выводите как отдельную метку ymaps.Placemark: название используйте в iconCaption, а цену, площадь и ссылку разместите во всплывающей карточке.

var markers = [];

ymaps.ready(function () {
  fetch("/api/properties")
    .then(function (response) {
      if (!response.ok) {
        throw new Error("Не удалось загрузить объекты");
      }
      return response.json();
    })
    .then(function (items) {
      items.forEach(function (item) {
        var card = document.createElement("div");
        var link = document.createElement("a");
        var area = document.createElement("p");

        link.href = item.url;
        link.textContent = item.title + " — " + item.price + " ₽/мес";
        area.textContent = "Площадь: " + item.area + " м²";
        card.appendChild(link);
        card.appendChild(area);

        var marker = new ymaps.Placemark(item.coordinates, {
          iconCaption: item.title,
          balloonContent: card
        });

        markers.push(marker);
        map.geoObjects.add(marker);
      });
    })
    .catch(function (error) {
      console.error(error);
    });
});

Данные удобно получать из API CMS или готового файла. Формируйте текст через textContent, а не через необработанный HTML: это снижает риск внедрения постороннего кода из объявления.

Фильтры и синхронизация со списком

Добавьте HTML-форму с полями «Тип», «Цена», «Комнаты» и «Район». После изменения любого поля вызывайте единую функцию фильтрации, которая обновляет карту и текстовый список. Используйте одинаковые идентификаторы объектов, чтобы исключить дубли и рассинхронизацию.

Сохраняйте ссылки на метки в массиве markers и удаляйте только те, которые не соответствуют условиям, через removeFrom. Для ограничения области используйте map.setBounds по координатам видимых объектов; если метка одна, задайте центр и масштаб вручную.

Если сервер отдаёт много объявлений, загружайте сначала ближайшие к центру и добавляйте остальные по мере движения карты. Это сокращает время первого отклика на мобильном интернете.

Мобильная версия и доступность

На узких экранах задайте контейнеру высоту около 400–500 пикселей. Не блокируйте прокрутку страницы: на сенсорных устройствах отключите масштабирование прокруткой через disableScrollZoom: true, сохранив жесты двумя пальцами.

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

Проверка, отладка и защита данных

Если карта не загружается, откройте консоль браузера и проверьте ключ, ограничения домена, ответ API и разрешённые источники скриптов в политике безопасности содержимого. Убедитесь, что разрешён api-maps.yandex.ru. Пользователю показывайте понятное сообщение об ошибке, не раскрывая внутренние детали сервера.

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

Не публикуйте на карте имя владельца, личный телефон или другие персональные данные без законного основания и согласия. Показывайте общий адрес и характеристики объекта, а контакты передавайте через защищённую форму. После внедрения проверьте сценарии на медленной сети, с отключённым JavaScript и на разных устройствах.