Просмотреть исходный

Метод доступен только через API (jQuery-плагин не поддерживается).

Метод ищет по коду ФИАС/КЛАДР до улицы (при поиске по коду дома вернется пустой ответ).

Обратите внимание – поиск адреса по коду ФИАС осуществляется только в случае, когда Подсказки используют справочник ФИАС.
Если справочник – КЛАДР, то поиск возможен только по коду КЛАДР.

Запрос

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  https://dadata.ru/api/v2/findById/address

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  http://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/address

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/address

Параметры

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

Ответ

Возвращается объект адреса, который соответствует искомому коду КЛАДР/ФИАС:

Примеры

Запрос

{
  "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" 
}

либо

{
  "query": "77000000000292300" 
}

Ответ:

 {
    "suggestions": [
        {
            "value": "г Москва, ул Трехгорный Вал",
            "unrestricted_value": "г Москва, ул Трехгорный Вал",
            "data": {
                "qc_complete": null,
                "qc_house": null,
                "qc_geo": "2",
                "postal_code": "123022",
                "postal_box": null,
                "country": "Россия",
                "region_with_type": "г Москва",
                "region_type": "г",
                "region_type_full": "город",
                "region": "Москва",
                "area_with_type": null,
                "area_type": null,
                "area_type_full": null,
                "area": null,
                "city_with_type": "г Москва",
                "city_type": "г",
                "city_type_full": "город",
                "city": "Москва",
                "city_district": null,
                "settlement_with_type": null,
                "settlement_type": null,
                "settlement_type_full": null,
                "settlement": null,
                "street_with_type": "ул Трехгорный Вал",
                "street_type": "ул",
                "street_type_full": "улица",
                "street": "Трехгорный Вал",
                "house_type": null,
                "house_type_full": null,
                "house": null,
                "block_type": null,
                "block": null,
                "flat_area": null,
                "flat_type": null,
                "flat": null,
                "fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
                "kladr_id": "77000000000292300",
                "tax_office": "7703",
                "tax_office_legal": null,
                "okato": "45286575000",
                "oktmo": "45380000",
                "geo_lat": "55.7604033",
                "geo_lon": "37.5610847",
                "unparsed_parts": null,
                "qc": null
            }
        }
    ]
}

Запрос:

<req>
  <query>5f96fd6b-b3de-451f-b280-8fedf859e683</query>
</req>

Ответ:

<SuggestResponse>
    <suggestions>
        <value>г Москва, ул Трехгорный Вал</value>
        <unrestricted_value>г Москва, ул Трехгорный Вал</unrestricted_value>
        <data>
            <qc_complete/>
            <qc_house/>
            <qc_geo>2</qc_geo>
            <postal_code>123022</postal_code>
            <postal_box/>
            <country>Россия</country>
            <region_with_type>г Москва</region_with_type>
            <region_type>г</region_type>
            <region_type_full>город</region_type_full>
            <region>Москва</region>
            <area_with_type/>
            <area_type/>
            <area_type_full/>
            <area/>
            <city_with_type>г Москва</city_with_type>
            <city_type>г</city_type>
            <city_type_full>город</city_type_full>
            <city>Москва</city>
            <city_district/>
            <settlement_with_type/>
            <settlement_type/>
            <settlement_type_full/>
            <settlement/>
            <street_with_type>ул Трехгорный Вал</street_with_type>
            <street_type>ул</street_type>
            <street_type_full>улица</street_type_full>
            <street>Трехгорный Вал</street>
            <house_type/>
            <house_type_full/>
            <house/>
            <block_type/>
            <block/>
            <flat_area/>
            <flat_type/>
            <flat/>
            <fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</fias_id>
            <kladr_id>77000000000292300</kladr_id>
            <tax_office>7703</tax_office>
            <tax_office_legal/>
            <okato>45286575000</okato>
            <oktmo>45380000</oktmo>
            <geo_lat>55.7604033</geo_lat>
            <geo_lon>37.5610847</geo_lon>
            <unparsed_parts/>
            <qc/>
        </data>
    </suggestions>
</SuggestResponse>