## Маркеры {toc} ### DG.Marker Маркер представляет собой маленькую картинку, которая связана с определенным местом на карте. DG.marker([54.98, 82.89]).addTo(map); #### Создание

Конструктор	Описание
`DG.Marker( <LatLng> latlng, <Marker options> options? )`	Создает объект маркера с переданными географическими координатами и необязательными опциями.

#### Опции

Опция	Тип	По умолчанию	Описание
`icon`	`Icon`	`*`	Иконка, используемая для отображения маркера. Смотрите документацию по иконкам, для информации о настройке внешнего вида маркеров. Новые маркеры по умолчанию принимают стиль `DG.Icon.Default()`.
`interactive`	`Boolean`	`true`	Если значение `false`, тогда обработчик клика по маркеру не вызывается. Маркер ведет себя как часть нижележащего слоя карты.
`draggable`	`Boolean`	`false`	Можно ли перетаскивать маркер или нет.
`keyboard`	`Boolean`	`true`	Можно ли переходить к маркеру по нажатию на кнопку `Tab` и имитировать клик при нажатиии `Enter`.
`title`	`String`	`''`	Текст подсказки при наведении курсора на маркер (по умолчанию не отображается).
`alt`	`String`	`''`	Текст для `alt` атрибута иконки (полезно для accessibility).
`zIndexOffset`	`Number`	`0`	По умолчанию, свойство z-index изображения маркера устанавливается автоматически, в зависимости от его географического положения (широты). Используйте эту опцию, если необходимо разместить маркер поверх (или под) другим элементом, указав большее, например `1000`, (или меньшее) значение.
`opacity`	`Number`	`1.0`	Прозрачность маркера.
`riseOnHover`	`Boolean`	`false`	Если значение `true`, тогда маркер отобразится поверх остальных при наведении на него мышью.
`riseOffset`	`Number`	`250`	Позволяет задать шаг z-index при использовании `riseOnHover`.
`pane`	`String`	`'markerPane'`	Панель карты, на которую будет добавлен маркер.

#### События

Событие	Данные	Описание
`click`	`MouseEvent`	Вызывается при клике (или тапу) по маркеру.
`dblclick`	`MouseEvent`	Вызывается при двойном клике (или двойному тапу) по маркеру.
`mousedown`	`MouseEvent`	Вызывается при нажатии кнопки мыши над маркером.
`mouseover`	`MouseEvent`	Вызывается при наведении курсора мыши на маркер.
`mouseout`	`MouseEvent`	Вызывается, когда курсор мыши покидает область маркера.
`contextmenu`	`MouseEvent`	Вызывается при нажатии правой кнопки мыши над маркером.
`move`	`Event`	Вызывается, когда маркер перемещается с помощью метода `setLatLng` или обычным перетаскиванием. Старые и новые координаты попадают в аргументы события как `oldLatLng` и `latlng`.

##### События перетаскивания

Событие	Данные	Описание
`dragstart`	`Event`	Вызывается, когда пользователь начинает перетаскивать маркер.
`movestart`	`Event`	Вызывается, когда маркер фактически начинает перемещаться во время перетаскивания.
`drag`	`Event`	Вызывается периодически, во время перетаскивания маркера.
`dragend`	`DragEndEvent`	Вызывается, когда пользователь прекращает перетаскивание маркера.
`moveend`	`Event`	Вызывается, когда маркер фактически прекращает перемещаться во время перетаскивания.

События, унаследованные от Layer

Событие	Данные	Описание
`add`	`Event`	Вызывается, когда слой (маркер) добавляется на карту
`remove`	`Event`	Вызывается, когда слой (маркер) удаляется с карты

События попапа, унаследованные от Layer

Событие	Данные	Описание
`popupopen`	`PopupEvent`	Вызывается, когда открывается попап, привязанный к данному слою (маркеру).
`popupclose`	`PopupEvent`	Вызывается, когда закрываетс попап, привязанный к данному слою (маркеру).

#### Методы

Метод	Возвращает	Описание
`getLatLng()`	`LatLng`	Возвращает текущую географическую позицию маркера.
`setLatLng( <LatLng> latlng)`	`this`	Устанавилвает позицию маркера по переданным географическим координатам.
`setZIndexOffset( <Number> offset)`	`this`	Изменяет смещение zIndex маркера.
`setIcon( <Icon> icon)`	`this`	Устанавливает иконку маркера
`setOpacity( <Number> opacity)`	`this`	Изменяет уровень прозрачности маркера.
`bindLabel(<String> content, <Label options> options?)`	`this`	Добавляет всплывающую подсказку для маркера или обновляет содержимое уже созданной.
`unbindLabel()`	`this`	Отвязывает всплывающую подсказку от маркера.
`showLabel()`	`this`	Показывает всплывающую подсказку (в случае использования опции `static`).
`hideLabel()`	`this`	Скрывает всплывающую подсказку (в случае использования опции `static`).

