Подсказки: ФИАС

Ищет адреса строго по ФИАС. Используйте эти подсказки только в том случае, если твёрдо уверены, что вам нужны именно они. Для большинства задач намного лучше подходят подсказки по адресам — они более полные, логичные и удобные. Подсказки по ФИАС нужны только если вам по какой-то причине важно точное, побуквенное соответствие справочнику адресов налоговой службы.

Если слова «ФИАС» и «планировочная структура» вам ничего не говорят — пожалуйста, не используйте эти подсказки. Используйте подсказки по адресам.

Как подключить

1. Зарегистрируйтесь и получите API-ключ
2. Вставьте код из примера на свой сайт.
3. Profit!

<input id="address" name="address" type="text" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<link href="http://cdn.jsdelivr.net/npm/suggestions-jquery@22.6.0/dist/css/suggestions.min.css" rel="stylesheet" />
<script src="http://cdn.jsdelivr.net/npm/suggestions-jquery@22.6.0/dist/js/jquery.suggestions.min.js"></script>

<script>
    $("#address").suggestions({
        token: "${API_KEY}",
        type: "FIAS",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>

Параметр token — это API-ключ.

Демонстрация

Выберите вариант из списка, чтобы увидеть полный текст ответа в JSON:

Также работает через API

Что в ответе

Аргумент suggestion функции onSelect выглядит так:

  1 — регион
  3 — район
  4 — город
  5 — район города
  6 — населенный пункт
  7 — улица
  8 — дом
 65 — планировочная структура

  0    — актуальный
  1–50 — переименован
  51   — переподчинен
  99   — удален

  1 — центр района
      (Московская обл, Одинцовский р-н, г Одинцово)
  2 — центр региона
      (Новосибирская обл, г Новосибирск)
  3 — центр района и региона
      (Томская обл, г Томск)
  4 — центральный район региона
      (Тюменская обл, Тюменский р-н)
  0 — ничего из перечисленного
      (Московская обл, г Балашиха)

Источник данных: Федеральная информационная адресная система (ФИАС) Налоговой службы.

Примеры настройки

Подсказки отдельными полями

Разложить адрес по полям: индекс, регион, город, улица, дом

Подсказывать адреса внутри конкретного города или области

Ограничения

На бесплатном тарифе плагин подсказок показывает логотип «Дадаты» в углу выпадающего списка. На платных тарифах и в «коробке» логотипа нет.

Количество запросов в день — в соответствии с тарифным планом.

Длина запроса — не более 300 символов.

Количество условий (параметр locations) — не более 10.

Частые вопросы

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.