Поле | Описание |
---|---|
value | Короткий адрес одной строкой |
unrestricted_value | Длинный адрес одной строкой |
data.postal_code | Индекс |
data.country | Страна |
data.country_iso_code | Двухсимвольный код страны ISO 3166 (19.7+) |
data.federal_district | Федеральный округ (19.5+) |
data.region_fias_id | Код ФИАС региона (либо код OSM, начиная с версии 20.7) |
data.region_kladr_id | Код КЛАДР региона |
data.region_iso_code | Код региона ISO 3166 (19.7+) |
data.region_with_type | Регион с типом |
data.region_type | Тип региона (сокращенный) |
data.region_type_full | Тип региона |
data.region | Регион |
data.area_fias_id | Код ФИАС района в регионе (либо код OSM, начиная с версии 20.7) |
data.area_kladr_id | Код КЛАДР района в регионе |
data.area_with_type | Район в регионе с типом |
data.area_type | Тип района в регионе (сокращенный) |
data.area_type_full | Тип района в регионе |
data.area | Район в регионе |
data.city_fias_id | Код ФИАС города (либо код OSM, начиная с версии 20.7) |
data.city_kladr_id | Код КЛАДР города |
data.city_with_type | Город с типом |
data.city_type | Тип города (сокращенный) |
data.city_type_full | Тип города |
data.city | Город |
data.city_district_fias_id | Код ФИАС района города (либо код OSM, начиная с версии 20.7) |
data.city_district_kladr_id | Код КЛАДР района города |
data.city_district_with_type | Район города с типом |
data.city_district_type | Тип района города (сокращенный) |
data.city_district_type_full | Тип района города |
data.city_district | Район города |
data.settlement_fias_id | Код ФИАС нас. пункта (либо код OSM, начиная с версии 20.7) |
data.settlement_kladr_id | Код КЛАДР нас. пункта |
data.settlement_with_type | Населенный пункт с типом |
data.settlement_type | Тип населенного пункта (сокращенный) |
data.settlement_type_full | Тип населенного пункта |
data.settlement | Населенный пункт |
data.street_fias_id | Код ФИАС улицы (либо код OSM, начиная с версии 20.7) |
data.street_kladr_id | Код КЛАДР улицы |
data.street_with_type | Улица с типом |
data.street_type | Тип улицы (сокращенный) |
data.street_type_full | Тип улицы |
data.street | Улица |
data.house_fias_id | Код ФИАС дома (либо код OSM, начиная с версии 20.7) |
data.house_kladr_id | Код КЛАДР дома |
data.house_type | Тип дома (сокращенный) |
data.house_type_full | Тип дома |
data.house | Дом |
data.block_type | Тип корпуса/строения (сокращенный) |
data.block_type_full | Тип корпуса/строения |
data.block | Корпус/строение |
data.flat_fias_id | Код ФИАС квартиры (20.10+) |
data.flat_type | Тип квартиры (сокращенный) |
data.flat_type_full | Тип квартиры |
data.flat | Квартира |
data.postal_box | Абонентский ящик |
data.fias_id | Код ФИАС:
Либо код OSM (начиная с версии 20.7) |
data.fias_level | Уровень детализации, до которого адрес найден в ФИАС:
|
data.kladr_id | Код КЛАДР |
data.geoname_id | Идентификатор объекта в международной базе GeoNames. Для российских адресов не заполняется. |
data.capital_marker | Признак центра района или региона:
|
data.okato | Код ОКАТО |
data.oktmo | Код ОКТМО |
data.tax_office | Код ИФНС для физических лиц |
data.tax_office_legal | Код ИФНС для организаций |
data.source | Для организаций — адрес как в ЕГРЮЛ. |
data.history_values[ ] | Список исторических названий объекта нижнего уровня. |
Дополнительные поля, заполняются в зависимости от тарифа «Дадаты» * | |
Заполняются при выборе конкретной подсказки или через метод API findById. До этого они пустые. | |
Все тарифы «Дадаты» | |
data.geo_lat | Координаты: широта |
data.geo_lon | Координаты: долгота |
data.qc_geo | Код точности координат:
|
data.fias_code | Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД) |
data.fias_actuality_state | Признак актуальности адреса в ФИАС:
|
data.city_area | Административный округ (только для Москвы) |
Тарифы «Расширенный» и «Максимальный» | |
data.beltway_hit | Внутри кольцевой? |
data.beltway_distance | Расстояние от кольцевой в километрах |
Тариф «Максимальный» | |
data.flat_area | Площадь квартиры |
data.square_meter_price | Рыночная стоимость м² |
data.flat_price | Рыночная стоимость квартиры |
data.timezone | Часовой пояс |
data.metro[ ] └ name └ line └ distance | Ближайшие станции метро (не более 3 станций в радиусе 5 км): — название станции — название линии — расстояние до станции в километрах |
Не заполняются | |
data.entrance | Подъезд (21.1+) |
data.floor | Этаж (21.1+) |
data.qc_complete | Код пригодности к рассылке |
data.qc_house | Код проверки дома |
data.qc | Код проверки |
data.unparsed_parts | Нераспознанная часть адреса |
* Для «коробки» заполненность этих полей зависит от лицензии. Уточните детали в технической поддержке.
value
value
содержит адрес одной строкой от региона до квартиры. Склеивается из полей:- data.region_with_type (регион с типом),
- data.area_with_type (район в регионе с типом),
- data.city_with_type (город с типом),
- data.settlement_with_type (населенный пункт с типом),
- data.street_with_type (улица с типом),
- data.stead_type (тип участка),
- data.stead (участок),
- data.house_type (тип дома),
- data.house (дом),
- data.block_type (тип корпуса/строения),
- data.block (корпус/строение),
- data.flat_type (тип квартиры),
- data.flat (квартира),
- data.room_type (тип комнаты),
- data.room (комната).
При этом применяются правила сокращения адреса для деловой переписки:
- если город — областной центр, область не пишется (Новосибирская обл, г Новосибирск → г Новосибирск);
- если город — центр района, не пишется район (Респ Татарстан, Верхнеуслонский р-н, село Верхний Услон → Респ Татарстан, село Верхний Услон).
Для адресов в муниципальном делении действуют более сложные правила, которые записывают адрес в удобочитаемом виде (мун. деление в оригинале очень громоздкое). Примеры:
region_with_type: Московская обл area_with_type: г.о. Одинцовский city_with_type: г Одинцово → value = Московская обл, г Одинцово region_with_type: г Москва area_with_type: вн.тер.г. городской округ Щербинка city_with_type: г Щербинка street_with_type: Остафьевское шоссе → value = г Москва, г Щербинка, Остафьевское шоссе region_with_type: г Москва area_with_type: вн.тер.г. муниципальный округ Северное Медведково street_with_type: ул Сухонская house_type: д house: 11 → value = г Москва, ул Сухонская, д 11 region_with_type: Самарская обл area_with_type: г.о. Самара sub_area_with_type: вн.р-н Железнодорожный city_with_type: г Самара street_with_type: ул Сакко и Ванцетти house_type: д house: 20 → value = Самарская обл, г Самара, ул Сакко и Ванцетти, д 20
Если в запросе к 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.sub_area_with_type (мун. поселение с типом),
- data.city_with_type (город с типом),
- data.city_district_with_type (адм. район города с типом),
- data.settlement_with_type (населенный пункт с типом),
- data.street_with_type (улица с типом),
- data.stead_type (тип участка),
- data.stead (участок),
- data.house_type (тип дома),
- data.house (дом),
- data.block_type (тип корпуса/строения),
- data.block (корпус/строение),
- data.flat_type (тип квартиры),
- data.flat (квартира),
- data.room_type (тип комнаты),
- data.room (комната).
Сокращение по правилам деловой переписки к unrestricted_value
не применяется и параметр restrict_value
на него не влияет.