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

Ключ

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

Включить страницу
_API_TESTER
_API_TESTER

Оглавление
maxLevel2
minLevel2

Возможности

Включить страницу
SGTDOC:О «Подсказках»: подсказки по адресам
SGTDOC:О «Подсказках»: подсказки по адресам

Запрос

Запрос

...

Без форматирования
curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "москва серпуховская" }' \
    httpshttp://dadata.ruВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/v2rs/suggest/address

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

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "москва серпуховская" }' \
  http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/address

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

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "москва серпуховская" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/address

...

API-пробник (21.8+)

HTML
<p class="api">
    <input id="api-url" type="text" placeholder="http://сервер:8080/">
    <button id="api-go" type="button" onclick="openApiTester('address/suggest')">→</button>
  </p>

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

Параметры

ПараметрТипОбязательный?Описание
querystring(300)даЗапрос, для которого нужно получить подсказки

count

intнет
Включить страницу
_count_server
_count_server

language

string(2)нетЯзык отображения адреса в результатах поиска 20.3+
по умолчанию — русский
divisionstring(20)нет

Административное либо муниципальное деление 22.4+
по умолчанию — административное

locations

object[100]

...

Параметры

ПараметрОбязательный?ОписаниеqueryдаЗапрос, для которого нужно получить подсказки
count
нет Включить страницу_count_server_count_serverlocations
нетОграничение области поиска

Ответ

Ответ

Возвращается Возвращается список объектов адреса:

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

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

Примеры

Запрос

Блок кода
languagejavascript
{
  "query": "москва серпуховская" 
}

Ответ:

javascript
{
    "query": "москва серпуховская" 
  }

Ответ:

