Разбор адреса из строки («стандартизация»)

Описание

  • Разбивает адрес по отдельным полям (регион, город, улица, дом, квартира).

  • Рассчитывает корректный индекс по данным Почты России.

  • Определяет координаты.

  • Показывает округ и район города, ближайшее метро, площадь и стоимость квартиры.

  • Достает коды КЛАДР, ФИАС (ГАР), ОКАТО, ОКТМО и ИФНС.

Только для России!
Координаты есть у 97% домов в Москве, 91% в Санкт-Петербурге, 69% в других городах-миллиониках и 47% по остальной России.
Площадь и стоимость есть у 70% квартир в России.
Максимальная частота запросов — 20 в секунду с одного IP-адреса. Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Как вызвать

StandardizationAddressApi client = apiClientFactory.getClient(StandardizationAddressApi.class);
List<AddressResponse> addresses = client.getAddresses("уфа октября 3/4");
Ответ
[
  {
    "source": "уфа октября 3/4",
    "result": "г Уфа, пр-кт Октября, д 3/4",
    "postal_code": "450001",
    "country": "Россия",
    "country_iso_code": "RU",
    "federal_district": "Приволжский",
    "region_fias_id": "6f2cbfd8-692a-4ee4-9b16-067210bde3fc",
    "region_kladr_id": "0200000000000",
    "region_iso_code": "RU-BA",
    "region_with_type": "Респ Башкортостан",
    "region_type": "Респ",
    "region_type_full": "республика",
    "region": "Башкортостан",
    "area_fias_id": null,
    "area_kladr_id": null,
    "area_with_type": null,
    "area_type": null,
    "area_type_full": null,
    "area": null,
    "city_fias_id": "7339e834-2cb4-4734-a4c7-1fca2c66e562",
    "city_kladr_id": "0200000100000",
    "city_with_type": "г Уфа",
    "city_type": "г",
    "city_type_full": "город",
    "city": "Уфа",
    "city_area": null,
    "city_district_fias_id": null,
    "city_district_kladr_id": null,
    "city_district_with_type": "р-н Советский",
    "city_district_type": "р-н",
    "city_district_type_full": "район",
    "city_district": "Советский",
    "settlement_fias_id": null,
    "settlement_kladr_id": null,
    "settlement_with_type": null,
    "settlement_type": null,
    "settlement_type_full": null,
    "settlement": null,
    "street_fias_id": "8dade0a4-ac2a-4884-a854-762ab0abbdca",
    "street_kladr_id": "02000001000076100",
    "street_with_type": "пр-кт Октября",
    "street_type": "пр-кт",
    "street_type_full": "проспект",
    "street": "Октября",
    "stead_fias_id": null,
    "stead_kladr_id": null,
    "stead_cadnum": null,
    "stead_type": null,
    "stead_type_full": null,
    "stead": null,
    "house_fias_id": null,
    "house_kladr_id": null,
    "house_cadnum": null,
    "house_type": "д",
    "house_type_full": "дом",
    "house": "3/4",
    "block_type": null,
    "block_type_full": null,
    "block": null,
    "entrance": null,
    "floor": null,
    "flat_fias_id": null,
    "flat_cadnum": null,
    "flat_type": null,
    "flat_type_full": null,
    "flat": null,
    "flat_area": null,
    "square_meter_price": null,
    "flat_price": null,
    "postal_box": null,
    "fias_id": "8dade0a4-ac2a-4884-a854-762ab0abbdca",
    "fias_code": "02000001000000007610000",
    "fias_level": "7",
    "fias_actuality_state": "0",
    "kladr_id": "02000001000076100",
    "capital_marker": "2",
    "okato": "80401390000",
    "oktmo": "80701000001",
    "tax_office": "0278",
    "tax_office_legal": "0278",
    "timezone": "UTC+5",
    "geo_lat": "54.740911",
    "geo_lon": "55.985317",
    "beltway_hit": null,
    "beltway_distance": null,
    "qc_geo": 1,
    "qc_complete": 10,
    "qc_house": 10,
    "qc": 0,
    "unparsed_parts": null,
    "metro": null
  }
]
Название Длина Описание

source

250

