Стандартизация адреса в формате старого API CheckAddress

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

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

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

GET /legacy/checkAddress

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

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

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

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

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

# GET параметры

-X GET 
--header 'Accept: application/json' 
'https://api.apidq.ru/api/legacy/checkAddress?addr=санкт-петербург гороховая улица, 44'

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

ПараметрОписание
c_ischeckСтатус проверки
c_index_inИндекс во входящей строке
c_index_outИндекс найденный
c_addr_inПолученный на вход адрес
c_addr_outНайденный адрес (до улицы)
c_kladrКод КЛАДР найденный
c_json_kvantДетальная информация домовой части. См. описание структуры c_json_kvant
c_house_strНомер дома
c_status_errorКод качества
c_house_error_descСтатус разбора дома (описание)
c_addr_lostНеразобранная часть входящей строки
c_kladr1919-значный КЛАДР
c_gninmbКод ИФНС
c_okatoКод ОКАТО
c_oktmoКод ОКТМО
c_aoguidКод ФИАС до улицы
c_aolevelУровень по ФИАС
c_houseguidИдентификатор дома
c_timezoneЧасовой пояс
c_coordinateКоординаты адреса. См. описание структуры coordinates

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

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

ПараметрОписание
houseдом
caseкорпус
buildстроение
literлитера
lendвладение
constrсооружение
steadучасток
flatквартира
officeофис
roomкомната
kabкабинет
placeпомещение
entrподъезд
floorэтаж
blockблок
pavпавильон
sekсекция
abonа/я
munitв/ч

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

ПараметрОписание
c_latШирота
c_lonДолгота
c_levelУровень

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

[
    {
        "c_ischeck": "1",
        "c_index_in": "",
        "c_index_out": "190031",
        "c_addr_in": "санкт-петербург гороховая улица, 44",
        "c_addr_out": "г Санкт-Петербург, ул Гороховая",
        "c_kladr": "78000000000031400",
        "c_json_kvant": {
            "house": "44"
        },
        "c_kvant": "house:44",     
		"c_house_str": "дом 44",
        "c_house_error_desc": "дом найден по КЛАДР/ФИАС",
        "c_status_error": "000035",
        "c_addr_lost": "",
        "c_kladr19": "",
        "c_gninmb": "",
        "c_okato": "",
        "c_oktmo": "40302000",
        "c_aoguid": "7daba2d5-ccdd-4a51-b55c-1f73f67fe4a5",
        "c_aolevel": "7",
        "c_houseguid": "",
        "c_timezone": "",
        "c_coordinate": {
            "c_lon": "30.3102",
            "c_lat": "59.9356",
            "c_level": "7"
        }
    }
]