Раскрыть
titleПоказать
Блок кода
languagejs
{
      "suggestions": [
      {
        "value": "г Москва, ул Серпуховская Б.",
        "unrestricted_value": "г Москва, ул Серпуховская Б.",
        "data": {
          "postal_code": "115093",
          "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": 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": null,
          "city_district_fias_id": null,
          "city_district_kladr_id": null,
          "city_district_with_type": null,
          "city_district_type": null,
          "city_district_type_full": null,
          "city_district": null,
          "settlement_fias_id": null,
          "settlement_kladr_id": null,
          "settlement_with_type": null,
          "settlement_type": null,
          "settlement_type_full": null,
          "settlement": null,
          "street_fias_id": "601875e2-717a-4c30-a3c4-1fb49e67d93f",
          "street_kladr_id": "77000000000262500",
          "street_with_type": "ул Серпуховская Б.",
          "street_type": "ул",
          "street_type_full": "улица",
          "street": "Серпуховская Б.",
          "house_fias_id": null,
          "house_kladr_id": null,
          "house_type": null,
          "house_type_full": null,
          "house": null,
          "block_type": null,
          "block_type_full": null,
          "block": 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": "601875e2-717a-4c30-a3c4-1fb49e67d93f",
          "fias_level": "7",
          "kladr_id": "77000000000262500",
          "capital_marker": "0",
          "okato": null,
          "oktmo": null,
          "tax_office": null,
          "tax_office_legal": null,
          "timezone": null,
          "geo_lat": null,
          "geo_lon": null,
          "beltway_hit": null,
          "beltway_distance": null,
          "qc_geo": null,
          "qc_complete": null,
          "qc_house": null,
          "unparsed_parts": null,
          "qc": null
        }
      },
      {
Раскрыть
titleПоказать
Блок кода
languagejs
{
    "suggestions": [
        {
             "value": "г Москва, Серпуховская пл",
            "unrestricted_value": "г Москва, Серпуховская пл",
            "data": {
                "postal_code": "115184",
          "country": "Россия",
          "postalregion_fias_boxid": null"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "country""region_kladr_id": "Россия7700000000000",
                "region_with_type": "г Москва",
                "region_type_full": "городг",
                "region_type_full": "Москвагород",
                "area_typeregion": null"Москва",
                "area_typefias_fullid": null,
                "area_kladr_id": null,
       null,
          "cityarea_with_type": "г"null,
                "cityarea_type_full": "город"null,
                "cityarea_type_full": "Москва"null,
                "settlement_typearea": null,
                "settlementcity_typefias_fullid": null"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
          "city_kladr_id": "7700000000000",
          "settlementcity_with_type": nullМосква",
                "streetcity_type": "плг",
                "streetcity_type_full": "площадьгород",
                "streetcity": "СерпуховскаяМосква",
                "housecity_typearea": null,
          "city_district_fias_id": null,
          "housecity_district_typekladr_fullid": null,
                "house"city_district_with_type": null,
                "blockcity_district_type": null,
                "blockcity_district_type_full": null,
                "flatcity_areadistrict": null,
                "flatsettlement_fias_typeid": null,
       null,
          "flatsettlement_kladr_id": null,
                "fiassettlement_with_idtype": null,
                "kladrsettlement_idtype": "77000000000702000"null,
                "taxsettlement_type_officefull": "7705"null,
          "settlement": null,
          "taxstreet_officefias_legalid": null"6fe35e69-360a-4d75-8061-066a5c9e669c",
                "okatostreet_kladr_id": "4528656000077000000000702000",
                "oktmostreet_with_type": "Серпуховская nullпл",
                "unparsedstreet_partstype": null"пл",
            }
        },
        {"street_type_full": "площадь",
            "valuestreet": "г Москва, ул Серпуховская Б.",
            "unrestrictedhouse_fias_valueid": "г Москва, ул Серпуховская Б."null,
            "data"house_kladr_id": {null,
                "postalhouse_codetype": "115093"null,
                "postalhouse_type_boxfull": null,
                "countryhouse": "Россия"null,
                "regionblock_type": "г"null,
                "regionblock_type_full": "город"null,
                "regionblock": "Москва"null,
                "areaflat_type": null,
                "areaflat_type_full": null,
                "areaflat": null,
                "cityflat_typearea": "г"null,
                "citysquare_typemeter_fullprice": "город"null,
                "cityflat_price": "Москва"null,
                "settlementpostal_typebox": null,
          "fias_id": "6fe35e69-360a-4d75-8061-066a5c9e669c",
          "settlementfias_type_fulllevel": null"7",
                "settlementkladr_id": null"77000000000702000",
                "streetcapital_typemarker": "ул0",
                "street_type_fullokato": "улица45286560000",
                "streetoktmo": "Серпуховская Б.45376000",
                "housetax_typeoffice": null"7705",
                "housetax_typeoffice_fulllegal": null,
                "housetimezone": null,
                "blockgeo_typelat": null,
                "blockgeo_lon": null,
                "flatbeltway_areahit": null,
                "flatbeltway_typedistance": null,
                "flatqc_geo": null,
                "fiasqc_idcomplete": null,
                "kladrqc_idhouse": "77000000000262500"null,
                "taxunparsed_officeparts": null,
                "tax_office_legalqc": null,
        }
        "okato": null,}
    ]
  }


Запрос:

Блок кода
languagehtml/xml
<req>
    <query>москва серпуховская</query>
  </req>

Ответ:

Раскрыть
titleПоказать
Блок кода
languagehtml/xml
<SuggestResponse>
      <suggestions>
   "oktmo": null,
             <value>г Москва,  "unparsed_parts": null
ул Серпуховская Б.</value>
          <unrestricted_value>г Москва, ул  }Серпуховская Б.</unrestricted_value>
        },  <data>
        {
      <postal_code>115093</postal_code>
      "value":  Москва, пл Серпуховская Застава",
   <country>Россия</country>
         "unrestricted_value":  Москва, пл Серпуховская Застава", <region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
            "data": {  <region_kladr_id>7700000000000</region_kladr_id>
                "postal_code": "115191",<region_with_type>г Москва</region_with_type>
                "postal_box": null,
<region_type>г</region_type>
              <region_type_full>город</region_type_full>
    "country": "Россия",
         <region>Москва</region>
       "region_type": "г",
      <area_fias_id/>
          "region_type_full": "город",
   <area_kladr_id/>
             "region": "Москва", <area_with_type/>
                "area<area_type": null,/>
                "area<area_type_full": null,
/>
              <area/>
           "area": null,
  <city_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
              "city_type": "г",<city_kladr_id>7700000000000</city_kladr_id>
                "<city_with_type>г Москва</city_type_full": "город",with_type>
                "city": "Москва",<city_type>г</city_type>
                "settlement_type": null,<city_type_full>город</city_type_full>
                "settlement_type_full": null,
   <city>Москва</city>
             "settlement": null, <city_area/>
                "street_type": "пл",<city_district_fias_id/>
                "street_type_full": "площадь",<city_district_kladr_id/>
                "street": "Серпуховская Застава",<city_district_with_type/>
                "house_type": null,<city_district_type/>
                "house<city_district_type_full": null,/>
                "house": null,<city_district/>
                "block_type": null,<settlement_fias_id/>
              <settlement_kladr_id/>
  "block": null,
           <settlement_with_type/>
     "flat_area": null,
        <settlement_type/>
        "flat_type": null,
     <settlement_type_full/>
           "flat": null,
  <settlement/>
              "fias_id": null,<street_fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</street_fias_id>
                "kladr_id": "77000000000262600",<street_kladr_id>77000000000262500</street_kladr_id>
              <street_with_type>ул  "tax_office": "7725",
Серпуховская Б.</street_with_type>
              <street_type>ул</street_type>
      "tax_office_legal": null,
       <street_type_full>улица</street_type_full>
         "okato": "45296559000",
    <street>Серпуховская Б.</street>
           "oktmo": null,
  <house_fias_id/>
              "unparsed_parts": null
<house_kladr_id/>
              }<house_type/>
        }
  ]
}

 

