КЛАДР в облаке

Простой и удобный сервиc для работы с базой адресов

1С-Битрикс


Описание (модуль устарел)

Модуль 1С-Битрикс предоставляющий форму для ввода адреса с автодополнением. В качестве источника данных используется сервис «КЛАДР в облаке»

Установка

  • Загрузите модуль
  • Скопируйте в папку «/bitrix/modules» вашего сайта
  • Переименуйте модуль в primepixkladr
  • Установите модуль
  • Разместите компонент «Форма для ввода адреса» на странице для ввода адреса
  • В настройках компонента укажите токен и ключ для подключения к сервису «КЛАДР в облаке»

Параметры компонента «Форма для ввода адреса»

  • Основные параметры
    • Токен для доступа к КЛАДР API - токен для доступа к сервису
    • Ключ для доступа к КЛАДР API - ключ для доступа к сервису

  • Выводить поля для ввода
    • Области – Добавляет поле с именем «region» для ввода названия области
    • Района – Добавляет поле с именем «district» для ввода названия района
    • Населённого пункта – Добавляет поле c именем «location» для ввода названия населённого пункта
    • Улицы – Добавляет поле c именем «street» для ввода названия улицы
    • Дома – Добавляет поле с именем «building» для ввода номера дома

  • Выводить скрытые поля
    • Код объекта – добавляет скрытое поле с именем «kladr_id», в которое по окончанию ввода адреса будет записан его код
    • Почтовый индекс – добавляет скрытое поле с именем «zip_code» в которое по окончанию ввода адреса будет записан его почтовый индекс из КЛАДР
    • Подписи – добавляет скрытое поле с постфиксом «_label» к каждому полю ввода в которое будет записана подпись к введённому пользователем значению (например: город, посёлок, село)
    • Сокращения подписей – добавляет скрытое поле к постфиксом «_label_min» к каждому полю ввода, в которое будет записано сокращение подписи к введённому пользователем значению (г., пос., с.)

  • Опции
    • Обновлять подписи при вводе – Включает обновление подписей к полям ввода. Например, если пользователь в поле город введёт «Москва», то подпись «Населённый пункт» автоматически будет изменена на «Город»
    • Удалять значения, которых нет в КЛАДР – Включает проверку ввода в поля адреса и удаление ошибочно введённых значений. Например, если пользователь введёт в поле «Населённый пункт» значение «Мухосранск», то оно будет автоматически удалено, т.к. населённого пункта «Мухосранск» в России нет.

  • Дополнительные параметры
    • Подключить jQuery – Компонент использует библиотеку jQuery, поэтому если она не используется у вас на сайте включите данный пункт
    • Подключить jQuery UI – Компонент использует библиотеку jQuery UI, поэтому если она не используется у вас на сайте включите данный пункт
    • Подключить тему jQuery UI – Компонент использует тему jQuery UI для автодополнения адреса. Если она не используется у вас на сайте включите данный пункт

Результат

Компонент выводит на сайт несколько текстовых и скрытых полей для ввода адреса. Компонент не генерирует формы (<form></form>) для отправки на сервер введённой пользователем информации! Это сделано для того чтобы вы без проблем могли включить поля для ввода адреса в любую другую существующую форму на вашем сайте (к примеру форму оформления заказа).