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

# YMaps.GeocoderResult

{% note alert %}

Геокодирование доступно только в актуальных версиях API. 
[Как перейти на API 2.1](https://yandex.ru/dev/maps/jsapi/doc/2.1/upgrade/index.html)

{% endnote %}


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

Результат геокодирования (специальная метка с опциями).

**См.:** [Геокодирование](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/concepts/geocoder.md)

## Конструктор

Имя | Описание
----- | -----
[YMaps.GeocoderResult](geocoderresult.md#constructor)(point, options) | Создает результат геокодирования - метку с координатами найденного по запросу топонима и его описания.

## Поля

Имя | Описание
----- | -----
[AddressDetails](geocoderresult.md#AddressDetails) | Структурированное представление адреса, согласно стандарту xAL.
[kind](geocoderresult.md#kind) | Вид топонима.
[precision](geocoderresult.md#precision) | Предполагаемая точность ответа.
[text](geocoderresult.md#text) | Адрес одной строкой.

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

Из [YMaps.Placemark](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md): 
: [Events](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/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)

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

Из [YMaps.Placemark](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md): 
: [AddToMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-AddToMap), [BalloonClose](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-BalloonClose), [BalloonOpen](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-BalloonOpen), [Click](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-Click), [DblClick](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-DblClick), [Drag](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-Drag), [DragEnd](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-DragEnd), [DragStart](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-DragStart), [MouseEnter](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-MouseEnter), [MouseLeave](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-MouseLeave), [MouseMove](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-MouseMove), [PositionChange](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-PositionChange), [RemoveFromMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#event-RemoveFromMap)

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

Из [YMaps.Placemark](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md): 
: [getContentLayout](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getContentLayout), [getCoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getCoordPoint), [getGeoPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getGeoPoint), [getIconContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getIconContent), [getIconLayout](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getIconLayout), [getIconShadowLayout](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getIconShadowLayout), [getMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getMap), [getOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getOptions), [getParentContainer](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#getParentContainer), [setCoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setCoordPoint), [setGeoPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setGeoPoint), [setIconContent](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setIconContent), [setOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md#setOptions)

Из [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.GeocoderResult(point, options)
```

Создает результат геокодирования - метку с координатами найденного по запросу топонима и его описания. Класс построен на основе класса метки [YMaps.Placemark](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/placemark.md) и отличается только наличием дополнительных полей. Можно сразу добавлять на карту.

**См.:** [Геокодирование](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/concepts/geocoder.md)

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`point` | [YMaps.GeoPoint](geopoint.md) |  |  | Геоточка, определяющая положение метки на карте.
`options` | Object | ![](../_images/check.png) |  | Опции метки. Подробнее см. описание конструктора [YMaps.Placemark](placemark.md).

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

### AddressDetails {#AddressDetails}

```javascript
Object AddressDetails
```

Структурированное представление адреса, согласно стандарту xAL.

**См.:** [Спецификация xAL](http://www.oasis-open.org/committees/ciq/ciq.html#6)

**Пример:**

```javascript
// Структура, представляющая адрес Москва, Вавилова 40.
AddressDetails = {
  Country: {
    CountryName: "Россия",
    Locality:
      LocalityName: "Москва",
      Thoroughfare:
        ThoroughfareName: "улица Вавилова",
        Premise: {
           PremiseNumber: "40"
        }
      }
    }
  }
}
```
### kind {#kind}

```javascript
String kind
```

Вид топонима.

Список возможных значений:

- house - дом;
- street - улица;
- metro - метро;
- district - район;
- locality - населённый пункт;
- province - область;
- country - страна;
- hydro - река, озеро, ручей, водохранилище...;
- railway - ж.д. станция;
- route - линия метро / шоссе / ж.д. линия;
- vegetation - лес, парк...;
- cemetery - кладбище;
- bridge - мост;
- km - километр шоссе;
- other - разное.

### precision {#precision}

```javascript
String precision
```

Предполагаемая точность ответа.

Список возможных значений:

- exact - найден дом с точным совпадением номера (включая литеру, № корпуса, строения и т. д.);
- number - найден дом с тем же номером (например: 12A по 12K1);
- near - найден дом (на расстоянии не далее 10 номеров от запрошенного);
- street - найдена улица;
- other - найден некий топоним;
- suggestion - слабая уверенность, уровень предположений "Быть может, вы искали".

### text {#text}

```javascript
String text
```

Адрес одной строкой.