Guid по фиас как найти

Время на прочтение
7 мин

Количество просмотров 99K

Как вы думаете, какой государственный орган наиболее заинтересован в том, чтобы вы получали от него письма? Правильно! Налоговая. Поэтому ФНС России много лет разрабатывает и поддерживает ведомственные общероссийские классификаторы адресов. И так как более полных справочников нет, их стали использовать повсеместно.

Сначала был КЛАДР, и было в нем 6 уровней:

С 2012 года в эксплуатацию ввели новый классификатор — ФИАС. Про основные отличия мы писали три года назад в статье «ФИАС или КЛАДР: выбираем справочник адресов». В ФНС к разработке нового классификатора подошли основательнее и постарались учесть все

грабли

минусы КЛАДР. Из интересного добавили дату начала и окончания записи, ввели фиксированный ID для каждого дома (предполагается, что он не будет меняться).

До сих пор продолжают обновляться оба классификатора, но поддерживать совместимость становится сложнее. В прошлом году в ФИАС начали добавлять новые уровни. Например, планировочные структуры — это всякие дачные товарищества и микрорайоны, в классификаторе их уже больше 81 000. В конечном итоге в ФНС приняли логичное решение прекратить поддержку КЛАДР и удалить его в конце 2017 года.

Шаг 2. Ищем код КЛАДР в поле PlainCode. Если нашлась одна запись, то сохраняем значение поля AoGuid и пропускаем следующий пункт. Но по нашему коду 770000000001519 находится три записи, нужна дополнительная проверка.

Шаг 3. Находим актуальную запись. Значение поля CurrStatus = 0 означает, что запись актуальна. Выбираем ее и сохраняем значение поля AoGuid. Идентификационный код ФИАС найден!

Если адреса у вас хранятся одной строкой, вроде этой:
г Москва, улица Большая Коммунистическая, дом 3, то поздравляем, это самая интересная задача. Нужно писать свой адресный парсер, который будет разделять строку в формате КЛАДР на части, искать каждый ее компонент в ФИАС с учетом опечаток, сокращений, исторических названий и определять по ним ФИАС-код. Легче это сделать уже готовым адресным парсером. Как выбрать алгоритм для адресного фильтра, мы рассказывали раньше.

Шаг 1. Берем название региона и ищем его в поле FormalName таблицы ADDROBJ.

FormalName = Москва →
AoGuid = 0c5b2444-70a0-4932-980c-b4dc0d3f02b5

Шаг 2. Идем дальше по уровням вниз и ищем по FormalName с фиксированным родителем — найденным AoGuid на предыдущем шаге. В нашем случае уровни «город» и «населенный пункт» пустые, а следующий непустой уровень — улица.

ParentGuid = 0c5b2444-70a0-4932-980c-b4dc0d3f02b5,
FormalName = Коммунистическая Б. → AoGuid=f77948dc-7bc8-42cb-979e-2c958d162d63

Шаг 3. Если дошли до улицы, то можно найти и дом. Для этого в таблице HOUSE ищем номер дома с фиксированным AoGuid улицы. ФИАС не полон домами, поэтому не расстраивайтесь, если нужный номер не найдется.

AoGuid = f77948dc-7bc8-42cb-979e-2c958d162d63,
дом номер 3 →
HouseGuid = bce8be1f-f2f7-4cce-836e-08daac0b931e

Общая информация

В базе у каждого объекта есть два ГУИДа:

• уникальный ГУИД, это первичный ключ.
• ФИАС ГУИД, который соответсвует реальному объекту.

По одному ФИАС ГУИДу может быть несколько записей, каждый со своим ключом, но актуальной (с флагом актуальности) будет только одна. По возможности берется актуальная.

Все функции API находятся в /api/address/.

Пример использования

Попробуем найти некоторый адрес с помощью этого сервиса.

Сначала получим список всех корневых узлов (по хорошему это должны быть области и автономные округа, города федерального значения):

/api/address/FindAddress?searchString=&level=&count=&parentGuid=

Результат:

[{
		"fiasGuid": "db9c4f8b-b706-40e2-b2b4-d31b98dcd3d1",
		"formalName": "Красноярский",
		"shortName": "край"

        ...
        ...
        ...

		"fiasGuid": "6f2cbfd8-692a-4ee4-9b16-067210bde3fc",
		"formalName": "Башкортостан",
		"shortName": "Респ"
	}, {
		"fiasGuid": "d8327a56-80de-4df2-815c-4f6ab1224c50",
		"formalName": "Адыгея",
		"shortName": "Респ"
	}
]

Попробуем найти Калужскую область:

/api/address/FindAddress?searchString=Калуж&level=&count=&parentGuid=

                [{"fiasGuid":"18133adf-90c2-438e-88c4-62c41656de70","formalName":"Калужская","shortName":"обл"}]

Дочерние объекты Калужской области содержащие “кир”:

/api/address/FindAddress?searchString=кир&level=&count=&parentGuid=b502ae45-897e-4b6f-9776-6ff49740b537

