Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Включить страницу
SGTDOC:О «Подсказках»:
Ищет
адрес по коду КЛАДР или ФИАС
.

  • до улицы включительно по кодам КЛАДР и ФИАС;
  • до дома по коду ФИАС.
Раскрыть

в подсказках 19.7 и ниже – до улицы включительно, при поиске по кодам дома возвращает пустой ответ

Ищет только по актуальным адресам. Поиск выполняется по точному совпадению идентификатора, не по вхождению

Доступен только через API (jQuery-плагин не поддерживается).

Запрос

Для пользователей подсказок DaData.ru:

SGTDOC:О «Подсказках»: адрес по коду КЛАДР или ФИАС

Запрос

Без форматирования
curl -X POST
Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  httpshttp://suggestions.dadata.ruВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/address

Для пользователей standalone-подсказок:

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/address

...

Параметры

...

language

...

Включить страницу
_Заголовки (API)
_Заголовки (API)

Параметры

ПараметрОбязательный?Описание
queryдаКод КЛАДР или ФИАС, по которому нужно получить подсказку

language

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

Ответ

Возвращает объект адреса, который соответствует искомому коду:

Раскрыть
titleПоказать

Включить страницу
Объект адреса
Объект адреса

Примеры

Запрос

Блок кода
languagejavascript
{
  "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" 
}

либо

