История страницы

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

	_API_TESTER
	_API_TESTER

Оглавление

maxLevel	2
minLevel	2

Возможности

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

	SGTDOC:О «Подсказках»: подсказки по адресам
	SGTDOC:О «Подсказках»: подсказки по адресам

Запрос

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

Без форматирования

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "москва серпуховская" }' \
   https http://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)

Параметры

Параметр Тип Обязательный? Описание

query string(300) да Запрос, для которого нужно получить подсказки

count

int

нет

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

	_count_server
	_count_server

language

string(2)

нет

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

division

string(20)

нет

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

locations

object[100]

нет

Ограничение области поиска

locations_geo

object[1]

нет

Географическое ограничение 20.4+

locations_boost object[1] нет Приоритет города при ранжировании

from_bound
to_bound

object

нет

Гранулярные подсказки по адресу

...

Параметры

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

count

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

locations

нетОграничение области поиска

Ответ

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

Раскрыть

title	Показать

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

	Объект адреса
	Объект адреса

Примеры

Запрос

Блок кода

language	javascript

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

Ответ:


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

Ответ:

Раскрыть

title	Показать

Блок кода

language	js

{
      "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
        }
      },
      {
        "value": "г Москва, Серпуховская пл",
        "unrestricted_value": "г Москва, Серпуховская пл",
        "data": {
          "postal_code": "115184",
          "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": "6fe35e69-360a-4d75-8061-066a5c9e669c",
          "street_kladr_id": "77000000000702000",
          "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,

Раскрыть

title	Показать

Блок кода

language	js

{
  "suggestions": [
    {
      "value": "г Москва, ул Серпуховская Б.",
      "unrestricted_value": "г Москва, ул Серпуховская Б.",
      "data": {
          "qcflat_completeprice": null,
          "qcpostal_housebox": null,
          "qc_geo": nullfias_id": "6fe35e69-360a-4d75-8061-066a5c9e669c",
          "postalfias_codelevel": "1150937",
          "postalkladr_boxid": null"77000000000702000",
          "countrycapital_marker": "Россия0",
        "region_with_type  "okato": "г Москва45286560000",
          "region_typeoktmo": "г45376000",
          "regiontax_type_fulloffice": "город7705",
        "region  "tax_office_legal": "Москва"null,
          "area_with_typetimezone": null,
          "areageo_typelat": null,
          "areageo_type_fulllon": null,
          "areabeltway_hit": null,
          "citybeltway_with_typedistance": "г Москва"null,
          "cityqc_typegeo": "г"null,
          "cityqc_type_fullcomplete": "город"null,
          "cityqc_house": "Москва"null,
          "cityunparsed_districtparts": null,
          "settlement_with_typeqc": null,

        }
      }
   "settlement_type": null,
  ]
  }

Запрос:

Блок кода

language	html/xml

<req>
    <query>москва серпуховская</query>
  </req>

Ответ:

Раскрыть

title	Показать

Блок кода

language	html/xml

<SuggestResponse>  "settlement_type_full": null,
      <suggestions>
  "settlement": null,
        "street_with_type": "<value>г Москва, ул Серпуховская Б.",</value>
        "street_type": "ул",
     <unrestricted_value>г Москва, ул Серпуховская Б.</unrestricted_value>
     "street_type_full": "улица",
     <data>
   "street": "Серпуховская Б.",
           "house_type": null,
<postal_code>115093</postal_code>
          "house_type_full": null,
   <country>Россия</country>
     "house": null,
        "block_type": null,
<region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
          "block": null,
   <region_kladr_id>7700000000000</region_kladr_id>
     "flat_area": null,
        "flat_type": null,<region_with_type>г Москва</region_with_type>
        "flat": null,
        "fias_id": "601875e2-717a-4c30-a3c4-1fb49e67d93f",<region_type>г</region_type>
        "fias_level": "7",
      <region_type_full>город</region_type_full>
          "kladr_id": "77000000000262500",
   <region>Москва</region>
     "tax_office": null,
        "tax<area_office_legal": null,
fias_id/>
         "capital_marker": "0",
    <area_kladr_id/>
    "okato": null,
        "oktmo": null, <area_with_type/>
        "geo_lat": null,
      <area_type/>
     "geo_lon": null,
        "unparsed_parts": null,<area_type_full/>
        "qc": null
      }<area/>
    },
    {
      "value": "г Москва, Серпуховская пл",
<city_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
          "unrestricted_value": "г Москва, Серпуховская пл", <city_kladr_id>7700000000000</city_kladr_id>
      "data": {
        "qc_complete": null,
<city_with_type>г Москва</city_with_type>
              "qc_house": null,<city_type>г</city_type>
        "qc_geo": null,
     <city_type_full>город</city_type_full>
   "postal_code": "115184",
          "postal_box": null, <city>Москва</city>
        "country": "Россия",
      <city_area/>
    "region_with_type": "г Москва",
        "region_type": "г",
<city_district_fias_id/>
          "region_type_full": "город",
   <city_district_kladr_id/>
     "region": "Москва",
        "area<city_district_with_type": null,
/>
         "area_type": null,
    <city_district_type/>
    "area_type_full": null,
        "area": null,
 <city_district_type_full/>
         "city_with_type": "г Москва",
   <city_district/>
     "city_type": "г",
        "city<settlement_type_full": "город",
fias_id/>
          "city": "Москва",
   <settlement_kladr_id/>
     "city_district": null,
        "settlement<settlement_with_type": null,
/>
         "settlement_type": null,
    <settlement_type/>
    "settlement_type_full": null,
        "settlement": null, <settlement_type_full/>
        "street_with_type": "Серпуховская пл",
      <settlement/>
  "street_type": "пл",
            "<street_fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</street_type_full": "площадь",
fias_id>
              "street": "Серпуховская",<street_kladr_id>77000000000262500</street_kladr_id>
        "house_type": null,
     <street_with_type>ул   "house_type_full": null,Серпуховская Б.</street_with_type>
        "house": null,
        "block_type": null,<street_type>ул</street_type>
        "block": null,
     <street_type_full>улица</street_type_full>
   "flat_area": null,
        "flat_type": null,
  <street>Серпуховская Б.</street>
     "flat": null,
        "<house_fias_id": "6fe35e69-360a-4d75-8061-066a5c9e669c",
/>
          "fias_level": "7",
   <house_kladr_id/>
     "kladr_id": "77000000000702000",
        "tax_office": "7705",
<house_type/>
         "tax_office_legal": "7705",
    <house_type_full/>
    "capital_marker": "0",
        "okato": "45286560000", <house/>
        "oktmo": "45376000",
      <block_type/>
    "geo_lat": null,
        "geo_lon": null, <block_type_full/>
        "unparsed_parts": null,
     <block/>
   "qc": null
 		}
    }
  ]
}

