---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps.Placemark

Расширяет [YMaps.IInteractiveGeoObject](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md), [YMaps.IOverlay](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ioverlay.md).

Метка на карте.

**См.:** [Метка](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/tasks/how-to-add-placemark.md)
## Конструктор

Имя | Описание
----- | -----
[YMaps.Placemark](placemark.md#constructor)(coordPoint, options) | Создает метку в точке с заданными географическими координатами.


## Поля

Имя | Описание
----- | -----
[Events](placemark.md#Events) | Список обрабатываемых событий метки.

## Наследуемые поля

Из [YMaps.IGeoObject](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md): 
: [description](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#description), [id](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#id), [metaDataProperty](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#metaDataProperty), [name](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#name)

## События

Имя | Описание
----- | -----
[AddToMap](placemark.md#event-AddToMap) | Добавление метки на карту.
[BalloonClose](placemark.md#event-BalloonClose) | Закрытие балуна метки.
[BalloonOpen](placemark.md#event-BalloonOpen) | Открытие балуна метки.
[Click](placemark.md#event-Click) | Щелчок мыши по метке.
[DblClick](placemark.md#event-DblClick) | Двойной щелчок мыши по метке.
[Drag](placemark.md#event-Drag) | Продолжается перетаскивание метки.
[DragEnd](placemark.md#event-DragEnd) | Закончено перетаскивание метки.
[DragStart](placemark.md#event-DragStart) | Началось перетаскивание метки (если разрешено).
[MouseEnter](placemark.md#event-MouseEnter) | Курсор наведен на значок метки.
[MouseLeave](placemark.md#event-MouseLeave) | Курсор убран со значка метки.
[MouseMove](placemark.md#event-MouseMove) | Движение курсора мышкой в пределах значка метки.
[PositionChange](placemark.md#event-PositionChange) | Изменено местоположение метки (например, с помощью функции [YMaps.Placemark.setGeoPoint](placemark.md#setGeoPoint)).
[RemoveFromMap](placemark.md#event-RemoveFromMap) | Удаление метки с карты.

## Методы

Имя | Возвращает | Описание
----- | ----- | -----
[getContentLayout](placemark.md#getContentLayout)() | [YMaps.ILayout](ilayout.md) | Возвращает макет содержимого значка метки.
[getCoordPoint](placemark.md#getCoordPoint)() | [YMaps.ICoordPoint](icoordpoint.md) | Возвращает точку координатной системы, к которой привязана метка.
[getGeoPoint](placemark.md#getGeoPoint)() | [YMaps.ICoordPoint](icoordpoint.md) | То же, что и [YMaps.Placemark.getCoordPoint](placemark.md#getCoordPoint)
[getIconContent](placemark.md#getIconContent)() | String|HTMLElement|[YMaps.ILayout](ilayout.md) | Возвращает содержимое значка метки, установленное с помощью метода [YMaps.Placemark.setIconContent](placemark.md#setIconContent).
[getIconLayout](placemark.md#getIconLayout)() | [YMaps.IPlacemarkLayout](iplacemarklayout.md) | Возвращает макет значка метки.
[getIconShadowLayout](placemark.md#getIconShadowLayout)() | [YMaps.IPlacemarkLayout](iplacemarklayout.md) | Возвращает макет тени значка метки.
[getMap](placemark.md#getMap)() | [YMaps.Map](map.md) | Возвращает указатель на карту, в которую добавлена метка.
[getOptions](placemark.md#getOptions)() | [YMaps.PlacemarkOptions](placemarkoptions.md) | Возвращает опции метки.
[getParentContainer](placemark.md#getParentContainer)() | HTMLElement | Возвращает указатель на родительский контейнер.
[setCoordPoint](placemark.md#setCoordPoint)(coordPoint) |  | Устанавливает точку координатной системы, к которой привязана метка.
[setGeoPoint](placemark.md#setGeoPoint)(coordPoint) |  | То же, что и [YMaps.Placemark.setCoordPoint](placemark.md#setCoordPoint).
[setIconContent](placemark.md#setIconContent)(content) |  | Устанавливает содержимое значка метки.
[setOptions](placemark.md#setOptions)(options, restoreDefault) |  | Устанавливает опции метки.

## Наследуемые методы

Из [YMaps.IOverlay](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ioverlay.md): 
: [onAddToMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ioverlay.md#onAddToMap), [onMapUpdate](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ioverlay.md#onMapUpdate), [onRemoveFromMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ioverlay.md#onRemoveFromMap)

Из [YMaps.IInteractiveGeoObject](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md): 
: [closeBalloon](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#closeBalloon), [getBalloon](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#getBalloon), [getBalloonContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#getBalloonContent), [getBalloonOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#getBalloonOptions), [getHintContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#getHintContent), [getHintOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#getHintOptions), [openBalloon](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#openBalloon), [setBalloonContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#setBalloonContent), [setBalloonOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#setBalloonOptions), [setHintContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#setHintContent), [setHintOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#setHintOptions), [update](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/iinteractivegeoobject.md#update)

Из [YMaps.IGeoObject](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md): 
: [getBounds](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#getBounds), [getComputedStyle](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#getComputedStyle), [getParentGroup](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#getParentGroup), [getStyle](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#getStyle), [onAddToGroup](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#onAddToGroup), [onRemoveFromGroup](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#onRemoveFromGroup), [setBounds](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#setBounds), [setStyle](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/igeoobject.md#setStyle)

## Подробное описание конструктора {#constructor}

```javascript
YMaps.Placemark(coordPoint, options)
```

Создает метку в точке с заданными географическими координатами.

**См.:** [Метка](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/tasks/how-to-add-placemark.md)

**Пример:**

```javascript
// Задает опции метки и отображает метку на карте.
var placemark = new YMaps.Placemark(new YMaps.GeoPoint(37, 55), {draggable: 1,
    hintOptions: {
        maxWidth: 100,
        showTimeout: 200,
        offset: new YMaps.Point(5, 5)
    },
    balloonOptions: {
        maxWidth: 70,
        hasCloseButton: false,
        mapAutoPan: 0
    }
});
placemark.name = "Название";
placemark.description = "Описание";
map.addOverlay(placemark);
```

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`coordPoint` | [YMaps.ICoordPoint](icoordpoint.md) |  |  | Географические координаты метки.
`options` | [YMaps.PlacemarkOptions](placemarkoptions.md) | ![](../_images/check.png) |  | Опции метки.

## Подробное описание полей {#field_detail}

### Events {#Events}

```javascript
Object Events
```

Список обрабатываемых событий метки.

## Подробное описание событий {#event_detail}

### AddToMap {#AddToMap}

```javascript
AddToMap
```

Добавление метки на карту.

В callback-функцию передается указатель на метку, для которой был вызван обработчик.
### BalloonClose {#BalloonClose}

```javascript
BalloonClose
```

Закрытие балуна метки.

В callback-функцию передается указатель на метку, для которой был вызван обработчик.
### BalloonOpen {#BalloonOpen}

```javascript
BalloonOpen
```

Открытие балуна метки.

В callback-функцию передается указатель на метку, для которой был вызван обработчик.
### Click {#Click}

```javascript
Click
```

Щелчок мыши по метке.

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- указатель на объект события мыши [YMaps.MouseEvent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/mouseevent.md).
### DblClick {#DblClick}

```javascript
DblClick
```

Двойной щелчок мыши по метке.

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- указатель на объект события мыши [YMaps.MouseEvent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/mouseevent.md).
### Drag {#Drag}

```javascript
Drag
```

Продолжается перетаскивание метки.

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- объект [YMaps.Point](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/point.md) со значением смещения метки в пикселах относительно ее предыдущего положения.
### DragEnd {#DragEnd}

```javascript
DragEnd
```

Закончено перетаскивание метки.

В callback-функцию передается указатель на метку, для которой был вызван обработчик.
### DragStart {#DragStart}

```javascript
DragStart
```

Началось перетаскивание метки (если разрешено).

В callback-функцию передается указатель на метку, для которой был вызван обработчик.
### MouseEnter {#MouseEnter}

```javascript
MouseEnter
```

Курсор наведен на значок метки.

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- указатель на объект события мыши [YMaps.MouseEvent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/mouseevent.md).
### MouseLeave {#MouseLeave}

```javascript
MouseLeave
```

Курсор убран со значка метки.

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- указатель на объект события мыши [YMaps.MouseEvent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/mouseevent.md).
### MouseMove {#MouseMove}

```javascript
MouseMove
```

Движение курсора мышкой в пределах значка метки.

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- указатель на объект события мыши [YMaps.MouseEvent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/mouseevent.md).
### PositionChange {#PositionChange}

```javascript
PositionChange
```

Изменено местоположение метки (например, с помощью функции [YMaps.Placemark.setGeoPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setGeoPoint)).

В callback-функцию передаются два аргумента:

- указатель на метку, для которой был вызван обработчик;
- объект с полями:
    - oldPoint - старая географическая позиция,
    - newPoint - новая географическая позиция.
    
### RemoveFromMap {#RemoveFromMap}

```javascript
RemoveFromMap
```

Удаление метки с карты.

В callback-функцию передается указатель на метку, для которой был вызван обработчик.
## Подробное описание методов {#method_detail}

### getContentLayout {#getContentLayout}

```javascript
{YMaps.ILayout} getContentLayout()
```

Возвращает макет содержимого значка метки. Если метка не добавлена на карту, то возвращает null.

**Пример:**

```javascript
var layout = placemark.getContentLayout();
layout.getRootNodes().css('color', 'red');
```

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ILayout](ilayout.md) | Макет содержимого значка метки.

### getCoordPoint {#getCoordPoint}

```javascript
{YMaps.ICoordPoint} getCoordPoint()
```

Возвращает точку координатной системы, к которой привязана метка.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ICoordPoint](icoordpoint.md) | Точку координатной системы, к которой привязана метка.

### getGeoPoint {#getGeoPoint}

```javascript
{YMaps.ICoordPoint} getGeoPoint()
```

То же, что и [YMaps.Placemark.getCoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getCoordPoint)

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ICoordPoint](icoordpoint.md) | Точку координатной системы, к которой привязана метка.

### getIconContent {#getIconContent}

```javascript
{String|HTMLElement|YMaps.ILayout} getIconContent()
```

Возвращает содержимое значка метки, установленное с помощью метода [YMaps.Placemark.setIconContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setIconContent).

**Возвращает:**

Тип | Описание
----- | -----
String|HTMLElement|[YMaps.ILayout](ilayout.md) | Содержимое значка метки.

### getIconLayout {#getIconLayout}

```javascript
{YMaps.IPlacemarkLayout} getIconLayout()
```

Возвращает макет значка метки. Если метка не добавлена на карту, то возвращает null.

**Пример:**

```javascript
var layout = placemark.getIconLayout();
layout.getRootNodes().addClass('my-class');
```

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.IPlacemarkLayout](iplacemarklayout.md) | Макет значка метки.

### getIconShadowLayout {#getIconShadowLayout}

```javascript
{YMaps.IPlacemarkLayout} getIconShadowLayout()
```

Возвращает макет тени значка метки. Если метка не добавлена на карту, то возвращает null.

**Пример:**

```javascript
var layout = placemark.getIconShadowLayout();
layout.getRootNodes().addClass('my-shadow-class');
```

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.IPlacemarkLayout](iplacemarklayout.md) | Макет тени значка метки.

### getMap {#getMap}

```javascript
{YMaps.Map} getMap()
```

Возвращает указатель на карту, в которую добавлена метка.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Map](map.md) | Указатель на карту, в которую добавлена метка.

### getOptions {#getOptions}

```javascript
{YMaps.PlacemarkOptions} getOptions()
```

Возвращает опции метки.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.PlacemarkOptions](placemarkoptions.md) | Объект опций.

### getParentContainer {#getParentContainer}

```javascript
{HTMLElement} getParentContainer()
```

Возвращает указатель на родительский контейнер.

**Возвращает:**

Тип | Описание
----- | -----
HTMLElement | Указатель на родительский контейнер.

### setCoordPoint {#setCoordPoint}

```javascript
setCoordPoint(coordPoint)
```

Устанавливает точку координатной системы, к которой привязана метка.

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`coordPoint` | [YMaps.ICoordPoint](icoordpoint.md) | Новая точка координатной системы, к которой привязана метка.

### setGeoPoint {#setGeoPoint}

```javascript
setGeoPoint(coordPoint)
```

То же, что и [YMaps.Placemark.setCoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setCoordPoint).

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`coordPoint` | [YMaps.ICoordPoint](icoordpoint.md) | Новая точка координатной системы, к которой привязана метка.

### setIconContent {#setIconContent}

```javascript
setIconContent(content)
```

Устанавливает содержимое значка метки.

Содержимое значка, установленное с помощью этого метода, имеет приоритет перед содержимым, созданным с использованием текущего стиля.


{% note alert %}

Метки с содержимым отображаются медленнее пустых.

{% endnote %}


**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`content` | String|HTMLElement|[YMaps.ILayout](ilayout.md) | Содержимое значка метки (строка, DOM-элемент или макет).

### setOptions {#setOptions}

```javascript
setOptions(options, restoreDefault)
```

Устанавливает опции метки.

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`options` | [YMaps.PlacemarkOptions](placemarkoptions.md) |  |  | Объект опций.
`restoreDefault` | Boolean | ![](../_images/check.png) | false | Незаданные опции установить в значения по умолчанию.