Как это работает
Дома не обязательно заводить сначала в справочнике - Вы можете содать дом при заведении абонента или из карточки уже существующего.
Поиск адреса по справочнику
Наберите адрес в удобном формате и выберите нужный из предложенных вариантов.
Запрос можно исправить
Если ошиблись или нужно дополнить запрос:
- Нажмите на поле выбора адреса
- Отредактируйте ранее заведенные данные
Технические детали
Существует два справочника, используемых для подстановки адреса: ФИАС и локальный справочник "Дома"
Сначала ищем по ФИАС
При создании нового дома, если он есть в ФИАС, но отсутствует в локальном справочнике, в локальный попадает копия. Это позволяет не хранить адресную баз всей России на локальном сервере (около 100Гб) и заводить дома синхронизированными с общероссийской базой адресов.
Чтобы не завести дом из ФИАС в локальном справочник несколько раз, по ФИАС ID проверяется, есть этот дом в локальном справочнике или нет.
Если адреса почему-то нет в ФИАС
Допускаем такую возможность, поэтому в первую очередь поиск идет в ФИАС, но если запрос к нему не дал результатов, то поиск повторяется по локальному справочнику.
Ищем улицы только в своих городах
При запросе к ФИАС поиск происходит только по списку населённых пунктов уже заведенных в локальном справочнике. Таким образом можно заводить адрес ведя только улицу в регионах предоставления услуг и не получить в выводе Москву, если Вы работаете, например, во Владивостоке.
Подключаем новый город
Если в поиск ввести и улицу и город, то поиск в ФИАС будет по выбранному городу.
Отфильтруем результат поиска домов
В форме выводятся только строения. Добавить абоненту в качестве адреса город и улицу, без строения, не получится.
Результатов может быть много, выводим первые пять
Вне зависимости от количества результатов в любом из справочников, выводим только 5 первых строк. Если адреса все равно нет, попробуйте уточнить запрос - добавить уточнения вроде "село" или "район" (район субъекта федерации, условно говоря области, а не города) или префикс к дому.
Какие данные получаем из ФИАС в локальный справочник
Регион, Область, Город, Улица, Дом, Блок, Индекс, ОКАТО, kladr_id (уникальный ID строения/улицы/прочих объектов в справочнике)
В справочнике уже есть дома, но заводили сами без ФИАС
Установите в доме [опцию "Синхронизировать с КЛАДР(ФИАС)"], данные подгрузятся.
Если домов много, это можно сделать с помощью API REST v2.0