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

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

Если интернет-магазин доставляет покупки почтой по России, хорошо бы подсказать человеку, где и когда он может забрать посылку. В этом поможет справочник почтовых отделений — в нём есть точный адрес, координаты и часы работы отделения, а ещё отметка, если оно временно закрыто.

«Дадата» помогает найти точное отделение по индексу или ближайшее — по координатам.

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

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

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

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

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

Что в ответе

НазваниеОписание
valueЗначение одной строкой (как показывается в списке подсказок)
unrestricted_valueАдрес отделения одной строкой
data.postal_codeПочтовый индекс
data.is_closedtrue, если отделение закрыто, иначе false
data.type_codeТип отделения
data.address_strАдрес одной строкой
data.address_kladr_idКЛАДР-код населённого пункта
data.address_qcКод проверки адреса
data.geo_latШирота
data.geo_lonДолгота
data.schedule_monРежим работы в понедельник
data.schedule_tueРежим работы во вторник
data.schedule_wedРежим работы в среду
data.schedule_thuРежим работы в четверг
data.schedule_friРежим работы в пятницу
data.schedule_satРежим работы в субботу
data.schedule_sunРежим работы в воскресенье

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

Стоимость

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