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

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

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

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

GET /legacy/searchAddressDetailDHL

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

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

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

ПараметрОписание
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/searchAddressDetailDHL?addr=санкт-петербург гороховая улица, 44'

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

ПараметрОписание
c_ischeckСтатус проверки
c_index_inИндекс во входящей строке
c_zipcodeИндекс найденный
c_address_originalПолученный на вход адрес
c_address_fullНайденный адрес (до улицы)
c_kladrКод КЛАДР найденный
c_region_nameНаименование региона
c_region_abbrСокращенное название аббревиатуры региона
c_region_fiasФИАС региона
c_district_nameНаименование района
c_district_abbrСокращенное название аббревиатуры района
c_district_fiasФИАС района
c_city_nameНаименование города
c_city_abbrСокращенное название аббревиатуры города
c_city_fiasФИАС города
c_community_nameНаименование населенного пункта
c_community_abbrСокращенное название аббревиатуры населенного пункта
c_community_fiasФИАС населенного пункта
c_street_nameНаименование улицы
c_street_abbrСокращенное название аббревиатуры улицы
c_street_fiasФИАС улицы
c_json_kvantДетальная информация домовой части. См. описание структуры c_json_kvant
c_house_strНомер дома
c_addr_lostНеразобранная часть входящей строки
c_status_errorКод качества
c_house_errorСтатус разбора дома (код)
c_house_error_descСтатус разбора дома (описание)
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_zipcode": "190031",
        "c_address_original": "санкт-петербург гороховая улица, 44",
        "c_address_full": "г Санкт-Петербург, ул Гороховая",
        "c_kladr": "78000000000031400",
        "c_region_name": "Санкт-Петербург",
        "c_region_abbr": "г",
        "c_region_fias": "c2deb16a-0330-4f05-821f-1d09c93331e6",
        "c_district_name": "",
        "c_district_abbr": "",
        "c_district_fias": "",
        "c_city_name": "",
        "c_city_abbr": "",
        "c_city_fias": "",
        "c_community_name": "",
        "c_community_abbr": "",
        "c_community_fias": "",
        "c_street_name": "Гороховая",
        "c_street_abbr": "ул",
        "c_street_fias": "7daba2d5-ccdd-4a51-b55c-1f73f67fe4a5",
        "c_json_kvant": {
            "house": "44"
        },
        "c_house_str": "дом 44",
        "c_addr_lost": "",
        "c_status_error": "000035",
        "c_house_error": "3",
        "c_house_error_desc": "дом найден по КЛАДР/ФИАС",
        "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"
        }
    }
]