Блок кода
languagejavascript
{
  "query": "77000000000292300" 
}
Раскрыть
titleОтвет
Блок кода
languagejs
 {
    "suggestions": [
        {
            "value": "г Москва, ул Трехгорный Вал",
            "unrestricted_value": "123022, г Москва, Пресненский р-н, ул Трехгорный Вал",
            "data": {
                "postal_code": "123022",
                "country": "Россия",
                "country_iso_code": "RU",
                "federal_district": "Центральный",
                "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "region_kladr_id": "7700000000000",
                "region_iso_code": "RU-MOW",
                "region_with_type": "г Москва",
                "region_type": "г",
                "region_type_full": "город",
                "region": "Москва",
                "area_fias_id": null,
                "area_kladr_id": null,
                "area_with_type": null,
                "area_type": null,
                "area_type_full": null,
                "area": null,
                "city_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "city_kladr_id": "7700000000000",
                "city_with_type": "г Москва",
                "city_type": "г",
                "city_type_full": "город",
                "city": "Москва",
                "city_area": "Центральный",
                "city_district_fias_id": null,
                "city_district_kladr_id": null,
                "city_district_with_type": "Пресненский р-н",
                "city_district_type": "р-н",
                "city_district_type_full": "район",
                "city_district": "Пресненский",
                "settlement_fias_id": null,
                "settlement_kladr_id": null,
                "settlement_with_type": null,
                "settlement_type": null,
                "settlement_type_full": null,
                "settlement": null,
                "street_fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
                "street_kladr_id": "77000000000292300",
                "street_with_type": "ул Трехгорный Вал",
                "street_type": "ул",
                "street_type_full": "улица",
                "street": "Трехгорный Вал",
                "stead_fias_id": null,
                "stead_cadnum": null,
                "stead_type": null,
                "stead_type_full": null,
                "stead": null,
                "house_fias_id": null,
                "house_kladr_id": null,
                "house_cadnum": null,
                "house_type": null,
                "house_type_full": null,
                "house": null,
                "block_type": null,
                "block_type_full": null,
                "block": null,
                "entrance": null,
                "floor": null,
                "flat_fias_id": null,
                "flat_cadnum": null,
                "flat_type": null,
                "flat_type_full": null,
                "flat": null,
                "flat_area": null,
                "square_meter_price": null,
                "flat_price": null,
                "postal_box": null,
                "fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
                "fias_code": null,
                "fias_level": "7",
                "fias_actuality_state": "0",
                "kladr_id": "77000000000292300",
                "geoname_id": "524901",
                "capital_marker": "0",
                "okato": "45286575000",
                "oktmo": "45380000",
                "tax_office": "7703",
                "tax_office_legal": "7703",
                "timezone": "UTC+3

Ответ

Возвращает объект адреса, который соответствует искомому коду:

...

titleПоказать

...

Примеры

Запрос

Блок кода
languagejavascript
{
  "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" 
}

либо

Блок кода
languagejavascript
{
  "query": "77000000000292300" 
}
Раскрыть
titleОтвет
Блок кода
languagejs
 {
  "suggestions": [
    {
      "value": "г Москва, ул Трехгорный Вал",
      "unrestricted_value": "г Москва, Пресненский р-н, ул Трехгорный Вал",
      "data": {
          "postalgeo_codelat": "12302255.760317",
        "country": "Россия",
        "regiongeo_fias_idlon": "0c5b2444-70a0-4932-980c-b4dc0d3f02b537.560961",
        "region_kladr_id": "7700000000000",
        "regionbeltway_with_typehit": "г МоскваIN_MKAD",
        "region_type": "г",
        "regionbeltway_type_fulldistance": "город"null,
        "region": "Москва",
        "area_fias_idmetro": null,
        "area_kladr_id": null,
        "area_with_typedivisions": null,
        "area_type": null,
        "areaqc_type_fullgeo": null"2",
        "area": null,
        "cityqc_fias_idcomplete": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"null,
        "city_kladr_id": "7700000000000",
        "cityqc_with_typehouse": "г Москва"null,
        "city_type": "г",
          "cityhistory_type_fullvalues": "город"null,
        "city": "Москва",
        "cityunparsed_areaparts": "Центральный"null,
        "city_district_fias_id": null,
        "city_district_kladr_idsource": null,
        "city_district_with_type": "Пресненский р-н",
        "city_district_typeqc": "р-н",null
        "city_district_type_full": "район",
   }
     "city_district": "Пресненский",
  }
      "settlement_fias_id": null,]
}

Запрос:

Блок кода
languagehtml/xml
<req>
  <query>5f96fd6b-b3de-451f-b280-8fedf859e683</query>
</req>
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
<SuggestResponse>
        "settlement_kladr_id": null,<suggestions>
        "settlement_with_type": null,
        "settlement_type": null,<value>г Москва, ул Трехгорный Вал</value>
        "settlement_type_full": null,
        "settlement": null,
        "street_fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",<unrestricted_value>123022, г Москва, Пресненский р-н, ул Трехгорный Вал</unrestricted_value>
        "street_kladr_id": "77000000000292300",
<data>
         "street_with_type": "ул Трехгорный Вал", <postal_code>123022</postal_code>
        "street_type": "ул",
   <country>Россия</country>
     "street_type_full": "улица",
      <country_iso_code>RU</country_iso_code>
  "street": "Трехгорный Вал",
        "house_fias_id": null,<federal_district>Центральный</federal_district>
        "house_kladr_id": null,
   <region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
     "house_type": null,
        "house_type_full": null,<region_kladr_id>7700000000000</region_kladr_id>
        "house": null,
   <region_iso_code>RU-MOW</region_iso_code>
     "block_type": null,
        "block_type_full": null,
<region_with_type>г Москва</region_with_type>
           "block": null,
 <region_type>г</region_type>
            "flat<region_type_full>город</region_type": null,
_full>
         "flat_type_full": null,
  <region>Москва</region>
      "flat": null,
     <area_fias_id/>
   "flat_area": null,
        "square<area_meter_price": null,
kladr_id/>
            "flat_price": null,<area_with_type/>
        "postal_box": null,
   <area_type/>
     "fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
      <area_type_full/>
  "fias_level": "7",
        "kladr_id": "77000000000292300", <area/>
        "capital_marker": "0",    <city_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
        "okato": "45286575000",
   <city_kladr_id>7700000000000</city_kladr_id>
     "oktmo": "45380000",
        "tax_office": "7703",
<city_with_type>г Москва</city_with_type>
            "tax_office_legal": null,
<city_type>г</city_type>
           "timezone": null,
 <city_type_full>город</city_type_full>
          "geo_lat": "55.760395",  <city>Москва</city>
        "geo_lon": "37.5609378",
    <city_area>Центральный</city_area>
    "beltway_hit": null,
        "beltway_distance": null,<city_district_fias_id/>
        "qc_geo": "2",
   <city_district_kladr_id/>
     "qc_complete": null,
        "qc_house": null,<city_district_with_type>Пресненский р-н</city_district_with_type>
        "unparsed_parts": null,
        "qc": null<city_district_type>р-н</city_district_type>
      }
    }
  ]
}

Запрос:

Блок кода
languagehtml/xml
<req>
  <query>5f96fd6b-b3de-451f-b280-8fedf859e683</query>
