Как встроить Яндекс.Карты с объектами недвижимости на сайт
Интерактивная карта помогает выбрать квартиру, дом или комнату, оценив район и соседние объекты. Встроить карту Яндекс.Карт с объектами недвижимости на сайт можно через 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 и на разных устройствах.