h2. Как это работает
Дома не обязательно заводить сначала в [справочнике|CarbonBilling:Дома] - Вы можете содать дом при заведении абонента или из карточки уже существующего.
h3. Поиск адреса по справочнику
Наберите адрес в удобном формате и выберите нужный из предложенных вариантов.
!addr_parse.png|border=0,width=400! \\ \\
h3. Запрос можно исправить
Если ошиблись или нужно дополнить запрос:
# Нажмите на поле выбора адреса \\ \\
!addr_parse_edit_click.png|border=0,width=300! \\ \\
# Отредактируйте ранее заведенные данные\\ \\
!addr_parse_edit.png|border=0,width=292!
h2. Технические детали
Существует два справочника, используемых для подстановки адреса: ФИАС и [локальный справочник "Дома"|CarbonBilling:Дома]
h3. Сначала ищем по ФИАС
При создании нового дома, если он есть в ФИАС, но отсутствует в локальном справочнике, в локальный попадает копия. Это позволяет не хранить адресную баз всей России на локальном сервере (около 100Гб).
Чтобы не завести дом из ФИАС в локальном справочник несколько раз, по ФИАС ID проверяется, есть этот дом в локальном справочнике или нет.
h3. Если адреса почему-то нет в ФИАС
Допускаем такую возможность, поэтому в первую очередь поиск идет в ФИАС, но если запрос к нему не дал результатов, то поиск повторяется по локальному справочнику.
h3. Ищем улицы только в своих городах
При запросе к ФИАС поиск происходит только по списку населённых пунктов уже заведенных в локальном справочнике. Таким образом можно заводить адрес ведя только улицу в регионах предоставления услуг и не получить в выводе Москву, если Вы работаете, например, во Владивостоке.
h3. Подключаем новый город
Если в поиск ввести и улицу и город, то поиск в ФИАС будет по выбранному городу.
h3. Отфильтруем результат поиска домов
В форме выводятся только строения. Добавить абоненту в качестве адреса город и улицу, без строения, не получится.
h3. Результатов может быть много, выводим первые пять
Вне зависимости от количества результатов в любом из справочников, выводим только 5 первых строк. Если адреса все равно нет, попробуйте уточнить запрос - добавить уточнения вроде "село" или "район" (район субъекта федерации, условно говоря области, а не города) или префикс к дому.
h3. Какие данные получаем из ФИАС в локальный справочник
Регион, Область, Город, Улица, Дом, Блок, Индекс, ОКАТО, kladr_id (уникальный ID строения/улицы/прочих объектов в справочнике)
Дома не обязательно заводить сначала в [справочнике|CarbonBilling:Дома] - Вы можете содать дом при заведении абонента или из карточки уже существующего.
h3. Поиск адреса по справочнику
Наберите адрес в удобном формате и выберите нужный из предложенных вариантов.
!addr_parse.png|border=0,width=400! \\ \\
h3. Запрос можно исправить
Если ошиблись или нужно дополнить запрос:
# Нажмите на поле выбора адреса \\ \\
!addr_parse_edit_click.png|border=0,width=300! \\ \\
# Отредактируйте ранее заведенные данные\\ \\
!addr_parse_edit.png|border=0,width=292!
h2. Технические детали
Существует два справочника, используемых для подстановки адреса: ФИАС и [локальный справочник "Дома"|CarbonBilling:Дома]
h3. Сначала ищем по ФИАС
При создании нового дома, если он есть в ФИАС, но отсутствует в локальном справочнике, в локальный попадает копия. Это позволяет не хранить адресную баз всей России на локальном сервере (около 100Гб).
Чтобы не завести дом из ФИАС в локальном справочник несколько раз, по ФИАС ID проверяется, есть этот дом в локальном справочнике или нет.
h3. Если адреса почему-то нет в ФИАС
Допускаем такую возможность, поэтому в первую очередь поиск идет в ФИАС, но если запрос к нему не дал результатов, то поиск повторяется по локальному справочнику.
h3. Ищем улицы только в своих городах
При запросе к ФИАС поиск происходит только по списку населённых пунктов уже заведенных в локальном справочнике. Таким образом можно заводить адрес ведя только улицу в регионах предоставления услуг и не получить в выводе Москву, если Вы работаете, например, во Владивостоке.
h3. Подключаем новый город
Если в поиск ввести и улицу и город, то поиск в ФИАС будет по выбранному городу.
h3. Отфильтруем результат поиска домов
В форме выводятся только строения. Добавить абоненту в качестве адреса город и улицу, без строения, не получится.
h3. Результатов может быть много, выводим первые пять
Вне зависимости от количества результатов в любом из справочников, выводим только 5 первых строк. Если адреса все равно нет, попробуйте уточнить запрос - добавить уточнения вроде "село" или "район" (район субъекта федерации, условно говоря области, а не города) или префикс к дому.
h3. Какие данные получаем из ФИАС в локальный справочник
Регион, Область, Город, Улица, Дом, Блок, Индекс, ОКАТО, kladr_id (уникальный ID строения/улицы/прочих объектов в справочнике)