</req>
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
<SuggestResponse>
    <suggestions>  <city_district_type_full>район</city_district_type_full>
            <city_district>Пресненский</city_district>
        <value>г Москва, ул Трехгорный Вал</value><settlement_fias_id/>
        <unrestricted_value>г Москва, Пресненский р-н, ул Трехгорный Вал</unrestricted_value>
    <settlement_kladr_id/>
            <settlement_with_type/>
           <data> <settlement_type/>
            <postal<settlement_type_code>123022<full/postal_code>>
            <country>Россия<<settlement/country>>
            <region<street_fias_id>0c5b2444id>5f96fd6b-70a0b3de-4932451f-980cb280-b4dc0d3f02b5<8fedf859e683</regionstreet_fias_id>
            <region<street_kladr_id>7700000000000<id>77000000000292300</regionstreet_kladr_id>
            <region<street_with_type>гtype>ул Трехгорный Москва<Вал</regionstreet_with_type>
            <region<street_type>г<type>ул</regionstreet_type>
            <region<street_type_full>город<full>улица</regionstreet_type_full>
            <region>Москва</region>
            <area_fias_id/><street>Трехгорный Вал</street>
            <area<stead_kladrfias_id/>
            <area<stead_with_typecadnum/>
            <area<stead_type/>
            <area<stead_type_full/>
            <area<stead/>
            <city<house_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>id/>
            <city<house_kladr_id>7700000000000</city_kladr_id>id/>
            <city_with_type>г Москва</city_with_type><house_cadnum/>
            <city<house_type>г<type/city_type>>
            <city<house_type_full>город</city_type_full>full/>
            <city>Москва<<house/city>>
            <city<block_area>Центральный<type/city_area>>
            <city<block_districttype_fias_idfull/>
            <city_district_kladr_id<block/>
            <city_district_with_type>Пресненский р-н</city_district_with_type><entrance/>
            <floor/>
            <city<flat_districtfias_type>р-н</city_district_type>id/>
            <city_district_type_full>район</city_district_type_full><flat_cadnum/>
            <city<flat_district>Пресненский<type/city_district>>
            <settlement<flat_fiastype_idfull/>
            <settlement_kladr_id<flat/>
            <settlement<flat_with_typearea/>
            <settlement<square_meter_typeprice/>
            <settlement<flat_type_fullprice/>
            <settlement<postal_box/>
            <street<fias_fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</street_fias_id>
            <street<fias_kladr_id>77000000000292300</street_kladr_id>code/>
            <street_with_type>ул Трехгорный Вал</street_with_type><fias_level>7</fias_level>
            <street<fias_actuality_type>ул<state>0</streetfias_actuality_type>state>
            <street<kladr_type_full>улица<id>77000000000292300</streetkladr_type_full>id>
            <street>Трехгорный Вал</street><geoname_id>524901</geoname_id>
            <house<capital_fias_id/>marker>0</capital_marker>
            <house_kladr_id/><okato>45286575000</okato>
            <house_type<oktmo>45380000</>oktmo>
            <house<tax_type_full/>office>7703</tax_office>
            <house/><tax_office_legal>7703</tax_office_legal>
            <block_type/><timezone>UTC+3</timezone>
            <block_type_full/><geo_lat>55.760317</geo_lat>
            <block/><geo_lon>37.560961</geo_lon>
            <flat<beltway_hit>IN_typeMKAD</>beltway_hit>
            <flat<beltway_type_fulldistance/>
            <flat<metro/>
            <flat_area<divisions/>
            <square<qc_meter_price/>geo>2</qc_geo>
            <flat<qc_pricecomplete/>
            <postal<qc_boxhouse/>
            <fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</fias_id><history_values/>
            <fias<unparsed_level>7<parts/fias_level>>
            <kladr_id>77000000000292300</kladr_id><source/>
            <capital_marker>0</capital_marker><qc/>
            <okato>45286575000</okato>   </data>
    </suggestions>
</SuggestResponse>

Запрос

