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

Описание

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

Только для России!
В настоящее время установлено ограничение на количество направляемых запросов, равное 100 запросов в минуту и 10 000 запросов в день.

API

Методы описаны в Swagger

Для стандартизации используется SearchAddressItems.

Пример запроса
https://fias-public-service.nalog.ru/api/spas/v2.0/SearchAddressItems?search_string=уфа&address_type=2

Переменные запроса

Название

Тип

Описание

search_string

Строка

Произвольная строка, содержащая адрес

address_type

Число

Вид представления адреса:

  • 1 - административное деление

  • 2 - муниципальное деление

Переменные, возвращаемые сервисом

Название

Тип

Описание

addresses

Массив AddressItem

Найденный адресный элемент
Доступ к сервису осуществляется с помощью указания токена в header-е запроса master-token

Как вызвать

GarStandardizationAddressApi client = apiClientFactory.getClient(GarStandardizationAddressApi.class);
AddressResponse response = client.getAddresses("уфа октября 1", 1);
Ответ
{
  "addresses": [
    {
      "object_id": 94471755,
      "object_level_id": 9,
      "operation_type_id": 10,
      "object_guid": "125451ff-33b7-4829-9245-3c5fa1b9d8ec",
      "address_type": 1,
      "full_name": "Республика Башкортостан, город Уфа, проспект Октября, земельный участок 1",
      "region_code": 2,
      "is_active": true,
      "path": "5705.6326.8528.94471755",
      "address_details": {
        "postal_code": "450001",
        "ifns_ul": "0278",
        "ifns_fl": "0278",
        "ifns_tul": null,
        "ifns_tfl": null,
        "okato": "80401390000",
        "oktmo": "80701000001",
        "kladr_code": null,
        "cadastral_number": "02:55:010505:219",
        "apart_building": null,
        "remove_cadastr": null,
        "oktmo_budget": "80701000"
      },
      "successor_ref": null,
      "hierarchy": [
        {
          "object_type": "region",
          "region_code": 2,
          "name": "Башкортостан",
          "type_name": "Республика",
          "type_short_name": "Респ",
          "type_form_code": 0,
          "object_id": 5705,
          "object_level_id": 1,
          "object_guid": "6f2cbfd8-692a-4ee4-9b16-067210bde3fc",
          "full_name": "Республика Башкортостан",
          "full_name_short": "Республика Башкортостан"
        },
        {
          "object_type": "address_object",
          "name": "Уфа",
          "type_name": "Город",
          "type_short_name": "г",
          "type_form_code": 0,
          "object_id": 6326,
          "object_level_id": 5,
          "object_guid": "7339e834-2cb4-4734-a4c7-1fca2c66e562",
          "full_name": "город Уфа",
          "full_name_short": "г Уфа"
        },
        {
          "object_type": "address_object",
          "name": "Октября",
          "type_name": "Проспект",
          "type_short_name": "пр-кт",
          "type_form_code": 0,
          "object_id": 8528,
          "object_level_id": 8,
          "object_guid": "8dade0a4-ac2a-4884-a854-762ab0abbdca",
          "full_name": "проспект Октября",
          "full_name_short": "пр-кт Октября"
        },
        {
          "object_type": "stead",
          "number": "1",
          "type_name": "Земельный участок",
          "type_short_name": "з/у",
          "object_id": 94471755,
          "object_level_id": 9,
          "object_guid": "125451ff-33b7-4829-9245-3c5fa1b9d8ec",
          "full_name": "земельный участок 1",
          "full_name_short": "з/у 1"
        }
      ]
    },
    {
      "object_id": 40609666,
      "object_level_id": 10,
      "operation_type_id": 10,
      "object_guid": "4513029f-d8fe-41d8-928b-a401aeac48b4",
      "address_type": 1,
      "full_name": "Республика Башкортостан, город Уфа, проспект Октября, дом 1",
      "region_code": 2,
      "is_active": true,
      "path": "5705.6326.8528.40609666",
      "address_details": {
        "postal_code": "450001",
        "ifns_ul": "0278",
        "ifns_fl": "0278",
        "ifns_tul": null,
        "ifns_tfl": null,
        "okato": "80401390000",
        "oktmo": "80701000001",
        "kladr_code": null,
        "cadastral_number": "02:55:010505:100",
        "apart_building": null,
        "remove_cadastr": null,
        "oktmo_budget": "80701000"
      },
      "successor_ref": null,
      "hierarchy": [
        {
          "object_type": "region",
          "region_code": 2,
          "name": "Башкортостан",
          "type_name": "Республика",
          "type_short_name": "Респ",
          "type_form_code": 0,
          "object_id": 5705,
          "object_level_id": 1,
          "object_guid": "6f2cbfd8-692a-4ee4-9b16-067210bde3fc",
          "full_name": "Республика Башкортостан",
          "full_name_short": "Республика Башкортостан"
        },
        {
          "object_type": "address_object",
          "name": "Уфа",
          "type_name": "Город",
          "type_short_name": "г",
          "type_form_code": 0,
          "object_id": 6326,
          "object_level_id": 5,
          "object_guid": "7339e834-2cb4-4734-a4c7-1fca2c66e562",
          "full_name": "город Уфа",
          "full_name_short": "г Уфа"
        },
        {
          "object_type": "address_object",
          "name": "Октября",
          "type_name": "Проспект",
          "type_short_name": "пр-кт",
          "type_form_code": 0,
          "object_id": 8528,
          "object_level_id": 8,
          "object_guid": "8dade0a4-ac2a-4884-a854-762ab0abbdca",
          "full_name": "проспект Октября",
          "full_name_short": "пр-кт Октября"
        },
        {
          "object_type": "house",
          "add_number1": "",
          "add_type1_name": "",
          "add_type1_short_name": "",
          "add_number2": "",
          "add_type2_name": "",
          "add_type2_short_name": "",
          "number": "1",
          "type_name": "Дом",
          "type_short_name": "д.",
          "object_id": 40609666,
          "object_level_id": 10,
          "object_guid": "4513029f-d8fe-41d8-928b-a401aeac48b4",
          "full_name": "дом 1",
          "full_name_short": "д. 1"
        }
      ]
    },
    ...
  ]
}

AddressItem

Название Тип Описание

object_id

Число

Идентификатор объекта

object_level_id

Число

Уровень объекта

object_guid

Строка

Уникальный идентификатор ФИАС

address_type

Число

Вид представления адреса:

  • 1 - административное деление

  • 2 - муниципальное деление

full_name

Строка

Полное наименование объекта

region_code

Число

Код региона

is_active

Логическое

Признак действующего адресного элемента

path

Строка

Материализованный путь

address_details

Класс AddressDetails

Расширенная информация по адресному объекту

hierarchy

Массив AddressPart

Массив элементов адреса

AddressDetails

Название Тип Описание

postal_code

Строка

Почтовый индекс

ifns_ul

Строка

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

ifns_fl

Строка

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

ifns_tul

Строка

Код ИФНС территориального участка для юридических лиц

ifns_tfl

Строка

Код ИФНС территориального участка для физических лиц

okato

Строка

Код ОКАТО

oktmo

Строка

Код ОКТМО

kladr_code

Строка

Код КЛАДР

cadastral_number

Строка

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

AddressPart

Название Тип Описание

object_id

Число

Идентификатор объекта

object_level_id

Число

Уровень объекта

object_guid

Строка

Уникальный идентификатор ФИАС

object_type

Строка

Тип объекта