Исходный адрес одной строкой

result

500

Стандартизованный адрес одной строкой

postal_code

6

Индекс

country

120

Страна

country_iso_code

2

ISO-код страны

federal_district

20

Федеральный округ

region_fias_id

36

ФИАС-код региона

region_kladr_id

19

КЛАДР-код региона

region_iso_code

6

ISO-код региона

region_with_type

131

Регион с типом

region_type

10

Тип региона (сокращенный)

region_type_full

50

Тип региона

region

120

Регион

area_fias_id

36

ФИАС-код района

area_kladr_id

19

КЛАДР-код района

area_with_type

131

Район в регионе с типом

area_type

10

Тип района в регионе (сокращенный)

area_type_full

50

Тип района в регионе

area

120

Район в регионе

city_fias_id

36

ФИАС-код города

city_kladr_id

19

КЛАДР-код города

city_with_type

131

Город с типом

city_type

10

Тип города (сокращенный)

city_type_full

50

Тип города

city

120

Город

city_area

120

Административный округ (только для Москвы)

city_district_fias_id

36

ФИАС-код района города (заполняется, только если район есть в ФИАС)

city_district_kladr_id

19

КЛАДР-код района города (не заполняется)

city_district_with_type

131

Район города с типом

city_district_type

10

Тип района города (сокращенный)

city_district_type_full

50

Тип района города

city_district

120

Район города

settlement_fias_id

36

ФИАС-код населенного пункта

settlement_kladr_id

19

КЛАДР-код населенного пункта

settlement_with_type

131

Населенный пункт с типом

settlement_type

10

Тип населенного пункта (сокращенный)

settlement_type_full

50

Тип населенного пункта

settlement

120

Населенный пункт

street_fias_id

36

ФИАС-код улицы

street_kladr_id

19

КЛАДР-код улицы

street_with_type

131

Улица с типом

street_type

10

Тип улицы (сокращенный)

street_type_full

50

Тип улицы

street

120

Улица

stead_fias_id

36

ФИАС-код земельного участка

stead_kladr_id

19

КЛАДР-код земельного участка

stead_cadnum

50

Кадастровый номер земельного участка

stead_type

10

= «уч»

stead_type_full

50

= «участок»

stead

50

Номер земельного участка

house_fias_id

36

ФИАС-код дома

house_kladr_id

19

КЛАДР-код дома

house_cadnum

50

Кадастровый номер дома

house_type

10

Тип дома (сокращенный)

house_type_full

50

Тип дома

house

50

Дом

block_type

10

Тип корпуса/строения (сокращенный)

block_type_full

50

Тип корпуса/строения

block

50

Корпус/строение

entrance

10

Подъезд

floor

10

Этаж

flat_fias_id

36

ФИАС-код квартиры

flat_cadnum

50

Кадастровый номер квартиры

flat_type

10

Тип квартиры (сокращенный)

flat_type_full

50

Тип квартиры

flat

50

Квартира

flat_area

50

Площадь квартиры

square_meter_price

50

Рыночная стоимость м²

flat_price

50

Рыночная стоимость квартиры

postal_box

50

Абонентский ящик

fias_id

36

ФИАС-код адреса (идентификатор ФИАС):

* ROOM.ROOMGUID — если квартира найдена в ФИАС

* HOUSE.HOUSEGUID — если дом найден в ФИАС

* ADDROBJ.AOGUID — в противном случае

fias_code

Не заполняется, используйте fias_id

fias_level

2

Уровень детализации, до которого адрес найден в ФИАС:

-1 — иностранный или пустой

0 — страна

1 — регион

3 — район

4 — город

5 — район города

6 — населенный пункт

7 — улица

8 — дом

9 — квартира

65 — планировочная структура

90 — доп. территория

91 — улица в доп. территории

fias_actuality_state

Признак актуальности адреса в ФИАС:

0 — актуальный

1-50 — переименован

51 — переподчинен

99 — удален

kladr_id

19

КЛАДР-код адреса

capital_marker

1

Признак центра района или региона:

1 — центр района (Московская обл, Одинцовский р-н, г Одинцово)

2 — центр региона (Новосибирская обл, г Новосибирск)

