Тема
Map
new Map(container: HTMLElement | string, options: MapOptions)
Если вам не нужен полный контроль над созданием карты — обычно проще EvaMaps.create() — тонкая обёртка над Map + TileLayer с тайлами и темой по умолчанию.
Опции конструктора
| Опция | Тип | По умолчанию | Статус |
|---|---|---|---|
center | LngLatLike | — (обязательно) | ✅ |
zoom | number | — (обязательно) | ✅ |
minZoom, maxZoom | number | 0, 22 | ✅ |
zoomSnap | number | 1 | ✅ В покое зум кратен zoomSnap (0 — без привязки, дробный зум). Во время жеста (пальцы, трекпад) зум всегда дробный |
zoomControl | boolean | true | ✅ |
scaleControl | boolean | true | ✅ |
cooperative | boolean | false | ✅ Колесо мыши масштабирует карту только с Ctrl/⌘. Один палец листает страницу, два пальца двигают и масштабируют карту |
cooperativeHintText | string | «Для масштабирования используйте Ctrl + колесо» | ✅ Подсказка при колесе без Ctrl. Для одного пальца текст другой: «Двигайте карту двумя пальцами» |
maxBounds | LngLatBoundsLike | — | ✅ Прямоугольник, за который карту нельзя увести. Если экран больше области, она держится по центру. Через 180° задаётся как west > east (Чукотка). На лету — setMaxBounds(bounds) и setMaxBounds(null) |
fullscreenControl | boolean | false | ✅ Кнопка «на весь экран». См. «Контролы» |
geolocateControl | boolean | false | ✅ Кнопка «моё местоположение». См. «Контролы» |
keyboard | boolean | true | ✅ Стрелки и +/− двигают и зумят карту; фокус — по клику на карту или через Tab |
touchZoom | boolean | true | ✅ Масштаб двумя пальцами. В конце карта доезжает до целого зума. Можно выключить на лету — setTouchZoom(false) |
doubleClickZoom | boolean | true | ✅ Двойной клик или тап приближает на 1, одновременный тап двумя пальцами отдаляет. Можно выключить на лету — setDoubleClickZoom(false) |
Методы — вид карты
| Метод | Возвращает | Статус | |
|---|---|---|---|
getCenter() | LngLat | ✅ | |
getZoom() | number | ✅ | |
getBounds() | LngLatBounds | ✅ | Видимая область |
setView(center, zoom) | this | ✅ | Мгновенно, без анимации |
setZoom(zoom, { animate? }) | this | ✅ | |
zoomIn() / zoomOut() | this | ✅ | Плавно, на 1 уровень вокруг центра |
panTo(center, { animate? }) | this | ✅ | |
panBy(dx, dy) | this | ✅ | Сдвиг в пикселях экрана |
flyTo(center, zoom, { duration? }) | this | ✅ | Плавный перелёт; при системной настройке prefers-reduced-motion — мгновенно, без анимации |
fitBounds(bounds, { padding?, maxZoom? }) | this | ✅ | Корректно работает через 180° долготы (например, для Чукотки) |
setMaxBounds(bounds | null) | this | ✅ | Ограничить обзор или снять ограничение |
getMaxBounds() | LngLatBounds | null | ✅ | Копия. Правка возвращённого объекта карту не меняет |
project(lngLat) / unproject(point) | Point / LngLat | ✅ | Пиксели контейнера карты ↔ географические координаты. У антимеридиана (180°, Чукотка) project() берёт ближайшую к центру карты точку, а не противоположный край мира |
getContainer() | HTMLElement | ✅ | |
setDoubleClickZoom(enabled) / getDoubleClickZoom() | this / boolean | ✅ | Включает/выключает зум по двойному клику и тапу на лету |
setTouchZoom(enabled) / getTouchZoom() | this / boolean | ✅ | Включает/выключает масштаб двумя пальцами на лету |
destroy() | void | ✅ | Снимает всё: слушатели событий, DOM-узлы, таймеры, незавершённые загрузки тайлов |
Методы — слои и события
| Метод | Статус |
|---|---|
add(layer) / remove(layer) | ✅ |
on(type, fn) / off(type, fn) / once(type, fn) | ✅ |
Полный список слоёв — в разделе «Слои», список событий — в «События».
События карты
| Событие | Данные | Статус |
|---|---|---|
load | — | ✅ Первые тайлы видимой области загружены |
click, dblclick, contextmenu | { lngLat, point, originalEvent } | ✅ |
movestart, move, moveend | — | ✅ |
zoomstart, zoom, zoomend | — | ✅ |
resize | { width, height } | ✅ |
geolocate | { lngLat, accuracy } | ✅ Кнопка «моё местоположение». accuracy — метры, координаты [lng, lat] |
geolocateerror | { message } | ✅ Текст уже по-русски |
Пример
ts
import { Map, TileLayer, Marker, Popup } from '@evamaps/sdk';
const map = new Map('map', {
center: [37.6173, 55.7558],
zoom: 12,
cooperative: true,
});
map.add(
new TileLayer({ url: 'https://tiles.evamaps.ru/v1/light/{z}/{x}/{y}{r}.png' }),
);
new Marker([37.6173, 55.7558])
.setPopup(new Popup().setText('Наш офис'))
.addTo(map);
map.on('moveend', () => {
console.log(map.getCenter(), map.getZoom());
});
// при удалении страницы/компонента
map.destroy();