Поиск почтового индекса

/postcode  сервис позволяет находить:

  • адреса, использующие запрошенный почтовый индекс;
  • почтовый индекс по адресу;
  • для России дополнительно можно запросить информацию об отделении Почты России, обслуживающем почтовый индекс.

Запрос

Обязательные параметры запроса

Имя поля
Формат
Описание
Пример

api_key

hex-string

Доступ к сервисам

api_key=fa749bace6d8a3b1....

q

string

Тело поискового запроса, содержащее почтовый индекс, ref адреса или адрес, для которого необходимо найти почтовый индекс
q=125167
q=020000003792BE0E
q=Москва, Нарышкина, 5с1

Дополнительные параметры запроса

Имя поляФорматОписаниеПример

fields

fieldname1,fieldname2,....fieldnameN

Выбор полей, отображаемых в ответе. Возможные значения:
  • postoffice  детальная информация об отделении Почты России, обслуживающем найденный почтовый индекс;
  • postcode (по умолчанию)  найденный/искомый почтовый индекс;
  • addresses (по умолчанию)  адреса, использующие найденный почтовый индекс.

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

Найденные результаты
"results": [
    {
        "addresses": {
            "country""Россия",
            "localities": [
                {
                    "name""Москва",
                    "streets": [
                        {
                            "buildings": [
                                "22 с1"
                            ],
                            "name""Старокачаловская улица"
                        }
                    ]
                }
            ],
            "region""Москва",
            "subregion""Юго-Западный административный округ"
        },
        "postcode""117216"
    }
]
postcode string Найденный почтовый индекс
"postcode"125167
addresses dict Адреса, использующие найденный почтовый индекс

addresses=short:

"addresses": {
    "country""Россия",
    "localities": [
        {
            "name""Москва",
            "streets": [
                {
                    "buildings": ["8 К1", "1Д", "1Б", "1А", "1 к1"],
                    "name""Старокачаловская улица"
                },
                {
                    "buildings": ["4Г""6""6 с2""2 с1""2А"],
                    "name""Коктебельская улица"
                },
                {
                    "buildings": ["16""18""20 с1""10 с1""1Г""9 к2"],
                    "name""Куликовская улица"
                }
            ]
        }
    ],
    "region""Москва",
    "subregion""Юго-Западный административный округ"
}

 

postoffice dict
"postoffice": {
    "address""Россия, Москва, Юго-Западный административный округ, Москва, район Северное Бутово, мкрн 3, улица Грина, 5Б",
    "address_details": {
        "building""5Б",
        "country""Россия",
        "isocode""RU",
        "locality""Москва",
        "postal_code""117216",
        "region""Москва",
        "street""улица Грина",
        "sublocality""мкрн 3",
        "subregion""Юго-Западный административный округ",
        "suburb""район Северное Бутово"
    },
    "pin": [
        37.570932,
        55.566898
    ],
    "ref""22000000023FE098"
}

Описание полей postoffice

Имя поля
Формат
Описание
Пример
address string Полный найденный адрес
"address""Россия, Москва, Северный административный округ, Москва, Хорошёвский, Ленинградский проспект, 56"
address_details list Детальная информация о найденном адресе 
"address_details": {
        "building""56",
        "country""Россия",
        "isocode""RU",
        "locality""Москва",
        "postal_code""125167",
        "region""Москва",
        "street""Ленинградский проспект",
        "subregion""Северный административный округ",
        "suburb""Хорошёвский"
}
opening_hours list

Время работы почтового отделения

"opening_hours": {
    "Mo": [09:00-13:00,14:00-21:00],
    "Tu": [09:00-13:00,14:00-21:00],
    "We": [09:00-13:00,14:00-21:00],
    "Th": [09:00-13:00,14:00-21:00],
    "Fr": [09:00-13:00,14:00-21:00],
    "Sa": [10:00-18:00],
    "Su": []
}

ref

hex

ID почтового отделения

ID объекта не является стабильным и может изменяться


"ref""1000000C4D63818"

pin

list Координаты почтового отделения (долгота и широта)

"pin": [
        37.538851,
        55.796731
]

Примеры

Запрос

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?