Запрос:

Блок кода
languagehtml/xml
<req>
  <query>москва серпуховская</query>
</req>

Ответ:

Раскрыть
titleПоказать
Блок кода
languagehtml/xml
<SuggestAddressResponse>      <house_type_full/>
    <suggestions>
        <value>г Москва, Серпуховская пл<<house/value>>
          <unrestricted_value>г  Москва, Серпуховская пл</unrestricted_value>
<block_type/>
             <data>
 <block_type_full/>
             <postal_code>115184</postal_code>
 <block/>
             <postal <flat_boxtype/>
            <country>Россия</country>  <flat_type_full/>
            <region_type>г</region_type>  <flat/>
            <region_type_full>город</region_type_full>
  <flat_area/>
             <region>Москва</region>
 <square_meter_price/>
             <area <flat_typeprice/>
            <area_type_full  <postal_box/>
              <area/><fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</fias_id>
            <city  <fias_type>г<level>7</cityfias_type>level>
            <city_type_full>город</city_type_full>  <kladr_id>77000000000262500</kladr_id>
            <city>Москва</city>  <capital_marker>0</capital_marker>
            <settlement_type  <okato/>
            <settlement_type_full  <oktmo/>
             <settlement <tax_office/>
            <street_type>пл</street_type>
  <tax_office_legal/>
              <street_type_full>площадь</street_type_full><timezone/>
            <street>Серпуховская</street>
  <geo_lat/>
             <house <geo_typelon/>
            <house_type_full  <beltway_hit/>
              <house<beltway_distance/>
             <block <qc_typegeo/>
            <block  <qc_complete/>
            <flat  <qc_areahouse/>
              <flat<unparsed_typeparts/>
              <flat<qc/>
            <fias_id/></data>
      </suggestions>
      <kladr_id>77000000000702000</kladr_id><suggestions>
          <value>г Москва, Серпуховская <tax_office>7705</tax_office>пл</value>
          <unrestricted_value>г Москва,  <tax_office_legal/>Серпуховская пл</unrestricted_value>
          <data>
  <okato>45286560000</okato>
            <oktmo/><postal_code>115184</postal_code>
            <unparsed_parts/>
  <country>Россия</country>
         </data>
     </suggestions><region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
    <suggestions>
        <value>г Москва, ул Серпуховская Б.</value>
 <region_kladr_id>7700000000000</region_kladr_id>
          <unrestricted_value>г  Москва, ул Серпуховская Б.</unrestricted_value>
 <region_with_type>г Москва</region_with_type>
       <data>
            <postal_code>115093</postal_code>
