Поиск почтового индекса
/postcode — сервис позволяет находить:
- адреса, использующие запрошенный почтовый индекс;
- почтовый индекс по адресу;
- для России дополнительно можно запросить информацию об отделении Почты России, обслуживающем почтовый индекс.
Запрос
Обязательные параметры запроса
Имя поля
|
Формат
|
Описание
|
Пример
| |||
---|---|---|---|---|---|---|
api_key |
hex-string |
|
||||
q |
string |
Тело поискового запроса, содержащее почтовый индекс, ref адреса или адрес, для которого необходимо найти почтовый индекс |
|
Дополнительные параметры запроса
Имя поля | Формат | Описание | Пример | |
---|---|---|---|---|
fields |
fieldname1,fieldname2,....fieldnameN |
Выбор полей, отображаемых в ответе. Возможные значения:
|
|
|
addresses |
string |
Формат ответа для поля addresses:
|
|
|
isocode |
char2 |
Двухбуквенный код страны согласно ISO 3166-1 alpha-2
|
|
Ответ
Имя поля
|
Формат
|
Описание
|
Пример
| |
---|---|---|---|---|
request |
string |
Запрос |
|
|
results |
list |
Найденные результаты |
|
|
postcode | string | Найденный почтовый индекс |
|
|
addresses | dict | Адреса, использующие найденный почтовый индекс |
addresses=short:
|
|
postoffice | dict |
|
Описание полей postoffice
Имя поля
|
Формат
|
Описание
|
Пример
| |
---|---|---|---|---|
address | string | Полный найденный адрес |
|
|
address_details | list | Детальная информация о найденном адресе |
|
|
opening_hours | list |
Время работы почтового отделения |
|
|
ref |
hex |
ID почтового отделения
|
|
|
pin |
list | Координаты почтового отделения (долгота и широта) |
|
Примеры
Запрос
https: //geo.rustore.ru/api/postcode?api_key=<YOUR_API_KEY>&q=125167&fields=* |
Ответ
{ "request" : "/postcode?q=125167&fields=*" , "results" : [ { "addresses" : { "country" : "Россия" , "localities" : [ { "name" : "Москва" , "streets" : [ { "buildings" : [ "56/2" , "37Б" , "39 с3" , "39 с9" , "39" , "39" , "37" , "37 к8" , "39" , "37 к12" , "39 с17" , "36 с37" , "36 с30" , "36 с38" ], "name" : "Ленинградский проспект" }, { "buildings" : [ "7А" , "5" , "3" , "4 с4" , "4А" , "4" , "4" , "4 с12" , "4 с11" , "4 с7" , "2 с1" , "4 с6" , "4 с8" ], "name" : "Новый Зыковский проезд" }, { "buildings" : [ "1" , "5 кД" , "5 к1" , "10" , "3" , "5 к3" ], "name" : "улица Серёгина" }, { "buildings" : [ "39 с12" ], "name" : "Ходынский бульвар" }, { "buildings" : [ "11" , "11А" , "11Б" , "3" , "10" , "11А с1" , "6" , "8 с3" , "8" , "8 с14" , "8 с11" , "1А" ], "name" : "проезд Аэропорта" }, { "buildings" : [ "5 с2" , "5 с1" ], "name" : "Нарышкинская аллея" }, { "buildings" : [ "4" , "5 к3" , "5 к2" , "5 к1" , "8 к2" , "8 к1" , "7" , "6" , "3" , "3Б" ], "name" : "улица Константина Симонова" }, { "buildings" : [ "4" , "6" , "4А" , "8" , "5 с25" , "5 к22" , "5 к8" , "5 к7" , "5 к2" , "5 с9" , "5 к11" , "5 к25" , "5 к26" , "5 с35" , "5 к27А" , "5 с19" , "5 с20" ], "name" : "Авиационный переулок" }, { "buildings" : [ "4" , "5" , "3" ], "name" : "Эльдорадовский переулок" }, { "buildings" : [ "2А" , "2А с2" , "3/5" , "1А" , "2 к1" , "2 к2" , "2 к3" , "2 с5" ], "name" : "Красноармейская улица" }, { "buildings" : [ "3" ], "name" : "улица Степана Супруна" }, { "buildings" : [ "3" , "4" , "6 к2" , "6 к1" , "5" ], "name" : "Старый Зыковский проезд" }, { "buildings" : [ "3" , "3 с2" ], "name" : "1-я улица 8 Марта" }, { "buildings" : [ "3" ], "name" : "Трудовая аллея" }, { "buildings" : [ "7" , "5" , "9" , "9А" , "11" ], "name" : "улица Пилота Нестерова" } ] } ], "region" : "Москва" , "subregion" : "Северный административный округ" }, "postcode" : "125167" , "postoffice" : { "address" : "Россия, Москва, Северный административный округ, Москва, район Аэропорт, Ленинградский проспект, 56" , "address_details" : { "building" : "56" , "country" : "Россия" , "isocode" : "RU" , "locality" : "Москва" , "region" : "Москва" , "street" : "Ленинградский проспект" , "subregion" : "Северный административный округ" , "suburb" : "район Аэропорт" }, "pin" : [ 37.537903 , 55.798518 ], "ref" : "2100000045438C4B" } } ] } |
Обновлено 22 декабря 2022 г.
Was this information helpful?