Обработка адресов через API в формате ФИАС

Для обеспечения совместимости со справочником ФИАС в некоторые ответы сервиса были внесены изменения. Некоторые элементы, использующиеся для работы с КЛАДР, были упразднены, а вместо них были добавлены новые. Всё это касается только команд, в рамках которых выполняется обработка почтовых адресов.

Стандартизованный адрес по ФИАС в формате JSON

1. Во всех JSON-объектах, соответствующих полям адреса в массиве адресных полей fields, значение элемента c теперь записывается без префиксных нулей. Например, ранее для поля региона сервис возвращал "c": "01". В новой версии для этого поля это же значение выводится в следующем виде "c": "1". В новой версии сервиса могут встречаться адресные объекты, для которых это значение может превышать 9999.
2. В JSON-объекте, соответствующем номеру дома в рамках массива адресных полей fields, элемент c теперь может принимать только одно значение – 1. Это происходит, если номер дома удалось найти в ФИАС. В противном случае, как и в предыдущей версии, элемент не выводится.
3. Количество адресных полей в JSON-массиве fields увеличилось на один. Между полями Place и Street добавлено поле Site. Это поле соответствует объектам типа территория. В ФИАС они также называются планировочные структуры. На данный момент это поле заполняется данными о садовых товариществах, гаражных кооперативах, промышленных зонах и других территориях схожего типа.
4. В JSON-объекте codes элемент kladr_actual переименован в kladr_actual_code. Назначение элемента осталось прежним.
5. В JSON-объекте codes элемент kladr_detected упразднён, он больше не формируется и не выводится.
6. В JSON-объекте codes добавлен элемент fias_actual_code. С помощью этого элемента сервис возвращает классификационный иерархический код актуальной версии адреса по ФИАС.
7. В JSON-объекте codes добавлено два служебных элемента abr_actual_code и abr_detected_code. С помощью этих элементов сервис возвращает иерархические коды актуальной и устаревшей версии обработанного адреса по внутреннему АБР-классификатору адресов сервиса.
8. Также следует учесть остальные изменения, описанные для режима совместимости с КЛАДР здесь.

Стандартизованный адрес по ФИАС в формате XML

1. В XML-элементах Field, соответствующих полям адреса в рамках стандартизованного адреса Address, значение атрибута c теперь записывается без префиксных нулей. Например, ранее для поля региона сервис возвращал c="01". В новой версии для этого поля это же значение выводится в следующем виде c="1". В новой версии сервиса могут встречаться адресные объекты, для которых это значение может превышать 9999.
2. В XML-элементе Field, соответствующем полю с номером дома, атрибут c теперь может принимать только одно значение – 1. Это происходит, если номер дома удалось найти в КЛАДР/ФИАС. В противном случае, как и в предыдущей версии сервиса, атрибут не выводится. Раньше в этот атрибут выводился код дома, который ему был присвоен внутренним хранилищем сервиса.
3. Количество адресных полей и соответствующих им XML-элементов Field увеличилось на один в рамках стандартизованного почтового адреса. Между полями с уровнями level="Place" и level="Street" добавлено поле с уровнем level="Site". Это поле соответствует объектам типа территория. В ФИАС они также называются планировочные структуры. На данный момент это поле заполняется данными о садовых товариществах, гаражных кооперативах, промышленных зонах и других территориях схожего типа.
4. В XML-элементе FIAS добавлен атрибут code, с помощью которого сервис возвращает иерархический код актуальной версии адреса по классификатору ФИАС.
5. В XML-элементе Codes добавлен новый дочерний элемент ABR. С помощью атрибутов actual и detected этого элемента сервис возвращает иерархические коды актуальной и устаревшей версии обработанного адреса по внутреннему АБР-классификатору адресов сервиса.
6. Также следует учесть остальные изменения, описанные для режима совместимости с КЛАДР здесь.