Методы попапа, унаследованные от Layer Методы, унаследованные от Layer Методы, унаследованные от Evented #### Обработчики взаимодействия Свойства маркера включают в себя обработчики взаимодействия, которые позволяют контролировать интерактивное поведение маркера, а также подключение и отключение определенных возможностей, таких как перетаскивание (см. методы Handler). Например: marker.dragging.disable();

Свойство	Тип	Описание
`dragging`	`Handler`	Обработчик перетаскивания маркера (мышью и тачем).

### DG.Icon Иконка, которую можно использовать при создании маркера. Например: var myIcon = DG.icon({ iconUrl: 'my-icon.png', iconRetinaUrl: 'my-icon@2x.png', iconSize: [38, 95], iconAnchor: [22, 94], popupAnchor: [-3, -76], shadowUrl: 'my-icon-shadow.png', shadowRetinaUrl: 'my-icon-shadow@2x.png', shadowSize: [68, 95], shadowAnchor: [22, 94] }); DG.marker([50.505, 30.57], {icon: myIcon}).addTo(map); #### Создание

Конструктор	Описание
`DG.icon( <Icon options> options)`	Создает объект иконки, на основании переданных опций.

#### Опции

Опция	Тип	По умолчанию	Описание
`iconUrl`	`String`	`null`	Обязательный URL к изображению иконки (абсолютный или относительный).
`iconRetinaUrl`	`String`	`null`	URL к изображению иконки для устройств с Retina экраном (абсолютный или относительный).
`iconSize`	`Point`	`null`	Размер изображения иконки в пикселях.
`iconAnchor`	`Point`	`null`	Координаты "ножки" иконки (относительно ее левого верхнего угла). Иконка будет установлена так, чтобы эта точка соответствовала географическому положению маркера. По умолчанию "ножка" располагается по центру иконки; дополнительно положение может быть настроено через отрицательные значения CSS-свойства margin.
`popupAnchor`	`Point`	`null`	Координаты точки, из которой будет открываться попап (относительно `iconAnchor`).
`shadowUrl`	`String`	`null`	URL к изображению тени иконки. Если не указан, тогда тени не будет.
`shadowRetinaUrl`	`String`	`null`	URL к изображению тени иконки для устройств с Retina экраном. Если не указан, тогда тени не будет.
`shadowSize`	`Point`	`null`	Размер изображения тени в пикселях.
`shadowAnchor`	`Point`	`null`	Координаты "ножки" тени (относительно ее левого верхнего угла). Значение по умолчанию такое же, как у `iconAnchor`.
`className`	`String`	`''`	Значение класса, которое будет присвоено изображениям иконки и тени. По умолчанию пустое.

Опции, унаследованные от Layer #### События События, унаследованные от Layer События попапа, унаследованные от Layer #### Методы

Метод	Возвращает	Описание
`createIcon(<HTMLElement> oldIcon?)`	`HTMLElement`	Вызывается внутри библиотеки, когда должна быть показана иконка, возвращает HTML-элемент `<img>` со стилями, соответсвующими переданным опциям.
`createShadow(<HTMLElement> oldIcon?)`	`HTMLElement`	Тоже что и `createIcon`, но с тенью за иконкой.

Методы попапа, унаследованные от Layer Методы, унаследованные от Layer Методы, унаследованные от Evented ### DG.DivIcon Иконка для маркеров, которые используют простой элемент <div> вместо изображения. Наследуется от Icon, но игнорирует опции теней и iconUrl. // вы можете установить стиль класса .my-div-icon в CSS var myIcon = DG.divIcon({className: 'my-div-icon'}); DG.marker([50.505, 30.57], {icon: myIcon}).addTo(map); #### Создание

Конструктор	Описание
`DG.DivIcon( <DivIcon options> options )`	Создает объект `DG.DivIcon`, на основании переданных опций.

#### Опции

Опция	Тип	По умолчанию	Описание
`html`	`String`	`''`	HTML код, который будет установлен как содержимое иконки. По умолчанию пустой.
`bgPos`	`Point`	`[0, 0]`	Опциональное относительное позиционирование фона в пикселях

Опции, унаследованные от Icon Опции, унаследованные от Layer #### События События, унаследованные от Layer События попапа, унаследованные от Layer #### Методы Методы, унаследованные от Icon Методы попапа, унаследованные от Layer Методы, унаследованные от Layer Методы, унаследованные от Evented