Стандартизация адреса #

Сервис разбора адресной строки производит анализ входящего контента на наличие элементов адреса. Найденные адресные элементы сопоставляются с адресными эталонными справочниками, и при нахождении достаточного соответствия выводится единственный искомый и гранулированный адрес.

Адрес метода #

POST /clean/address

Функциональность #

очищает входящие данные от лишних символов для стандартизации адреса;
определяет координаты адреса (при наличии их в эталонном справочнике);
определяет индекс дома;
дополняет недостающие адресные уровни (регион, район);
определяет идентификаторы в различных эталонных базах.

Параметры запроса #

Параметр	Описание
query	Строка для разбора адреса
countryCode	Код страны, в которой происходит поиск адреса, в формате ISO 3166 ( https://www.iso.org/iso-3166-country-codes.html)

Пример данных запроса #

{
  "query": "Москва, Профсоюзная улица, 42к1, 242",
  "countryCode": "RU"
}

Параметры ответа #

Параметр	Описание
original	Входящая строка с адресом, которая участвовала в стандартизации
address	Строка с разобранным и стандартизированным адресом
addressFull	Строка с разобранным и стандартизированным адресом вместе с домовой частью
postcodeIn	Почтовый индекс найденный во входящей строке
postcode	Почтовый индекс определенный по эталонной базе в процессе стандартизации
region	Регион, область. См. описание структуры `addressLevel`
area	Район области. См. описание структуры `addressLevel`
municipal	Муниципальное образование. См. описание структуры `addressLevel`
city	Город. См. описание структуры `addressLevel`
cityArea	Район города. См. описание структуры `addressLevel`
settlement	Населенный пункт. См. описание структуры `addressLevel`
planStructure	Планировочная структура (микрорайон). См. описание структуры `addressLevel`
street	Улица. См. описание структуры `addressLevel`
houseDetails	Домовая часть адреса. См. описание структуры `houseDetails`
coordinates	Географические координаты. См. описание структуры `coordinates`
country	Страна. См. описание структуры `country`
valid	Признак корректности адреса
quality	Код качества адреса. См Код качества адреса
timezone	Часовой пояс
undefinedParts	Нераспознанная часть адреса
metro	Список ближайших станций метро (не более 3 станций в радиусе 5 км). Заполняется только для `POST /clean/address`, для остальных методов адресного поиска — пустой список. См. описание структуры `metro`

Вложенные структуры #

Описание структуры `addresslevel` #

Параметр	Описание
fullName	Наименование и тип адресного элемента
name	Наименование адресного элемента
type	Тип адресного элемента
codes	Коды адресного элемента

Описание структуры `codes` #

Параметр	Описание
fias	Код в базе ФИАС
ga	GaCode - глобальный адресный код
osm	Код в базе OpenStreetMap
gar	Код в базе ГАР
kladr	Код в базе КЛАДР

Описание структуры `housedetails` #

Параметр	Описание
full_name	дом строкой
house	дом
case	корпус
build	строение
liter	литера
lend	владение
constr	сооружение
stead	участок
flat	квартира
office	офис
room	комната
kab	кабинет
place	помещение
entr	подъезд
floor	этаж
block	блок
pav	павильон
sek	секция
abon	а/я
munit	в/ч
codes	Коды дома. См. описание структуры `codes`
apartmentCodes	Коды найденного помещения (квартиры). Заполняется только для `POST /clean/address` и `POST /idsearch/address`. См. описание структуры `codes`
additional	Дополнительные атрибуты дома/помещения. Заполняется только для `POST /clean/address` и `POST /idsearch/address`. См. описание структуры `additional`

Описание структуры `additional` #

Параметр	Описание
houseIsMultiFlat	Признак многоквартирного дома
houseFlatCount	Количество квартир в доме
houseCadnum	Кадастровый номер дома
apartmentCadnum	Кадастровый номер помещения

Описание структуры `metro` #

Параметр	Описание
name	Название станции
line	Название линии
city	Город
distance	Расстояние до станции в метрах

Описание структуры `coordinates` #

Параметр	Описание
latitude	Широта
longitude	Долгота

Описание структуры `country` #

Параметр	Описание
name	Наименование страны
alpha2	Код страны, в формате ISO 3166-1 alpha-2
alpha3	Код страны, в формате ISO 3166-1 alpha-3
numeric	Код страны, в формате ISO 3166-1 numeric

Пример данных ответа #

{
  "original": "Москва, Профсоюзная улица, 42к1, 242",
  "addressFull": "г Москва, ул Профсоюзная, дом 42, корпус 1, квартира 242",
  "address": "г Москва, ул Профсоюзная",
  "postcodeIn": "",
  "postcode": "117335",
  "region": {
    "fullName": "г Москва",
    "name": "Москва",
    "type": "г",
    "codes": {
      "fias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
      "ga": "RU0770000000000000000000000",
      "osm": "R102269",
      "gar": "1405113",
      "kladr": "7700000000000"
    }
  },
  "area": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "municipal": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "city": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "cityArea": {
    "fullName": "Академический р-н",
    "name": "Академический",
    "type": "р-н",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "settlement": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "planStructure": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "street": {
    "fullName": "ул Профсоюзная",
    "name": "Профсоюзная",
    "type": "ул",
    "codes": {
      "fias": "9a661426-e65c-4223-af4d-aa5e95b7caac",
      "ga": "RU0770000000000000000002392",
      "osm": "W30750376",
      "gar": "1401987",
      "kladr": "77000000000239200"
    }
  },
  "houseDetails": {
    "fullName": "дом 42, корпус 1, квартира 242",
    "house": "42",
    "case": "1",
    "build": "",
    "liter": "",
    "lend": "",
    "constr": "",
    "stead": "",
    "flat": "242",
    "office": "",
    "room": "",
    "kab": "",
    "place": "",
    "entr": "",
    "floor": "",
    "block": "",
    "pav": "",
    "sek": "",
    "abon": "",
    "munit": "",
    "codes": {
      "fias": "2d960636-942f-48bd-8362-b39fea91a3e4",
      "ga": "",
      "osm": "",
      "gar": "56965994",
      "kladr": ""
    },
    "apartmentCodes": {
      "fias": "0361c9ca-1703-4535-b11a-6fbd372448e1",
      "ga": "",
      "osm": "",
      "gar": "56968181",
      "kladr": ""
    },
    "additional": {
      "houseIsMultiFlat": true,
      "houseFlatCount": "143",
      "houseCadnum": "77:06:0003009:1025",
      "apartmentCadnum": "77:06:0003009:2561"
    }
  },
  "coordinates": {
    "latitude": 55.674565,
    "longitude": 37.55814
  },
  "country": {
    "name": "Россия",
    "alpha2": "RU",
    "alpha3": "RUS",
    "numeric": 643
  },
  "valid": true,
  "quality": {
    "unique": 0,
    "actuality": 0,
    "undefined": 0,
    "level": 9,
    "house": 3,
    "geo": 8
  },
  "timezone": "UTC+3",
  "undefinedParts": "",
  "metro": [
    {
      "name": "Профсоюзная",
      "line": "Калужско-Рижская",
      "city": "Москва",
      "distance": 479
    },
    {
      "name": "Новые Черемушки",
      "line": "Калужско-Рижская",
      "city": "Москва",
      "distance": 550
    },
    {
      "name": "Вавиловская",
      "line": "Троицкая",
      "city": "Москва",
      "distance": 1580
    }
  ]
}

Стандартизация адреса #

Адрес метода #

Функциональность #

Параметры запроса #

Пример данных запроса #

Параметры ответа #

Вложенные структуры #

Описание структуры addresslevel #

Описание структуры codes #

Описание структуры housedetails #

Описание структуры additional #

Описание структуры metro #

Описание структуры coordinates #

Описание структуры country #