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

# suggest

{% include [include](../../../_includes/2.1/terms/index-47b676c75e05.md) %}

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

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

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

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

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

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

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

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

Прямоугольная область на карте, где предположительно находится искомый объект. Должна быть задана как массив, например [[30, 40], [50, 50]]. ||
|| [`options.provider`](#param-options.provider) | 'yandex#map' | Тип: [ISuggestProvider](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ISuggestProvider.md)\|String

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

Максимальное количество возвращаемых результатов. ||
|#

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

**Пример:**

```javascript
ymaps.suggest('мыт').then(function (items) {
    // items - массив поисковых подсказок.
});
```

<!-- XLIFF_FARM_MTg1MzUw_CACHING -->

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