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

Подсказки: отделения Почты России

Справочник отделений Почты России.

  1. Вставьте код из примера на свой сайт.
  2. Profit!
<input id="postal_office" name="postal_office" 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>
    $("#postal_office").suggestions({
        token: "${API_KEY}",
        type: "POSTAL_OFFICE",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>

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

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

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

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

Что в ответе

НазваниеОписание
valueЗначение одной строкой (как показывается в списке подсказок)
unrestricted_valueИндекс и название отделения одной строкой
data.indexПочтовый индекс
data.opsnameНазвание отделения
data.opstypeТип отделения
data.opssubmИндекс вышестоящего отделения
data.regionРегион
data.areaРайон в регионе
data.cityГород
data.settlementНаселённый пункт
data.actdateДата актуальности

Источник данных: Почта России

Стоимость

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