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

Ключ

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

Включить страницу
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ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/address

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

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

Параметры

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

language

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

Ответ

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

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

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

Примеры

Запрос

Блок кода
languagejavascript
{
  "query": "5f96fd6b-
Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
}

либо

Блок кода
languagejavascript
{
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/address

...

"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",
                "geo_lat": "55.760317",
                "geo_lon": "37.560961",
                "beltway_hit": "IN_MKAD",
                "beltway_distance": null,
                "metro": null,
                "divisions": null,
                "qc_geo": "2",
                "qc_complete": null,
                "qc_house": null,
                "history_values": null,
                "unparsed_parts": null,
                "source": null,
                "qc": null
            }
        }
    ]
}

Запрос:

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

Запрос

Блок кода
languagejavascript
{
	"query":"6026dd78-0d6c-4c13-b3f4-4ea131eb17eb", 
	"language":"en"
}
Раскрыть
titleОтвет
Блок кода
languagejs
 {
    "suggestions": [
        {
            "value": "Russia, Moscow city, prospekt Leninsky, dom 23",
            "unrestricted_value": "119071, Russia, Moscow city, rayon Donskoy, prospekt Leninsky, dom 23"

...

Параметры

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

Ответ

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

...

titleПоказать

...

Примеры

Запрос

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

либо

Блок кода
languagejavascript
{
  "query": "77000000000292300" 
}
Раскрыть
titleОтвет
Блок кода
languagejs
 {
  "suggestions": [
    {
      "value": "г Москва, ул Трехгорный Вал",
      "unrestricted_value": "г Москва, Пресненский р-н, ул Трехгорный Вал",
      "data": {
        "postal_code": "123022",
        "country": "Россия",
        "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
        "region_kladr_id": "7700000000000",
        "region_with_type": "г Москва",
        "region_type": "г",
        "region_type_full": "город",
        "region": "Москва",
        "area_fias_id": null,
        "area_kladr_id": null,
        "area_with_type": null,
        "area_type"data": null,{
        "area_type_full": null,
        "areapostal_code": null"119071",
        "city_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
        "city_kladr_idcountry": "7700000000000Russia",
        "city_with_type":  Москва",
        "citycountry_iso_typecode": "гRU",
        "city_type_full": "город",
          "cityfederal_district": "Москва"null,
        "city_area": "Центральный",
        "cityregion_district_fias_id": null"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "cityregion_district_kladr_id": null"7700000000000",
        "city_district_with_type": "Пресненский р-н",
         "cityregion_districtiso_typecode": "рRU-нMOW",
                "cityregion_districtwith_type_full": "районMoscow city",
        "city_district": "Пресненский",
        "settlementregion_fias_idtype": null"city",
        "settlement_kladr_id": null,
        "settlementregion_withtype_typefull": null"city",
        "settlement_type": null,
        "settlement_type_fullregion": null"Moscow",
        "settlement": null,
        "streetarea_fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683"null,
                "streetarea_kladr_id": "77000000000292300"null,
         "street       "area_with_type": "ул Трехгорный Вал",
: null,
                "streetarea_type": "ул"null,
                "streetarea_type_full": "улица"null,
        "street        "area": "Трехгорный Вал"null,
        "house        "city_fias_id": null"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
         "house       "city_kladr_id": null"7700000000000",
        "house_type": null,
        "housecity_with_type_full": "Moscow nullcity",
        "house": null,
        "blockcity_type": null"city",
                "blockcity_type_full": null"city",
         "block       "city": null"Moscow",
        "flat_type": null,
          "flatcity_type_fullarea": null,
        "flat": null,
        "flat_areacity_district_fias_id": null,
        "square_meter_price": null,
        "flat_pricecity_district_kladr_id": null,
        "postal_box": null,
        "fias_idcity_district_with_type": "5f96fd6b-b3de-451f-b280-8fedf859e683rayon Donskoy",
           "fias_level     "city_district_type": "7rayon",
        "kladr_id": "77000000000292300",
        "capital_markercity_district_type_full": "0rayon",
        "okato": "45286575000",
        "oktmocity_district": "45380000Donskoy",
        "tax_office": "7703",
        "taxsettlement_officefias_legalid": null,
        "timezone": null,
        "geosettlement_kladr_latid": "55.760395"null,
        "geo_lon": "37.5609378",
        "beltwaysettlement_with_hittype": null,
        "beltway_distance": null,
        "qcsettlement_geotype": "2"null,
        "qc_complete": null,
        "qcsettlement_type_housefull": null,
        "unparsed_parts": null,
        "qcsettlement": null,
      }
        }
  ]
}

Запрос:

Блок кода
languagehtml/xml
<req>
  <query>5f96fd6b-b3de-451f-b280-8fedf859e683</query>
</req>
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
<SuggestResponse>
"street_fias_id": "5f2a1243-a57b-418e-baee-ff76f4993b45",
     <suggestions>
        <value>г Москва, ул Трехгорный Вал</value> "street_kladr_id": "77000000000168900",
        <unrestricted_value>г Москва, Пресненский р-н, ул Трехгорный Вал</unrestricted_value>
  "street_with_type": "prospekt Leninsky",
    <data>
            <postal_code>123022</postal_code>"street_type": "prospekt",
            <country>Россия</country>
    "street_type_full": "prospekt",
         <region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
       "street": "Leninsky",
    <region_kladr_id>7700000000000</region_kladr_id>
            <region"stead_withfias_type>г Москва</region_with_type>
id": null,
             <region_type>г</region_type>
   "stead_cadnum": null,
              <region_type_full>город</region_type_full>  "stead_type": null,
            <region>Москва</region>
    "stead_type_full": null,
       <area_fias_id/>
         "stead": null,
     <area_kladr_id/>
            <area"house_with_type/>fias_id": "6026dd78-0d6c-4c13-b3f4-4ea131eb17eb",
            <area_type/>
    "house_kladr_id": "7700000000016890023",
       <area_type_full/>
            <area/>"house_cadnum": "77:05:0001009:1035",
            <city_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
    "house_type": "dom",
       <city_kladr_id>7700000000000</city_kladr_id>
            <city_with_type>г Москва</city_with_type>
"house_type_full": "dom",
              <city_type>г</city_type>
  "house": "23",
         <city_type_full>город</city_type_full>
       "block_type": null,
    <city>Москва</city>
            <city_area>Центральный</city_area>"block_type_full": null,
            <city_district_fias_id/>
        "block": null,
    <city_district_kladr_id/>
            <city_district_with_type>Пресненский р-н</city_district_with_type>"entrance": null,
            <city_district_type>р-н</city_district_type>
    "floor": null,
       <city_district_type_full>район</city_district_type_full>
            <city_district>Пресненский</city_district>"flat_fias_id": null,
            <settlement_fias_id/>    "flat_cadnum": null,
            <settlement_kladr_id/>    "flat_type": null,
            <settlement_with_type/>    "flat_type_full": null,
            <settlement_type/>
      "flat": null,
     <settlement_type_full/>
            <settlement/>"flat_area": null,
            <street_fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</street_fias_id>    "square_meter_price": null,
            <street_kladr_id>77000000000292300</street_kladr_id>
    "flat_price": null,
              <street_with_type>ул Трехгорный Вал</street_with_type>"postal_box": null,
            <street_type>ул</street_type>
    "fias_id": "6026dd78-0d6c-4c13-b3f4-4ea131eb17eb",
       <street_type_full>улица</street_type_full>
         "fias_code": null,
   <street>Трехгорный Вал</street>
            <house_"fias_id/>level": "8",
            <house_kladr_id/>
    "fias_actuality_state": "0",
       <house_type/>
            <house_type_full/>
 "kladr_id": "7700000000016890023",
           <house/>
     "geoname_id": "524901",
      <block_type/>
            <block_type_full/>"capital_marker": "0",
            <block/>
    "okato": "45296561000",
       <flat_type/>
            <flat_type_full/>"oktmo": "45915000",
            <flat/>
    "tax_office": "7725",
       <flat_area/>
            <square_meter_price/>"tax_office_legal": "7725",
            <flat_price/>
    "timezone": null,
       <postal_box/>
            <fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</fias_id>
"geo_lat": "55.71734",
              <fias_level>7</fias_level>  "geo_lon": "37.59639",
            <kladr_id>77000000000292300</kladr_id>    "beltway_hit": null,
            <capital_marker>0</capital_marker>    "beltway_distance": null,
            <okato>45286575000</okato>
      "metro": null,
          <oktmo>45380000</oktmo>
      "divisions": null,
     <tax_office>7703</tax_office>
            <tax_office_legal/>"qc_geo": "0",
            <timezone/>
    "qc_complete": null,
       <geo_lat>55.760395</geo_lat>
            <geo_lon>37.5609378</geo_lon>
"qc_house": null,
              <beltway_hit/>  "history_values": null,
            <beltway_distance/>
    "unparsed_parts": null,
       <qc_geo>2</qc_geo>
         "source": null,
  <qc_complete/>
            <qc_house/>
  "qc": null
         <unparsed_parts/>
    }
        <qc/>}
    ]
}

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

Geonames-код:

Блок кода
languagejavascript
{
  "query": 
</data>
"1857910" 
}

либо OSM-код:

Блок кода
languagejavascript
{
  "query": 
</suggestions> </SuggestResponse>
"way:208547592" 
}