Определение почтового индекса
/postcode — сервис позволяет находить:
- адреса, использующие запрошенный почтовый индекс;
- почтовый индекс по адресу;
- для России дополнительно можно запросить информацию об отделении Почты России, обслуживающем почтовый индекс.
Запрос
Обязательные параметры запроса
| Имя поля | Формат | Описание | Пример |
|---|---|---|---|
api_key | hex-string | Доступ к сервисам. | api_key=fa749bace6d8a3b1.... |
q | string | Тело поискового запроса, содержащее почтовый индекс, ref-адреса или адрес, для которого необходимо найти почтовый индекс | q=125167q=020000003792BE0Eq=Москва, Нарышкина, 5с1 |
Дополнительные параметры запроса
| Имя поля | Формат | Описание | Пример |
|---|---|---|---|
fields | fieldname1,fieldname2,....fieldnameN | Выбор полей, отображаемых в ответе. Возможные значения:
| fields=postoffice,postcode,addresses |
addresses | string | Формат ответа для поля addresses: short (по умолчанию) — краткое иерархическое представление адресов, использующих найденный почтовый индекс. | addresses=full |
isocode | char2 | Двухбуквенный код страны согласно ISO 3166-1 alpha-2 На текущий момент поддерживается только RU | isocode=ru |
Ответ
| Имя поля | Формат | Описание | Пример |
|---|---|---|---|
request | string | Запрос | "request": "125167" |
results | list | Найденные результаты | |
postcode | string | Найденный почтовый индекс | "postcode": 125167 |
addresses | dict | Адреса, использующие найденный почтовый индекс | |
postoffice | dict | Адрес почтового отделения | |
Описание полей postoffice
| Имя поля | Формат | Описание | Пример |
|---|---|---|---|
address | string | Полный найденный адрес | |
address_details | list | Детальная информация о найденном адресе | |
opening_hours | list | Время работы почтового отделения | |
ref | hex | ID почтового отделения. предупреждение ID объекта не является стабильным и может изменяться | "ref": "1000000C4D63818" |
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"
}
}
]
}