Запрос:

Блок кода

language	html/xml

Раскрыть

title	Показать

<req>

<query>москва серпуховская</query> </req>

Ответ:

Блок кода

language	html/xml

<SuggestResponse>
 <flat_type/>
              <suggestions><flat_type_full/>
        <value>г   Москва, ул Серпуховская Б.<<flat/value>>
          <unrestricted_value>г Москва, ул Серпуховская Б.</unrestricted_value>
 <flat_area/>
              <square_meter_price/>
    <data>
            <qc<flat_completeprice/>
            <qc  <postal_housebox/>
              <qc_geo/><fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</fias_id>
            <postal  <fias_code>115093<level>7</postalfias_code>level>
            <postal  <kladr_boxid>77000000000262500</>kladr_id>
              <country>Россия</country><capital_marker>0</capital_marker>
            <region_with_type>г Москва</region_with_type>  <okato/>
            <region_type>г</region_type>  <oktmo/>
            <region_type_full>город</region_type_full>  <tax_office/>
            <region>Москва</region>
  <tax_office_legal/>
              <area_with_type<timezone/>
            <area  <geo_typelat/>
            <area_type_full  <geo_lon/>
            <area  <beltway_hit/>
            <city_with_type>г Москва</city_with_type>
  <beltway_distance/>
              <city<qc_type>г<geo/city_type>>
            <city_type_full>город</city_type_full>  <qc_complete/>
            <city>Москва</city>
  <qc_house/>
              <city<unparsed_districtparts/>
              <settlement_with_type<qc/>
            <settlement_type/></data>
      </suggestions>
      <settlement_type_full/><suggestions>
          <value>г Москва, Серпуховская <settlementпл</>value>
          <unrestricted_value>г  <street_with_type>ул Москва, Серпуховская Б.<пл</streetunrestricted_with_type>value>
          <data>
  <street_type>ул</street_type>
            <street<postal_type_full>улица<code>115184</streetpostal_type_full>code>
            <street>Серпуховская  Б.<<country>Россия</street>country>
              <house_type/>