3 — центр района и региона (Томская обл, г Томск)

4 — центральный район региона (Тюменская обл, Тюменский р-н)

0 — ничего из перечисленного (Московская обл, г Балашиха)

okato

11

Код ОКАТО

oktmo

11

Код ОКТМО

tax_office

4

Код ИФНС для физических лиц

tax_office_legal

4

Код ИФНС для организаций

timezone

50

Часовой пояс города для России, часовой пояс страны — для иностранных адресов. Если у страны несколько поясов, вернёт минимальный и максимальный через слеш: UTC+5/UTC+6

geo_lat

12

Координаты: широта

geo_lon

12

Координаты: долгота

beltway_hit

8

Внутри кольцевой?:

* IN_MKAD — внутри МКАД (Москва)

* OUT_MKAD — за МКАД (Москва и область)

* IN_KAD — внутри КАД (Санкт-Петербург)

* OUT_KAD — за КАД (Санкт-Петербург и область)

* пусто — в остальных случаях

beltway_distance

3

Расстояние от кольцевой в км. Заполнено, только если beltway_hit: OUT_MKAD или OUT_KAD, иначе пустое

qc_geo

5

Код точности координат

qc_complete

5

Код пригодности к рассылке

qc_house

5

Признак наличия дома в ФИАС

qc

5

Код проверки адреса

unparsed_parts

250

Нераспознанная часть адреса. Для адреса «Москва, Митинская улица, 40, вход с торца» вернет «ВХОД, С, ТОРЦА»

metro

Список ближайших станций метро (до трёх штук)

Коды качества

Код проверки qc

Нужно ли вручную проверить распознанный адрес:

Код qc

Описание

Нужно проверить вручную?

0

Адрес распознан уверенно

Нет

2

Адрес пустой или заведомо «мусорный»

Нет

1

Остались «лишние» части. Пример: «109341 Тверская область Москва Верхние Поля» — здесь лишняя «Тверская область».

Либо в исходном адресе недостаточно данных для уверенного разбора. Пример: «Сходня Красная 12» — здесь нет региона и города.

Да

3

Есть альтернативные варианты. Пример: «Москва Тверская-Ямская» — в Москве четыре Тверских-Ямских улицы.

Да

Код пригодности к рассылке qc_complete

Годится ли адрес для доставки корреспонденции:

Код qc_complete

Подходит для рассылки?

Описание

0

Да

Пригоден для почтовой рассылки

10

Под вопросом

Дома нет в ФИАС

5

Под вопросом

Нет квартиры. Подходит для юридических лиц или частных владений

8

Под вопросом

До почтового отделения — абонентский ящик или адрес до востребования. Подходит для писем, но не для курьерской доставки.

9

Под вопросом

Сначала проверьте, правильно ли Дадата разобрала исходный адрес

1

Нет

Нет региона

2

Нет

Нет города

3

Нет

Нет улицы

4

Нет

Нет дома

6

Нет

Адрес неполный

7

Нет

Иностранный адрес

Признак наличия дома в ФИАС qc_house и код точности координат qc_geo

Уточняют вероятность успешной доставки письма:

Код qc_house

Код qc_geo

Вероятность доставки

Описание

2

любой

Высокая

Дом найден в ФИАС

10

0

Высокая

Дом не найден в ФИАС, но есть на картах

10

1

Средняя

Дом не найден в ФИАС, но есть похожий на картах

10

≥ 2

Низкая

Дом не найден в ФИАС и на картах

Код точности координат qc_geo

Точность координат адреса для курьерской доставки:

Код qc_geo

Описание

0

Точные координаты

1

Ближайший дом

2

Улица

3

Населенный пункт

4

Город

5

Координаты не определены

Коды ответа на запрос

HTTP-код ответа

Описание

200

Запрос успешно обработан

400

Некорректный запрос

401

В запросе отсутствует API-ключ или секретный ключ, либо в запросе указан несуществующий ключ

403

Не подтверждена почта Или недостаточно средств для обработки запроса, пополните баланс

405

Запрос сделан с методом, отличным от POST

429

Слишком много запросов в секунду или новых соединений в минуту

5xx

Произошла внутренняя ошибка сервиса