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

Ключ

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

Включить страницу
_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/v24_1/rs/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_countlocations
нетОграничение области поиска

Ответ

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

Ответ

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

Раскрыть
title
Раскрыть
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,
Раскрыть
titleПоказать
Блок кода
languagejs
{
    "suggestions": [
        {
            "valuetimezone": "г Москва, Серпуховская пл",null,
            "unrestrictedgeo_valuelat": "г Москва, Серпуховская пл"null,
            "datageo_lon": {
    null,
            "qcbeltway_completehit": null,
                "qcbeltway_housedistance": null,
                "postalqc_codegeo": "115184"null,
                "postalqc_boxcomplete": null,
          "qc_house": null,
       "country   "unparsed_parts": "Россия"null,
                "region_typeqc": "г",null
        }
        "region_type_full": "город"},
      {
          "regionvalue": "г Москва, Серпуховская пл",
                "areaunrestricted_typevalue": null"г Москва, Серпуховская пл",
        "data": {
          "areapostal_type_fullcode": null"115184",
                "areacountry": null"Россия",
                "cityregion_fias_typeid": null"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "cityregion_typekladr_fullid": null"7700000000000",
                "city"region_with_type": null"г Москва",
                "settlementregion_type": null"г",
                "settlementregion_type_full": null"город",
                "settlementregion": null"Москва",
                "street_type"area_fias_id": "пл",
     null,
           "streetarea_typekladr_fullid": "площадь"null,
                "streetarea_with_type": "Серпуховская"null,
                "housearea_type": null,
                "housearea_type_full": null,
                "housearea": null,
                "blockcity_fias_typeid": null,
      "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
          "blockcity_kladr_id": null"7700000000000",
                "flatcity_with_areatype": nullМосква",
                "flatcity_type": null"г",
                "flat"city_type_full": null"город",
                "tax_office"city": "7705Москва",
				"tax_office_legal          "city_area": null,
                "kladr_id": 77000000000702000,
				""city_district_fias_id": null,
                "okato"city_district_kladr_id": "45286560000"null,
                "oktmocity_district_with_type": null,
                "unparsed_parts"city_district_type": null,
                "qccity_district_type_full": null,
            }"city_district": null,
        },
        {"settlement_fias_id": null,
            "value"settlement_kladr_id": "г Москва, ул Серпуховская Б."null,
            "unrestrictedsettlement_with_valuetype": "г Москва, ул Серпуховская Б." null,
            "datasettlement_type": {null,
                "qc_complete"settlement_type_full": null,
                "qc_housesettlement": null,
                "postalstreet_fias_codeid": "1150936fe35e69-360a-4d75-8061-066a5c9e669c",
                "postalstreet_kladr_boxid": null"77000000000702000",
                "countrystreet_with_type": "РоссияСерпуховская пл",
                "region"street_type": "гпл",
                "regionstreet_type_full": "городплощадь",
                "regionstreet": "МоскваСерпуховская",
          "house_fias_id": null,
          "areahouse_kladr_typeid": null,
                "areahouse_type_full": null,
          "house_type_full": null,
          "areahouse": null,
                "city"block_type": null,
                "cityblock_type_full": null,
                "city"block": null,
                "settlementflat_type": null,
                "settlement"flat_type_full": null,
                "settlementflat": null,
          "flat_area": null,
     "street_type": "ул",
      "square_meter_price": null,
          "streetflat_type_fullprice": "улица"null,
          "postal_box": null,
          "streetfias_id": "Серпуховская Б.6fe35e69-360a-4d75-8061-066a5c9e669c",
                "housefias_typelevel": null"7",
                "housekladr_type_fullid": null,
     "77000000000702000",
           "housecapital_marker": null"0",
                "block_type"okato": null"45286560000",
                "blockoktmo": null"45376000",
                "flattax_areaoffice": null"7705",
                "flattax_office_typelegal": null,
                "flattimezone": null,
          "geo_lat": null,
          "taxgeo_officelon": ""null,
                "tax_office_legal"beltway_hit": null,
          "beltway_distance": null,
         "kladr_id": 77000000000702000,
				"fias_id"qc_geo": null,
                "okatoqc_complete": ""null,
                "oktmoqc_house": null,
                "unparsed_parts": null,
                "qc": null
        }
      }
    ]
    },}


Запрос:

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

Ответ:

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

 

Запрос:

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

Ответ:

Раскрыть
titleПоказать
Блок кода
languagehtml/xml
<SuggestAddressResponse>     <street>Серпуховская Б.</street>
    <suggestions>
        <value>г Москва, Серпуховская пл</value>
 <house_fias_id/>
           <unrestricted_value>г Москва, Серпуховская пл</unrestricted_value>
<house_kladr_id/>
              <house_type/>
    <data>
            <qc_complete<house_type_full/>
            <qc_house  <house/>
            <postal  <block_code>115184<type/postal_code>>
            <postal_box  <block_type_full/>
             <country>Россия< <block/country>>
            <region  <flat_type>г<type/region_type>>
            <region  <flat_type_full>город</region_type_full>
