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

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

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

Вставьте код из примера на свой сайт.
Profit!

<input id="postal_unit" name="postal_unit" type="text" />
<link href="https://cdn.jsdelivr.net/npm/@dadata/suggestions@25.4.1/dist/suggestions.min.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/@dadata/suggestions@25.4.1/dist/suggestions.min.js"></script>

<script>
    const input = document.getElementById("postal_unit");
    Dadata.createSuggestions(input, {
        token: "${API_KEY}",
        type: "postal_unit"
    });
</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 тысяч запросов в день. Больше — в составе годовой подписки.