[{
		"fiasGuid": "aafd4756-144b-451a-a3a7-93605cf77e98",
		"formalName": "Кирпичный",
		"shortName": "пер"
	}, {
		"fiasGuid": "239b8705-0b53-4a98-8eb2-346814382422",
		"formalName": "Кирова",
		"shortName": "ул"
	}, {
		"fiasGuid": "daec73dd-a5b5-44dc-a13f-dbe14039730f",
		"formalName": "Кирова",
		"shortName": "пер"
	}, {
		"fiasGuid": "0a5c14f1-c169-49f0-9066-02ddebb532e2",
		"formalName": "Кирпичная",
		"shortName": "ул"
	}, {
		"fiasGuid": "346d7e07-cd5d-44cf-ae77-2133f5e4ecae",
		"formalName": "Белокирпичная",
		"shortName": "ул"
	}, {
		"fiasGuid": "68ea7d9f-4c6c-4e85-8263-346f6c6a2d2e",
		"formalName": "Азаровский Кирпичный Завод",
		"shortName": "п"
	}, {
		"fiasGuid": "22a9f7f2-645d-430d-a086-64998b499c6f",
		"formalName": "Кирпичный з-д МПС",
		"shortName": "ул"
	}
]

Дочерние объекты Калуги начинающиесе на “ки”:

/api/address/FindAddress?searchString=ки&level=&count=&parentGuid=b502ae45-897e-4b6f-9776-6ff49740b537

[{
		"fiasGuid": "aafd4756-144b-451a-a3a7-93605cf77e98",
		"formalName": "Кирпичный",
		"shortName": "пер"
	}, {
		"fiasGuid": "cac18222-b5dc-4510-a405-8312db6e1e9b",
		"formalName": "Киевский",
		"shortName": "пер"
	}, {
		"fiasGuid": "239b8705-0b53-4a98-8eb2-346814382422",
		"formalName": "Кирова",
		"shortName": "ул"
	}, {
		"fiasGuid": "9d89f22c-41e3-45e9-af9c-4b6b0b6ebf90",
		"formalName": "Киевский",
		"shortName": "проезд"
	}, {
		"fiasGuid": "2f873a18-bead-4258-aab8-1ab52376d28b",
		"formalName": "Кибальчича",
		"shortName": "ул"
	}, {
		"fiasGuid": "daec73dd-a5b5-44dc-a13f-dbe14039730f",
		"formalName": "Кирова",
		"shortName": "пер"
	}, {
		"fiasGuid": "0a5c14f1-c169-49f0-9066-02ddebb532e2",
		"formalName": "Кирпичная",
		"shortName": "ул"
	}, {
		"fiasGuid": "06e6b466-6c3e-476b-9b11-8fd479191c76",
		"formalName": "Киевка 2-я",
		"shortName": "ул"
	}, {
		"fiasGuid": "ba9a0d0b-c92d-44f0-a0a9-dd46407e58cf",
		"formalName": "Киевка",
		"shortName": "ул"
	}, {
		"fiasGuid": "0a634c94-349c-40f7-9e63-0ee970730caf",
		"formalName": "Киевская",
		"shortName": "ул"
	}, {
		"fiasGuid": "22a9f7f2-645d-430d-a086-64998b499c6f",
		"formalName": "Кирпичный з-д МПС",
		"shortName": "ул"
	}
]

Теперь соберем полный адрес для ул.Кирова (этот запрос довольно долгий, поскольку приходится идти по цепочке и каждый раз обращаться к базе):

/api/address/GetAddressByFiasGuid?guid=239b8705-0b53-4a98-8eb2-346814382422

{
	"representation": "Калужская обл, Калуга г, Кирова ул",
	"fiasGuid": "239b8705-0b53-4a98-8eb2-346814382422",
	"fiaslevel": 7,
	"region": {
		"fiasGuid": "18133adf-90c2-438e-88c4-62c41656de70",
		"formalName": "Калужская",
		"shortName": "обл"
	},
	"area": {},
	"city": {
		"fiasGuid": "b502ae45-897e-4b6f-9776-6ff49740b537",
		"formalName": "Калуга",
		"shortName": "г"
	},
	"intraurbanTerritory": {},
	"place": {},
	"street": {
		"fiasGuid": "239b8705-0b53-4a98-8eb2-346814382422",
		"formalName": "Кирова",
		"shortName": "ул"
	},
	"unparsed": []
}

То же самое в XML. На самом деле формат ответа – JSON. Приходит строка – представление адреса в XML. (кавычки в ней будут экранированы, см. пример ответа в описании метода):

/api/address/FindAddress?searchString=ки&level=&count=&parentGuid=b502ae45-897e-4b6f-9776-6ff49740b537

<АдресРФ>
    <ИдФиас>239b8705-0b53-4a98-8eb2-346814382422</ИдФиас>
    <СубъектРФ>Калужская обл</СубъектРФ>
    <Город>Калуга г</Город>
    <Улица>Кирова ул</Улица>
    <ОКТМО>29701000</ОКТМО>
    <ОКАТО>29401000000</ОКАТО>
</АдресРФ>

AddressResult

AddressItem

AddressPart

AddressObjectResult

AddressObject

AddressInfoResult

AddressInfo

HouseResult

HouseItem

SteadResult

SteadItem

RoomResult

RoomItem