full/>
              <region>Москва<<flat/region>>
              <area<flat_typearea/>
             <area <square_typemeter_fullprice/>
             <area <flat_price/>
            <city  <postal_typebox/>
              <city_type_full/>
<fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</fias_id>
              <city/>
<fias_level>7</fias_level>
              <settlement<kladr_typeid>77000000000262500</>kladr_id>
              <settlement<capital_type_full/>marker>0</capital_marker>
            <settlement  <okato/>
             <street_type>пл</street_type>
 <oktmo/>
             <street_type_full>площадь</street_type_full>
 <tax_office/>
              <street>Серпуховская</street>
<tax_office_legal/>
              <house_type<timezone/>
              <house<geo_type_fulllat/>
            <house  <geo_lon/>
              <block<beltway_typehit/>
              <block<beltway_distance/>
             <flat <qc_areageo/>
            <flat  <qc_typecomplete/>
            <flat  <qc_house/>
              <tax<unparsed_office>7705<parts/tax_office>>
             <kladr_id>77000000000702000</kladr_id>
			<tax_office_legal/>
			<fias_id/ <qc/>
            <okato>45286560000<</okato>data>
      </suggestions>
      <oktmo/><suggestions>
          <value>г Москва, Серпуховская <unparsed_partsпл</>value>
          <unrestricted_value>г Москва, Серпуховская <qcпл</>unrestricted_value>
          </data>
<data>
          </suggestions>
    <suggestions><postal_code>115184</postal_code>
        <value>г   Москва, ул Серпуховская Б.<<country>Россия</value>country>
          <unrestricted_value>г Москва, ул Серпуховская Б.</unrestricted_value> <region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
        <data>
        <region_kladr_id>7700000000000</region_kladr_id>
    <qc_complete/>
            <qc_house/><region_with_type>г Москва</region_with_type>
            <postal  <region_code>115093<type>г</postalregion_code>type>
            <postal_box/>  <region_type_full>город</region_type_full>
            <country>Россия<  <region>Москва</country>region>
            <region_type>г</region_type>
  <area_fias_id/>
              <region<area_typekladr_full>город</region_type_full>
id/>
              <region>Москва</region>
<area_with_type/>
              <area_type/>
              <area_type_full/>
              <area/>
              <city_type/>
fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
              <city_typekladr_full/>
id>7700000000000</city_kladr_id>
              <city/>
_with_type>г Москва</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<settlement_kladr_areaid/>
            <flat  <settlement_with_type/>
            <flat  <settlement_type/>
            <tax_office></tax_office>
  <settlement_type_full/>
              <kladr_id>77000000000702000</kladr_id>
			<tax_office_legal/>
			<fias_id/>
<settlement/>
              <street_fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</street_fias_id>
    <okato></okato>
          <street_kladr_id>77000000000702000</street_kladr_id>
  <oktmo/>
            <unparsed_parts/><street_with_type>Серпуховская пл</street_with_type>
            <qc/>
        </data>
    </suggestions><street_type>пл</street_type>
    <suggestions>
        <value>г Москва, пл Серпуховская Застава</value>
 <street_type_full>площадь</street_type_full>
          <unrestricted_value>г Москва, пл Серпуховская Застава<<street>Серпуховская</unrestricted_value>street>
        <data>
            <qc_complete<house_fias_id/>
            <qc_house  <house_kladr_id/>
            <postal  <house_code>115191<type/postal_code>>
              <postal<house_type_boxfull/>
            <country>Россия<  <house/country>>
              <region<block_type>г<type/region_type>>
              <region_type_full>город</region<block_type_full>full/>
            <region>Москва<  <block/region>>
            <area  <flat_type/>
            <area  <flat_type_full/>
            <area  <flat/>
              <city<flat_typearea/>
             <city <square_typemeter_fullprice/>
            <city  <flat_price/>
              <settlement<postal_typebox/>
             <settlement_type_full/>
            <settlement/>
 <fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</fias_id>
               <street<fias_type>пл<level>7</streetfias_type>level>
              <street<kladr_type_full>площадь<id>77000000000702000</streetkladr_type_full>id>
            <street>Серпуховская  Застава</street><capital_marker>0</capital_marker>
            <house_type/>
  <okato>45286560000</okato>
             <house_type_full/>
 <oktmo>45376000</oktmo>
             <house/>
 <tax_office>7705</tax_office>
             <block_type <tax_office_legal/>
              <block<timezone/>

              <flat<geo_arealat/>
            <flat  <geo_typelon/>
            <flat  <beltway_hit/>
            <tax  <beltway_office>7725<distance/tax_office>>
            <kladr  <qc_id>77000000000702000</kladr_id>
			<tax_office_legal/>
			<fias_id/>
geo/>
              <okato>45296559000<<qc_complete/okato>>
            <oktmo  <qc_house/>
              <unparsed_parts/>
              <qc/>
          </data>
      </suggestions>
  </SuggestAddressResponse>SuggestResponse>