Custom Maps

ver.2.1.0
от 10.02.2026

Описание

Руководство по API

В head страницы подключить api <script src="https://api-maps.yandex.ru/2.1/?&lang=ru_RU" type="text/javascript"></script>

Основные возможности

  1. Возможность использования одной или нескольких меток
    Позволяет пользователю добавлять на карту одну или несколько меток. Это удобно для обозначения различных точек интереса, таких как достопримечательности, магазины, офисы и т.д.
  2. Подстройка масштаба карты под одну или все метки
    Автоматически настраивает масштаб карты так, чтобы все добавленные метки были видны на экране. Это помогает пользователю сразу увидеть все важные точки без необходимости ручной настройки масштаба.
  3. Выбор, какие элементы на карте отображать
    Позволяет пользователю выбирать, какие элементы карты будут отображаться. Например, можно включить или выключить отображение дорог, зданий, рек, границ и других объектов.
  4. Кластеризация объектов
    Объединяет объекты у которых имеются одни и те же координаты.
  5. Отображение данных метки через попап или балун.
    При использовании попапа необходимо наличие скрипта CustomPopup
  6. Можно задавать координаты для одной или нескольких меток, а также их подсказки
    Дает возможность пользователю задавать точные координаты для меток и добавлять всплывающие подсказки с дополнительной информацией, которая будет отображаться при наведении или клике на метку.
  7. Содержимое всплывающей подсказки
    Определяет, какая информация будет отображаться во всплывающей подсказке при взаимодействии с меткой. Это может быть текст, изображения, ссылки и другая полезная информация.
  8. Путь до иконки маркера
    Позволяет задавать пользовательские иконки для меток, указывая путь к изображению. Это позволяет использовать уникальные иконки, которые лучше соответствуют тематике метки.
  9. Размер маркера
    Позволяет настраивать размер меток на карте. Это полезно для выделения более важных меток или для улучшения визуального восприятия карты.
  10. Смещение маркера
    Дает возможность задавать смещение метки относительно её координат. Это может быть полезно для точного позиционирования метки на карте, особенно если стандартное положение перекрывает важные детали.

Codes

HTML
JS
По умолчанию
от 10.02.2026
Код
      <div class="map">
    <div id="map" class="map__map"></div>
</div>
    
С попапом
от 10.02.2026
Код
      <div class="map">
    <div class="map__popup">
        <div class="popup popup-objects-on-map">
            <div class="popup__inner">
                <div class="popup__content">
                    <div class="popup__close"><span></span></div>
                    <div class="popup__content-inner">
                        ... your code ...
                    </div>
                </div>
            </div>
        </div>
    </div>
    <div id="map" class="map__map"></div>
</div>
    

Параметры

selector
ID элемента куда будет вставляться карта.
Тип:
string
Значение по умолчанию:
"map"
zoom
Масштаб карты.
Тип:
number
Значение по умолчанию:
16
controls
Какие элементы будут видны на карте.
Тип:
array
Значение по умолчанию:
["zoomControl", "fullscreenControl"]

Доступные параметры:

[]       	        Запретить все
default 	        Все элементы
geolocationControl 	Геолокации
searchControl 	   	Поисковая строка
routeEditor 	    	Редактора маршрута
zoomControl 	    	Ползунок масштаба
fullscreenControl 	Полноэкранный режима
trafficControl 	    	Пробки
typeSelector 	    	Тип карты
rulerControl 	    	Измерение расстояний
clusters
Включение или отключение кластеризации объектов.
Тип:
boolean
Значение по умолчанию:
false
coords
Коррдинаты метки, когда только одна метка.
Тип:
array
Значение параметра является массив вида: [55.050432, 60.109599]
coordsList
Список объектов, когда несколько меток.
Тип:
array
[
{
coords: [55.050432, 60.109599],
balloonContentHeader: 'Миасс',
balloonContent: 'Город в золотой долине',
}
]
или
[
{
coords: [55.050432, 60.109599],
popupName: 'Миасс',
popupDescription: 'Город в золотой долине',
popupPhones: {
label: 'Телефоны:',
value: ['+79511111111', '+79512222222']
},
popupEmails: {
label: 'Почтовый ящик:',
value: ['example@mail.ru', 'example@mail.ru']
}
}
]
balloonContentHeader
Заголовок всплывающей подсказки.
Тип:
string
balloonContent
Содержимое всплывающей подсказки.
Тип:
string
popup
Отображение попап окна.
Тип:
boolean
Значение по умолчанию:
false
popupName
Заголовок объекта в попапе.
Тип:
string
popupDescription
Описание объекта в попапе.
Тип:
string
popupPhones
Список телефонов.
Тип:
array
{
label: 'Телефоны:',
value: ['+79511111111', '+79512222222']
}
popupEmails
Список почтовых ящиков.
Тип:
array
{
label: 'Почтовый ящик:',
value: ['example@mail.ru', 'example@mail.ru']
}
iconImageHref
Путь до иконки маркера.
Тип:
string
Значение по умолчанию:
data:image/svg+xml;base64,PHN2ZyB2ZX...
Можно указывать как путь к файлу (.png|.svg) так и base64.
iconImageSize
Размер маркера.
Тип:
array
Значение по умолчанию:
[32, 32]
iconImageOffset
Смещение маркера.
Тип:
array
Значение по умолчанию:
[-14, -32]

Changelogs

v2.1.0
latest
от 10 февраля 2026
  • feat: Отображение данных метки через попап или балун.
  • feat: Кластеризация объектов
v2.0.1
от 13 января 2026
  • fix: исправление ползунка масштаба при выводе нескольких меток на карте
v2.0.0
от 29 Февраля 2025
  • Возможность использования одной или нескольких меток
  • Выбор, какие элементы на карте отображать
  • Можно задавать координаты для одной или нескольких меток, а также их подсказки
  • Содержимое всплывающей подсказки
  • Путь до иконки маркера
  • Размер маркера
  • Смещение маркера
v1.0.0
  • init