Page tree
Skip to end of metadata
Go to start of metadata
<input id="address" name="address" type="text" />
<link href="http://ВАШ_СЕРВЕР:ПОРТ/suggestions/libs/jquery.suggestions/stable/css/suggestions.css" type="text/css" rel="stylesheet" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
<script src="http://ВАШ_СЕРВЕР:ПОРТ/suggestions/libs/jquery.suggestions/stable/js/jquery.suggestions.js"></script>
<script>
    $("#address").suggestions({
        serviceUrl: "http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs",
        type: "ADDRESS",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>
<input id="address" name="address" type="text" />
<link href="http://ВАШ_СЕРВЕР:ПОРТ/suggestions/libs/jquery.suggestions/master/css/suggestions.css" type="text/css" rel="stylesheet" />
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
<script type="text/javascript" src="http://ВАШ_СЕРВЕР:ПОРТ/suggestions/libs/jquery.suggestions/master/js/jquery.suggestions.js"></script>
<script type="text/javascript">
    $("#address").suggestions({
        serviceUrl: "http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs",
        type: "ADDRESS",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>

Аргумент  suggestion  функции  onSelect  выглядит так:

ПолеТип данныхОписание
valuestring(1000)Короткий адрес одной строкой
unrestricted_valuestring(1000)Длинный адрес одной строкой
data.postal_codestring(10)Индекс
data.countrystring(150)Страна
data.country_iso_codestring(10)Двухсимвольный код страны ISO 3166 (19.7+)
data.federal_districtstring(50)Федеральный округ (19.5+)
data.region_fias_idstring(50)Код ФИАС региона (либо код OSM, начиная с версии 20.7)
data.region_kladr_idstring(20)Код КЛАДР региона
data.region_iso_codestring(10)Код региона ISO 3166 (19.7+)
data.region_with_typestring(150)Регион с типом
data.region_typestring(10)Тип региона (сокращенный)
data.region_type_fullstring(50)Тип региона
data.regionstring(150)Регион
data.area_fias_idstring(50)Код ФИАС района в регионе (либо код OSM, начиная с версии 20.7)
data.area_kladr_idstring(20)Код КЛАДР района в регионе
data.area_with_typestring(150)Район в регионе с типом
data.area_typestring(10)Тип района в регионе (сокращенный)
data.area_type_fullstring(50)Тип района в регионе
data.areastring(150)Район в регионе
data.city_fias_idstring(50)Код ФИАС города (либо код OSM, начиная с версии 20.7)
data.city_kladr_idstring(20)Код КЛАДР города
data.city_with_typestring(150)Город с типом
data.city_typestring(10)Тип города (сокращенный)
data.city_type_fullstring(50)Тип города
data.citystring(150)Город
data.city_district_fias_idstring(50)Код ФИАС района города (либо код OSM, начиная с версии 20.7)
data.city_district_kladr_idstring(20)Код КЛАДР района города
data.city_district_with_typestring(150)Район города с типом
data.city_district_typestring(10)Тип района города (сокращенный)
data.city_district_type_fullstring(50)Тип района города
data.city_districtstring(150)Район города
data.settlement_fias_idstring(50)Код ФИАС нас. пункта (либо код OSM, начиная с версии 20.7)
data.settlement_kladr_idstring(20)Код КЛАДР нас. пункта
data.settlement_with_typestring(150)Населенный пункт с типом
data.settlement_typestring(10)Тип населенного пункта (сокращенный)
data.settlement_type_fullstring(50)Тип населенного пункта
data.settlementstring(150)Населенный пункт
data.street_fias_idstring(50)Код ФИАС улицы (либо код OSM, начиная с версии 20.7)
data.street_kladr_idstring(20)Код КЛАДР улицы
data.street_with_typestring(150)Улица с типом
data.street_typestring(10)Тип улицы (сокращенный)
data.street_type_fullstring(50)Тип улицы
data.streetstring(150)Улица
data.house_fias_idstring(50)Код ФИАС дома (либо код OSM, начиная с версии 20.7)
data.house_kladr_idstring(20)Код КЛАДР дома
data.house_typestring(10)Тип дома (сокращенный)
data.house_type_fullstring(50)Тип дома
data.housestring(50)Дом
data.block_typestring(10)Тип корпуса/строения (сокращенный)
data.block_type_fullstring(50)Тип корпуса/строения
data.blockstring(50)Корпус/строение
data.flat_fias_idstring(50)Код ФИАС квартиры ( 20.10+)
data.flat_typestring(10)Тип квартиры (сокращенный)
data.flat_type_fullstring(50)Тип квартиры
data.flatstring(50)Квартира
data.postal_boxstring(50)Абонентский ящик
data.fias_idstring(50)

Код ФИАС:

  • ROOM.ROOMGUID, если квартира найдена в ФИАС по точному совпадению (начиная с версии 21.4);
  • HOUSE.HOUSEGUID, если найден только дом в ФИАС по точному совпадению;
  • ADDROBJ.AOGUID в противном случае.

Либо код OSM (начиная с версии 20.7)

data.fias_levelstring(10)Уровень детализации, до которого адрес найден в ФИАС:
  • 0 — страна
  • 1 — регион
  • 3 — район
  • 4 — город
  • 5 — район города
  • 6 — населенный пункт
  • 7 — улица
  • 8 — дом
  • 9 — квартира (начиная с версии 21.4)
  • 65 — планировочная структура
  • -1 — иностранный или пустой.
data.kladr_idstring(20)Код КЛАДР
data.geoname_idstring(20)Идентификатор объекта в международной базе GeoNames. Для российских адресов не заполняется.
data.capital_markerstring(10)Признак центра района или региона:
  • 1 — центр района (Московская обл, Одинцовский р-н, г Одинцово)
  • 2 — центр региона (Новосибирская обл, г Новосибирск)
  • 3 — центр района и региона (Томская обл, г Томск)
  • 4 — центральный район региона (Тюменская обл, Тюменский р-н)
  • 0 — ничего из перечисленного (Московская обл, г Балашиха)
data.okatostring(20)Код ОКАТО
data.oktmostring(20)Код ОКТМО
data.tax_officestring(10)Код ИФНС для физических лиц
data.tax_office_legalstring(10)Код ИФНС для организаций
data.sourcestring(250)

Для организаций — адрес как в ЕГРЮЛ.
Для банков — адрес как в справочнике БИК.
В остальных случаях — пустое.

data.history_values[ ]string[](250)

Список исторических названий объекта нижнего уровня.
Если подсказка до улицы — это прошлые названия этой улицы, если до города — города.

Дополнительные поля, заполняются в зависимости от тарифа «Дадаты» *

Заполняются при выборе конкретной подсказки или через метод API findById. До этого они пустые.
Все тарифы «Дадаты»
data.geo_latstring(20)Координаты: широта
data.geo_lonstring(20)Координаты: долгота
data.qc_geostring(10)

Код точности координат:

  • 0 — точные координаты

  • 1 — ближайший дом

  • 2 — улица

  • 3 — населенный пункт

  • 4 — город

  • 5 — координаты не определены, отсутствуют в справочнике

  • 6 — не загружен справочник с геокоординатами
data.fias_codestring(50)Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД)
data.fias_actuality_statestring(10)

Признак актуальности адреса в ФИАС:

  • 0 — актуальный
  • 1–50 — переименован
  • 51 — переподчинен
  • 99 — удален
data.city_areastring(150)Административный округ (только для Москвы)
Тарифы «Расширенный» и «Максимальный»
data.beltway_hitstring(10)Внутри кольцевой?
data.beltway_distancestring(10)Расстояние от кольцевой в километрах
Тариф «Максимальный»
data.flat_areastring(50)Площадь квартиры
data.square_meter_pricestring(50)Рыночная стоимость м²
data.flat_pricestring(50)Рыночная стоимость квартиры
data.timezonestring(50)Часовой пояс

data.metro[ ]

└ name

└ line

└ distance


string(50)

string(50)

double

Ближайшие станции метро (не более 3 станций в радиусе 5 км):

— название станции

— название линии

— расстояние до станции в километрах

Не заполняются
data.house_cadnumstring(100)Кадастровый номер дома (21.4+)
data.flat_cadnumstring(100)Кадастровый номер квартиры (21.4+)
data.entrancestring(10)Подъезд (21.1+)
data.floorstring(10)Этаж (21.1+)
data.qc_completestring(10)Код пригодности к рассылке
data.qc_housestring(10)Код проверки дома
data.qcstring(10)Код проверки
data.unparsed_partsstring(250)Нераспознанная часть адреса

* Для «коробки» заполненность этих полей зависит от лицензии. Уточните детали в технической поддержке.

value

Поле value содержит адрес одной строкой от региона до квартиры. Склеивается из полей:
  • data.region_with_type (регион с типом),
  • data.area_with_type (район в регионе с типом),
  • data.city_with_type (город с типом),
  • data.settlement_with_type (населенный пункт с типом),
  • data.street_with_type (улица с типом),
  • data.house_type (тип дома),
  • data.house (дом),
  • data.block_type (тип корпуса/строения),
  • data.block (корпус/строение),
  • data.flat_type (тип квартиры),
  • data.flat (квартира).

При этом применяются правила сокращения адреса для деловой переписки:

  • если город — областной центр, область не пишется (Новосибирская обл, г Новосибирск → г Новосибирск);
  • если город — центр района, не пишется район (Респ Татарстан, Верхнеуслонский р-н, село Верхний Услон → Респ Татарстан, село Верхний Услон).

Если в запросе к API указан параметр restrict_value, то в поле value возвращается только часть адреса, которая подходит под ограничение. Например:

region = Москва, restrict_value = false, query = сакко
→ value = г Самара, ул Сакко и Ванцетти

region = Москва, restrict_value = true, query = сакко
→ value = ул Сакко и Ванцетти

unrestricted_value

Поле unrestricted_value содержит адрес одной строкой от индекса до квартиры. Оно склеивается из полей:
  • data.postal_code (индекс),
  • data.region_with_type (регион с типом),
  • data.area_with_type (район в регионе с типом),
  • data.city_with_type (город с типом),
  • data.city_district_with_type (район города с типом),
  • data.settlement_with_type (населенный пункт с типом),
  • data.street_with_type (улица с типом),
  • data.house_type (тип дома),
  • data.house (дом),
  • data.block_type (тип корпуса/строения),
  • data.block (корпус/строение),
  • data.flat_type (тип квартиры),
  • data.flat (квартира).

Сокращение по правилам деловой переписки к unrestricted_value не применяется и параметр restrict_value на него не влияет.

Поменяйте настройки, если стандартные вас не устраивают

НастройкаОписание
count
Количество возвращаемых подсказок (по умолчанию — 5, максимум — 20).
constraints и restrict_value

Ограничение области поиска по родителю

locations_geo

Ограничение области поиска по координатам и радиусу окружности (20.4+)

geoLocationГеолокация
boundsГранулярные подсказки по адресу
language

Язык отображения адреса в результатах поиска (20.3+)

  • No labels