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

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

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

Запрос

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

Имя поля

Формат

Описание

Пример

api_key

hex-string

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

api_key=fa749bace6d8a3b1....

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"

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 г.