<region_type>г</region_type>
             <postal_box/>
 <region_type_full>город</region_type_full>
              <country>Россия<<region>Москва</country>region>
             <region_type>г</region_type> <area_fias_id/>
            <region_type_full>город</region_type_full>
  <area_kladr_id/>
              <region>Москва</region>
<area_with_type/>
              <area_type/>
              <area_type_full/>
              <area/>
              <city_type>г<fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_type>id>
              <city_typekladr_full>город<id>7700000000000</city_typekladr_full>id>
              <city_with_type>г <city>Москва</city>
Москва</city_with_type>
              <settlement<city_typetype>г</>city_type>
              <settlement<city_type_full/>
full>город</city_type_full>
             <settlement <city>Москва</>city>
            <street  <city_type>ул<area/street_type>>
            <street_type_full>улица</street_type_full>  <city_district_fias_id/>
            <street>Серпуховская Б.</street>  <city_district_kladr_id/>
            <house  <city_district_with_type/>
              <house<city_district_type_full/>
                <house<city_district_type_full/>
            <block  <city_typedistrict/>
            <block  <settlement_fias_id/>
             <flat_area <settlement_kladr_id/>
              <flat<settlement_with_type/>
              <flat<settlement_type/>
             <fias_id <settlement_type_full/>
              <kladr_id>77000000000262500</kladr_id>
<settlement/>
              <tax_office/>
<street_fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</street_fias_id>
             <tax <street_officekladr_legal/>
id>77000000000702000</street_kladr_id>
              <okato/>
 <street_with_type>Серпуховская пл</street_with_type>
             <oktmo/>
 <street_type>пл</street_type>
             <unparsed_parts/>
 <street_type_full>площадь</street_type_full>
          </data>
    <<street>Серпуховская</suggestions>street>
    <suggestions>
        <value>г Москва, пл Серпуховская Застава</value> <house_fias_id/>
        <unrestricted_value>г Москва, пл Серпуховская Застава</unrestricted_value>      <house_kladr_id/>
        <data>
            <postal_code>115191</postal_code><house_type/>
            <postal_box  <house_type_full/>
              <country>Россия<<house/country>>
             <region <block_type>г<type/region_type>>
             <region <block_type_full>город</region_type_full>full/>
            <region>Москва<  <block/region>>
              <area<flat_type/>
            <area  <flat_type_full/>
            <area  <flat/>
             <city <flat_type>г<area/city_type>>
             <city <square_typemeter_full>город</city_type_full>
 price/>
           <city>Москва</city>
            <settlement_type<flat_price/>
            <settlement_type_full  <postal_box/>
            <settlement/>
            <street_type>пл</street_type>  <fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</fias_id>
            <street_type_full>площадь</street_type_full>  <fias_level>7</fias_level>
            <street>Серпуховская  Застава</street><kladr_id>77000000000702000</kladr_id>
            <house  <capital_typemarker>0</>capital_marker>
            <house_type_full/>  <okato>45286560000</okato>
            <house  <oktmo>45376000</>oktmo>
            <block  <tax_typeoffice>7705</>tax_office>
            <block  <tax_office_legal/>
             <flat_area <timezone/>
            <flat  <geo_typelat/>
            <flat  <geo_lon/>
              <fias<beltway_idhit/>
              <kladr<beltway_id>77000000000262600<distance/kladr_id>>
              <tax<qc_office>7725<geo/tax_office>>
              <tax<qc_office_legalcomplete/>
            <okato>45296559000</okato>
  <qc_house/>
             <oktmo <unparsed_parts/>
            <unparsed_parts  <qc/>
          </data>
      </suggestions>
  </SuggestAddressResponse>SuggestResponse>