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

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

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

Вставьте код из примера на свой сайт.
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_closed	`true`, если отделение закрыто, иначе `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 тысяч запросов в день. Больше — в составе годовой подписки.