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

Ключ

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

Включить страницу
SGTDOC:ФИАС: предупреждение
SGTDOC:ФИАС: предупреждение

Запрос

Запрос

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

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

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

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

...

Параметры

...

count

...

locations

...

from_bound
to_bound

...

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

Параметры

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

from_bound
to_bound

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

Ответ

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

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

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

Примеры

Запрос

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

Ответ:

Раскрыть
titleПоказать
Блок кода
languagejs
{
    "suggestions": [
        {
            "value": "г Москва, ул Серпуховская Б.",
            "unrestricted_value": "г Москва, ул Серпуховская Б.",
            "data": {
                "postal_code": null,
                "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": null,
                "city_kladr_id": null,
                "city_with_type": null,
                "city_type": null,
                "city_type_full": null,
                "city": 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,
                "planning_structure_fias_id": null,
                "planning_structure_kladr_id": null,
                "planning_structure_with_type": null,
                "planning_structure_type": null,
                "planning_structure_type_full": null,
                "planning_structure": 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": null,
                "block": null,
                "building_type": null,
                "building": null,
                "fias_id": "601875e2-717a-4c30-a3c4-1fb49e67d93f",
                "fias_code": "7700000000000002625",
                "fias_level": "7",
                "fias_actuality_state": "0",
                "kladr_id": "77000000000262500",
                "capital_marker": "0",
                "okato": null,
                "oktmo": null,
                "cadastral_number": null,
                "tax_office": null,
                "tax_office_legal": null,
                "history_values": null,
                "source": null,
                "qc": null
            }
        },
        {
            "value": "г Москва, пл Серпуховская",
            "unrestricted_value": "115184, г Москва, пл Серпуховская",
            "data": {
                "postal_code": "115184",
                "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": null,
                "city_kladr_id": null,
                "city_with_type": null,
                "city_type": null,
                "city_type_full": null,
                "city": 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,

Ответ

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

...

titleПоказать

...

Примеры

Запрос

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

Ответ:

Раскрыть
titleПоказать
Блок кода
languagejs
{
    "suggestions": [
        {
            "value    "planning_structure_fias_id": "г Москва, ул Серпуховская Б.",
null,
                "unrestricted_valueplanning_structure_kladr_id": "г Москва, ул Серпуховская Б.",
null,
                 "data"planning_structure_with_type": {null,
                "postalplanning_structure_codetype": null,
                "regionplanning_structure_fiastype_idfull": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"null,
                "regionplanning_kladr_idstructure": "7700000000000"null,
                "regionstreet_withfias_typeid": "г Москва6fe35e69-360a-4d75-8061-066a5c9e669c",
                "regionstreet_kladr_typeid": "г77000000000702000",
                "region"street_with_type_full": "городпл Серпуховская",
                "regionstreet_type": "Москвапл",
                "areastreet_fiastype_idfull": null"площадь",
                "area_kladr_idstreet": null"Серпуховская",
                "areahouse_withfias_typeid": null,
                "areahouse_kladr_typeid": null,
                "areahouse_type_full": null,
                "areahouse": null,
                "city_fias_idblock": null,
                "citybuilding_kladr_idtype": null,
                "city_with_typebuilding": null,
                "cityfias_typeid": null"6fe35e69-360a-4d75-8061-066a5c9e669c",
                "cityfias_type_fullcode": null"7700000000000007020",
                "cityfias_level": null"7",
                "cityfias_districtactuality_fias_idstate": null"0",
                "city_district_kladr_id": null"77000000000702000",
                "city_district_with_typecapital_marker": null"0",
                "okato": "city_district_type": null45286560000",
                "city_district_type_fulloktmo": null"45376000",
                "citycadastral_districtnumber": null,
                "settlementtax_fias_idoffice": null"7705",
                "settlementtax_kladroffice_idlegal": null"7705",
                "settlementhistory_with_typevalues": null,[
                "settlement_type": null,    "пл Добрынинская"
                "settlement_type_full": null],
                "settlementsource": null,
                "planning_structure_fias_idqc": null,
                "planning_structure_kladr_id": null,}
        }
    ]
}

Запрос:

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

Ответ:

Раскрыть
titleПоказать
Блок кода
languagehtml/xml
<SuggestResponse>  "planning_structure_with_type": null,
    <suggestions>
        <value>г Москва, ул  "planning_structure_type": null,Серпуховская Б.</value>
        <unrestricted_value>г Москва, ул      "planning_structure_type_full": null,Серпуховская Б.</unrestricted_value>
        <data>
        "planning_structure": null,
     <postal_code/>
           "street <region_fias_id": "601875e2-717a-4c30-a3c4-1fb49e67d93f",id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
            <region_kladr_id>7700000000000</region_kladr_id>
    "street_kladr_id": "77000000000262500",        <region_with_type>г Москва</region_with_type>
                "street_with_type": "ул Серпуховская Б.",
<region_type>г</region_type>
            <region_type_full>город</region_type_full>
       "street_type": "ул",
    <region>Москва</region>
            "street<area_type_full": "улица",
   fias_id/>
             "street": "Серпуховская Б.",<area_kladr_id/>
                "house_fias_id": null,<area_with_type/>
            <area_type/>
    "house_kladr_id": null,
       <area_type_full/>
         "house_type": null,
  <area/>
            <city_fias_id/>
  "house": null,
         <city_kladr_id/>
       "block": null,
    <city_with_type/>
            "building<city_type": null,/>
            <city_type_full/>
    "building": null,
        <city/>
             "<city_district_fias_id": "601875e2-717a-4c30-a3c4-1fb49e67d93f",/>
             <city_district_kladr_id/>
   "fias_code": "7700000000000002625",
        <city_district_with_type/>
        "fias_level": "7",
   <city_district_type/>
             "fias_actuality_state": "0",<city_district_type_full/>
                "kladr_id": "77000000000262500",<city_district/>
                "capital_marker": "0",<settlement_fias_id/>
                "okato": null,<settlement_kladr_id/>
            <settlement_with_type/>
    "oktmo": null,
       <settlement_type/>
         "cadastral_number": null,
  <settlement_type_full/>
              "tax_office": null,<settlement/>
                "tax_office_legal": null,<planning_structure_fias_id/>
                "history_values": null,<planning_structure_kladr_id/>
                "source": null,<planning_structure_with_type/>
            <planning_structure_type/>
    "qc": null
        <planning_structure_type_full/>
    }
        },<planning_structure/>
        {
    <street_fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</street_fias_id>
        "value":  Москва, пл Серпуховская", <street_kladr_id>77000000000262500</street_kladr_id>
            "unrestricted_value": "115184, г Москва, пл Серпуховская",<street_with_type>ул Серпуховская Б.</street_with_type>
            "data": {<street_type>ул</street_type>
                "postal_code": "115184",<street_type_full>улица</street_type_full>
                "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
    <street>Серпуховская Б.</street>
            "region<house_kladrfias_id": "7700000000000",/>
            <house_kladr_id/>
    "region_with_type": "г Москва",
        <house_type/>
           "region_type": "г", <house/>
            <block/>
    "region_type_full": "город",
         <building_type/>
       "region": "Москва",
    <building/>
            "area_fias_id": null,<fias_id>601875e2-717a-4c30-a3c4-1fb49e67d93f</fias_id>
                "area_kladr_id": null,<fias_code>7700000000000002625</fias_code>
                "area_with_type": null,<fias_level>7</fias_level>
                "area_type": null,<fias_actuality_state>0</fias_actuality_state>
            <kladr_id>77000000000262500</kladr_id>
    "area_type_full": null,
       <capital_marker>0</capital_marker>
         "area": null,
  <okato/>
            <oktmo/>
  "city_fias_id": null,
         <cadastral_number/>
       "city_kladr_id": null,
    <tax_office/>
            "city<tax_with_type": null,
office_legal/>
            <history_values/>
      "city_type": null,
     <source/>
           "city_type_full": null, <qc/>
        </data>
    </suggestions>
    "city": null,<suggestions>
        <value>г Москва, пл Серпуховская</value>
     "city_district_fias_id": null,   <unrestricted_value>115184, г Москва, пл Серпуховская</unrestricted_value>
        <data>
        "city_district_kladr_id": null,
   <postal_code>115184</postal_code>
             "city_district_with_type": null,<region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
                "city_district_type": null,<region_kladr_id>7700000000000</region_kladr_id>
                "city_district_type_full": null,
 <region_with_type>г Москва</region_with_type>
            <region_type>г</region_type>
   "city_district": null,
        <region_type_full>город</region_type_full>
        "settlement_fias_id": null,
    <region>Москва</region>
            "settlement<area_kladrfias_id": null,/>
                "settlement_with_type": null,
<area_kladr_id/>
            <area_with_type/>
      "settlement_type": null,
      <area_type/>
            "settlement<area_type_full": null,
/>
            <area/>
       "settlement": null,
    <city_fias_id/>
            "planning_structure_fias_id": null,
<city_kladr_id/>
            <city_with_type/>
       "planning_structure_kladr_id": null,
    <city_type/>
            "planning<city_structure_with_type": null,
type_full/>
            <city/>
        "planning_structure_type": null,
   <city_district_fias_id/>
             "planning<city_structuredistrict_type_full": null,
kladr_id/>
            <city_district_with_type/>
       "planning_structure": null,
    <city_district_type/>
            "street_fias_id": "6fe35e69-360a-4d75-8061-066a5c9e669c",
<city_district_type_full/>
            <city_district/>
       "street_kladr_id": "77000000000702000",
    <settlement_fias_id/>
            "street<settlement_with_type": "пл Серпуховская",
kladr_id/>
            <settlement_with_type/>
       "street_type": "пл",
    <settlement_type/>
            "street<settlement_type_full": "площадь",
/>
            <settlement/>
       "street": "Серпуховская",
    <planning_structure_fias_id/>
            "house_fias_id": null,<planning_structure_kladr_id/>
            <planning_structure_with_type/>
    "house_kladr_id": null,
        <planning_structure_type/>
            "house<planning_structure_type": null,
_full/>
            <planning_structure/>
      "house": null,
     <street_fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</street_fias_id>
           "block": null, <street_kladr_id>77000000000702000</street_kladr_id>
                "building_type": null,<street_with_type>пл Серпуховская</street_with_type>
                "building": null,<street_type>пл</street_type>
             <street_type_full>площадь</street_type_full>
   "fias_id": "6fe35e69-360a-4d75-8061-066a5c9e669c",
         <street>Серпуховская</street>
       "fias_code": "7700000000000007020",
    <house_fias_id/>
            "fias_level": "7",
<house_kladr_id/>
            <house_type/>
      "fias_actuality_state": "0",
     <house/>
           "kladr_id": "77000000000702000", <block/>
            <building_type/>
    "capital_marker": "0",
       <building/>
         "okato": "45286560000",
  <fias_id>6fe35e69-360a-4d75-8061-066a5c9e669c</fias_id>
            <fias_code>7700000000000007020</fias_code>
  "oktmo": "45376000",
         <fias_level>7</fias_level>
       "cadastral_number": null,
    <fias_actuality_state>0</fias_actuality_state>
            "tax_office": "7705",<kladr_id>77000000000702000</kladr_id>
                "tax_office_legal": "7705",<capital_marker>0</capital_marker>
            <okato>45286560000</okato>
    "history_values": [
        <oktmo>45376000</oktmo>
            "пл Добрынинская"<cadastral_number/>
            <tax_office>7705</tax_office>
    ],
        <tax_office_legal>7705</tax_office_legal>
        "source": null,
    <history_values>пл Добрынинская</history_values>
           "qc": null <source/>
            }<qc/>
        }</data>
    ]
}</suggestions>
</SuggestResponse>