<region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
             <house <region_typekladr_full/>id>7700000000000</region_kladr_id>
            <house/>   <region_with_type>г Москва</region_with_type>
            <block  <region_typetype>г</>region_type>
            <block/>
  <region_type_full>город</region_type_full>
              <flat_area<region>Москва</>region>
             <flat_type <area_fias_id/>
            <flat   <area_kladr_id/>
              <fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</fias_id>
<area_with_type/>
             <fias <area_level>7<type/fias_level>>
            <kladr_id>77000000000262500</kladr_id>  <area_type_full/>
            <tax_office  <area/>
            <tax  <city_office_legal/>
fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
              <capital<city_kladr_marker>0<id>7700000000000</capitalcity_kladr_marker>id>
            <okato/>   <city_with_type>г Москва</city_with_type>
            <oktmo/>
  <city_type>г</city_type>
             <geo_lat/> <city_type_full>город</city_type_full>
            <geo_lon/>
  <city>Москва</city>
              <unparsed<city_partsarea/>
            <qc  <city_district_fias_id/>
         </data>
     </suggestions>
 <city_district_kladr_id/>
   <suggestions>
        <value>г Москва, Серпуховская пл</value> <city_district_with_type/>
        <unrestricted_value>г Москва, Серпуховская пл</unrestricted_value>
      <city_district_type/>
  <data>
            <qc_complete<city_district_type_full/>
            <qc  <city_housedistrict/>
            <qc_geo  <settlement_fias_id/>
              <postal<settlement_kladr_code>115184<id/postal_code>>
              <postal<settlement_with_boxtype/>
             <country>Россия</country> <settlement_type/>
            <region  <settlement_withtype_type>г Москва</region_with_type>full/>
            <region_type>г</region_type>  <settlement/>
            <region  <street_type_full>город</region_type_full>
fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</street_fias_id>
              <region>Москва</region>
<street_kladr_id>77000000000702000</street_kladr_id>
              <area<street_with_type/>type>Серпуховская пл</street_with_type>
            <area  <street_typetype>пл</>street_type>
              <area<street_type_full/>
full>площадь</street_type_full>
              <area<street>Серпуховская</>street>
              <city<house_withfias_type>г Москва</city_with_type>
id/>
             <city_type>г</city_type> <house_kladr_id/>
            <city  <house_type_full>город</city_type_full>
/>
             <city>Москва</city> <house_type_full/>
            <city_district  <house/>
            <settlement  <block_with_type/>
            <settlement  <block_type_full/>
            <settlement_type_full  <block/>
              <settlement<flat_type/>
            <street_with_type>Серпуховская пл</street_with_type>  <flat_type_full/>
            <street_type>пл</street_type>
  <flat/>
              <street<flat_type_full>площадь</street_type_full>area/>
            <street>Серпуховская</street>  <square_meter_price/>
            <house  <flat_typeprice/>
            <house_type_full  <postal_box/>
              <house/><fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</fias_id>
            <block  <fias_typelevel>7</>fias_level>
            <block/>
  <kladr_id>77000000000702000</kladr_id>
              <flat<capital_areamarker>0</>capital_marker>
            <flat_type/>  <okato>45286560000</okato>
            <flat  <oktmo>45376000</>oktmo>
            <fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</fias_id>  <tax_office>7705</tax_office>
            <fias_level>7</fias_level>  <tax_office_legal/>
            <kladr_id>77000000000702000</kladr_id>
  <timezone/>
              <tax<geo_office>7705<lat/tax_office>>
            <tax_office_legal>7705</tax_office_legal>  <geo_lon/>
            <capital  <beltway_marker>0<hit/capital_marker>>
             <okato>45286560000</okato> <beltway_distance/>
            <oktmo>45376000</oktmo>
  <qc_geo/>
              <geo<qc_latcomplete/>
              <geo<qc_lonhouse/>
              <unparsed_parts/>
              <qc/>
          </data>
      </suggestions>
  </SuggestResponse>

Дерево страниц

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

Старая версия 13

Новая версия Текущий

Ключ

Возможности

Запрос

Запрос

Параметры

Параметры

Ответ

Примеры