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

# ISearchProvider

Интерфейс провайдера поиска.

[Конструктор](#constructor-summary) | [Методы ](#methods-summary)

## Конструктор {#constructor-summary}

```javascript
ISearchProvider()
```

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [search](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISearchProvider.md#search)([request](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISearchProvider.md#search-param-request)[, [options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISearchProvider.md#search-param-options)]) | [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Отправляет запрос на поиск геообъектов. Добавить функцию-обработчик для обработки результата геокодирования можно через возвращаемый объект-promise. Объект, поступающий на вход функции-обработчика может содержать поля только следующего вида: geoObjects, layers, mapState, metaData. ||
|| [suggest](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISearchProvider.md#suggest)([request](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISearchProvider.md#suggest-param-request)[, [options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISearchProvider.md#suggest-param-options)]) | [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Отправляет запрос за поисковыми подсказками. Возвращает объект Promise, который будет либо отклонён с ошибкой, либо подтверждён массивом объектов вида { displayName: "Мытищи, Московская область", value: "Россия, Московская область, Мытищи " }. Поле displayName отвечает за представление топонима в удобном для чтения пользователем виде, поле value — значение, которое необходимо подставить в поле ввода после выбора пользователем данной подсказки.

Этот метод является опциональным. ||
|#

## Описание методов {#method_detail}

### search {#search}

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

Отправляет запрос на поиск геообъектов. Добавить функцию-обработчик для обработки результата геокодирования можно через возвращаемый объект-promise. Объект, поступающий на вход функции-обработчика может содержать поля только следующего вида: geoObjects, layers, mapState, metaData.

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

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

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

Строка запроса. ||
|| [`options`](#search-param-options) | — | Тип: Object

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

Прямоугольная область на карте, где предположительно находится искомый объект. Должна быть задана как массив, например [[30, 40], [50, 50]]. ||
|| [`options.results`](#search-param-options.results) | — | Тип: Number

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

Число результатов, которое необходимо пропустить. ||
|#

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

### suggest {#suggest}

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

Отправляет запрос за поисковыми подсказками. Возвращает объект Promise, который будет либо отклонён с ошибкой, либо подтверждён массивом объектов вида { displayName: "Мытищи, Московская область", value: "Россия, Московская область, Мытищи " }. Поле displayName отвечает за представление топонима в удобном для чтения пользователем виде, поле value — значение, которое необходимо подставить в поле ввода после выбора пользователем данной подсказки.

Этот метод является опциональным.

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

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

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

Строка запроса. ||
|| [`options`](#suggest-param-options) | — | Тип: Object

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

Прямоугольная область на карте, где предположительно находится искомый объект. Должна быть задана как массив, например [[30, 40], [50, 50]]. ||
|| [`options.results`](#suggest-param-options.results) | — | Тип: Number

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

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

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

<!-- XLIFF_FARM_MmQ2MmJm_CACHING -->

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