Блок кода
languagejavascript
{
	"query":"6026dd78-0d6c-4c13-b3f4-4ea131eb17eb", 
	"language":"en"
}
Раскрыть
titleОтвет
Блок кода
languagejs
 {
            <oktmo>45380000</oktmo>"suggestions": [
            <tax_office>7703</tax_office>{
            <tax_office_legal/>
            <timezone/>"value": "Russia, Moscow city, prospekt Leninsky, dom 23",
            <geo_lat>55.760395</geo_lat>
            <geo_lon>37.5609378</geo_lon>
"unrestricted_value": "119071, Russia, Moscow city, rayon Donskoy, prospekt Leninsky, dom 23",
              <beltway_hit/>"data": {
            <beltway_distance/>
      "postal_code": "119071",
      <qc_geo>2</qc_geo>
             <qc_complete/>"country": "Russia",
            <qc_house/>
    "country_iso_code": "RU",
         <unparsed_parts/>
       "federal_district": null,
    <qc/>
        </data>
    </suggestions>
</SuggestResponse>

Запрос

Блок кода
languagejavascript
{
	"query":"6026dd78-0d6c-4c13-b3f4-4ea131eb17eb", 
	"language":"en"
}
Раскрыть
titleОтвет
Блок кода
languagejs
 {
    "suggestions": [
  "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "region_kladr_id": "7700000000000",
                "region_iso_code": "RU-MOW",
      {
            "value"region_with_type": "Russia, Moscow city",
 prospekt Leninskii, dom 23",
            "unrestrictedregion_valuetype": "119071, Russia, Moscow city, prospekt Leninskii, dom 23",
city",
                "dataregion_type_full": {"city",
                "postal_coderegion": "119071Moscow",
                "countryarea_fias_id": "Russia"null,
                "countryarea_isokladr_codeid": "RU"null,
                "federalarea_with_districttype": null,
                "regionarea_fias_idtype": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"null,
                "regionarea_kladrtype_idfull": "7700000000000"null,
                "region_iso_codearea": "RU-MOW"null,
                "regioncity_withfias_typeid": "Moscow city0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "regioncity_kladr_typeid": "city7700000000000",
                "regioncity_with_type_full": "Moscow "city",
                "regioncity_type": "Moscowcity",
                "areacity_fiastype_idfull": null"city",
                "area_kladr_idcity": null"Moscow",
                "city_area_with_type": null,
                "area_typecity_district_fias_id": null,
                "areacity_district_typekladr_fullid": null,
                "areacity_district_with_type": "rayon nullDonskoy",
                "city_fiasdistrict_idtype": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5rayon",
                "city_district_kladrtype_idfull": "7700000000000rayon",
                "city_with_typedistrict": "Moscow cityDonskoy",
                "citysettlement_fias_typeid": "city"null,
                "citysettlement_typekladr_fullid": "city"null,
                "citysettlement_with_type": "Moscow"null,
                "citysettlement_areatype": null,
                "citysettlement_districttype_fias_idfull": null,
                "city_district_kladr_idsettlement": null,
                "citystreet_districtfias_with_typeid": null"5f2a1243-a57b-418e-baee-ff76f4993b45",
                "citystreet_districtkladr_typeid": null"77000000000168900",
                "citystreet_districtwith_type_full": "prospekt nullLeninsky",
                "citystreet_districttype": null"prospekt",
                "settlementstreet_fiastype_idfull": null"prospekt",
                "settlement_kladr_idstreet": null"Leninsky",
                "settlementstead_withfias_typeid": null,
                "settlementstead_typecadnum": null,
                "settlementstead_type_full": null,
                "settlementstead_type_full": null,
                "street_fias_id": "5f2a1243-a57b-418e-baee-ff76f4993b45"  "stead": null,
                "streethouse_kladrfias_id": "770000000001689006026dd78-0d6c-4c13-b3f4-4ea131eb17eb",
                "streethouse_withkladr_typeid": "prospekt Leninskii7700000000016890023",
                "streethouse_typecadnum": "prospekt77:05:0001009:1035",
                "streethouse_type_full": "prospektdom",
                "streethouse_type_full": "Leninskiydom",
                "house_fias_id": "6026dd78-0d6c-4c13-b3f4-4ea131eb17eb23",
                "houseblock_kladr_idtype": "7700000000016890023"null,
                "houseblock_type_full": "dom"null,
                "house_type_fullblock": "dom"null,
                "houseentrance": "23"null,
                "block_typefloor": null,
                "blockflat_typefias_fullid": null,
                "blockflat_cadnum": null,
                "flat_type": null,
                "flat_type_full": null,
                "flat": null,
                "flat_area": null,
                "square_meter_price": null,
                "flat_price": null,
                "postal_box": null,
                "fias_id": "6026dd78-0d6c-4c13-b3f4-4ea131eb17eb",
                "fias_code": "77000000000000016890023"null,
                "fias_level": "8",
                "fias_actuality_state": "0",
                "kladr_id": "7700000000016890023",
                "geoname_id": null"524901",
                "capital_marker": "0",
                "okato": "45296561000",
                "oktmo": "45915000",
                "tax_office": "7725",
                "tax_office_legal": "7725",
                "timezone": null,
                "geo_lat": null"55.71734",
                "geo_lon": "37.59639",
                "geobeltway_lonhit": null,
                "beltway_hitdistance": null,
                "beltway_distancemetro": null,
                "metrodivisions": null,
                "qc_geo": null"0",
                "qc_complete": null,
                "qc_house": null,
                "history_values": null,
                "unparsed_parts": null,
                "source": null,
                "qc": null
            }
        }
    ]
}

Запрос иностранных адресов (20.7+)

Geonames-код:

Блок кода
languagejavascript
{
  "query": "1857910" 
}

либо OSM-код:

Блок кода
languagejavascript
{
  "query": "way:208547592" 
}