Вопросы и ответы > Населенные пункты

Населенные пункты

Запуск проекта - август 2010 года.
Число зарегистрированных доменов - 2982.
Число зарегистрированных пользователей - 3377.
О проекте
Платный доступ
Регистрационный ключ домена
Базы данных
Проблемы при подключении
Рабочая база ключей населенных пунктов Postcalc.RU.
Источник - Эталонный справочник почтовых индексов объектов почтовой связи Почты России, проекты Open Street Map и Wikipedia.
Рабочая база данных обновляется один раз в месяц.
Ее можно:
  • Просмотреть онлайн.
  • Скачать в формате дампа таблицы MySQL.
  • Скачать упрощенную версию в "старом" формате (вместо номера региона указано название) в виде текста или дампа MySQL для Postcalc Light (таблица postcalc_light_cities). "Старый" формат будет поддерживаться в течение 2021 года, далее поддержка не гарантируется.
Ключи населенных пунктов:
  • Для центров регионов состоят из названия населенного пункта: Москва, Самара, Благовещенск.
  • Для прочих населенных пунктов состоят из его названия и номера региона через запятую: Сергиев Посад, 50; Благовещенск, 2 (город в Башкортостане), Самара, 38 (село в Иркутской области); Самара, 79 (село в Еврейской АО).
  • Если в пределах одного региона находятся несколько населенных пунктов с одним названием, то через запятую добавляется район: Михайловка, 2, Абзелиловский; Михайловка, 2, Архангельский; Михайловка, 2, Бакалинский.
В ключе населенного пункта вместо номера региона можно указать его название (старый формат запроса), например: Сургут, Ханты-Мансийский-Югра автономный округ; Сергиев Посад, Московская область. Однако так делать не рекомендуется, так как это ухудшает читаемость и удлиняет строку запроса, кроме того, у регионов имеются альтернативные названия и они могут меняться.

Примечание. Если в переменной f= (или t=) указан не конкретный почтовый индекс, а населенный пункт, API самостоятельно ищет почтовые отделения, из которых/в которые можно отправить данный вид посылок. Это прежде всего относится к отправлениям для корпоративных клиентов, поскольку они принимаются и выдаются не во всех отделениях связи.
Например, если вы отправляете из московского отделения 105005 в отделение 190000 Посылку Онлайн, то запрос
http://api.postcalc.ru/?f=105005&t=190000&w=1000&v=1000&p=po&key=test
- вернет ошибку, так как в отделении 105005 приема Посылки Онлайн нет.
В то же время запрос
http://api.postcalc.ru/?f=Москва&t=190000&w=1000v=1000&p=po&key=test
- вернет корректный расчет, так как API самостоятельно найдет в пределах Москвы отделение связи, откуда можно отправить Посылку Онлайн.
Аналогично, запрос на доставку ЕКОМ в 190000 вернет ошибку, так как в 190000 ЕКОМ не выдается:
http://api.postcalc.ru/?f=105005&t=190000&w=1000&v=1000&p=ek&key=test
А запрос на доставку в Санкт-Петербург вернет правильный расчет:
http://api.postcalc.ru/?f=101000&t=Санкт-Петербург&w=1000v=1000&p=ek&key=test