---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/geocode.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geocode.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt

# geocode

Статическая функция.

Обрабатывает запросы геокодирования. Результат запроса может быть представлен в формате JSON или в виде объекта [GeoObjectCollection](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md). Формат ответа геокодера описан в разделе [Геокодирование](http://api.yandex.ru/maps/doc/geocoder/desc/concepts/response_structure.xml).

**См.:** [GeocodeResult](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeocodeResult.md)

**Возвращает** объект-promise.

```javascript
{ vow.Promise } geocode(request[, options])
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`request`](#param-request)[*](*star) | — | Тип: String\|Number[]

Адрес, для которого необходимо определить координаты (прямое геокодирование) или координаты, для которых необходимо определить адрес (обратное геокодирование). ||
|| [`options`](#param-options) | — | Тип: Object

Опции. ||
|| [`options.boundedBy`](#param-options.boundedBy) | — | Тип: Number[][]

Прямоугольная область на карте, где предположительно находится искомый объект. ||
|| [`options.json`](#param-options.json) | false | Тип: Boolean

Если true, то в функцию-обработчик передается JSON. В противном случае в функцию обработчик передается объект, содержащий в поле geoObjects результаты геокодирования в виде коллекции [GeoObjectCollection](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md). При геокодировании посредством геокодера 'yandex#map' в коллекции будут находиться объекты [GeocodeResult](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeocodeResult.md). ||
|| [`options.kind`](#param-options.kind) | 'house' | Тип: String

Вид топонима (только для обратного геокодирования).

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

- house - дом;
- street - улица;
- metro - станция метро;
- district - район города;
- locality - населенный пункт (город/поселок/деревня/село/...). ||
|| [`options.provider`](#param-options.provider) | 'yandex#map' | Тип: [IGeocodeProvider](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeocodeProvider.md)\|String

Провайдер геокодирования. Можно воспользоваться одним из стандартных провайдеров:
- 'yandex#map' - поиск по карте. ||
|| [`options.results`](#param-options.results) | 10 | Тип: Integer

Максимальное количество возвращаемых результатов. ||
|| [`options.searchCoordOrder`](#param-options.searchCoordOrder) | — | Тип: String

Определяет каким образом нужно интерпретировать координаты в запросе. ||
|| [`options.skip`](#param-options.skip) | 0 | Тип: Integer

Число результатов, которое необходимо пропустить. ||
|| [`options.strictBounds`](#param-options.strictBounds) | false | Тип: Boolean

Искать только внутри области, заданной опцией boundedBy. ||
|#

\* Обязательный параметр/опция.

**Примеры:**

**1.**

```javascript
// Осуществляет поиск объекта с именем "Москва".
// Полученный результат сразу отображается на карте.
var myGeocoder = ymaps.geocode("Moscow");
myGeocoder.then(
    function (res) {
        map.geoObjects.add(res.geoObjects);
        // Выведем в консоль данные, полученные в результате геокодирования объекта.
        console.log(res.geoObjects.get(0).properties.get('metaDataProperty').getAll());
    },
    function (err) {
        // Обработка ошибки.
    }
);
```

**2.**

```javascript
// Реализует интерфейс IGeocodeProvider.
var randomPointProvider = {
    geocode: function (request, options) {
        var deferred = ymaps.vow.defer(),
            geoObjects = new ymaps.GeoObjectCollection(),
            results = options.results || 10;

        for (var i = 0; i < results; i++) {
            geoObjects.add(new ymaps.GeoObject({
                geometry: {
                    type: "Point",
                    coordinates: [(Math.random() - 0.5) * 180, (Math.random() - 0.5) * 360]
                },
                properties: {
                    name: request + ' ' + i,
                    description: request + '\'s description ' + i,
                    balloonContentBody: '<p>' + request + ' ' + i + '</p>'
                }
            }));
        }

        var response = {
            geoObjects: geoObjects, // search output geo objects
            // Ответная метаинформация.
            metaData: {
                geocoder: {
                    request: request, // processed request string
                    found: results, // number of results found
                    results: results, // number of results returned
                    skip: options.skip || 0 // number of results skipped
                }
            }
        };

         // Асинхронная обработка.
        setTimeout(function () {
            deferred.resolve(response);
        }, 0);

        return deferred.promise();
    }
};
var myGeocoder = ymaps.geocode("Moscow", { provider: randomPointProvider });

myGeocoder.then(
    function (res) {
        map.geoObjects.add(res.geoObjects);
    },
    function (err) {
        // handling errors
    }
);
```

<!-- XLIFF_FARM_OWMwMzlm_CACHING -->

[*star]: Обязательный параметр.