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

Запрос

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

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

Заголовки

Заголовок

Описание

Content-Type

Тип данных в запроосе: application/json или application/xml

Accept

Тип данных в ответе: application/json или application/xml

Authorization

API-ключ в формате: Token ${API_KEY}

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

Параметры

Параметр	Обязательный?	Описание
`query`	да	Запрос, для которого нужно получить подсказки
count	нет	Количество возвращаемых подсказок (если не указано, используется значение по умолчанию).
locations	нет	Ограничение области поиска.

Ответ

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

Примеры

Запрос

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

Ответ:

{
    "suggestions": [
        {
            "value": "г Москва, Серпуховская пл",
            "unrestricted_value": "г Москва, Серпуховская пл",
            "data": {
                "qc_complete": null,
                "qc_house": null,
                "postal_code": "115184",
                "postal_box": null,
                "country": "Россия",
                "region_type": "г",
                "region_type_full": "город",
                "region": "Москва",
                "area_type": null,
                "area_type_full": null,
                "area": null,
                "city_type": null,
                "city_type_full": null,
                "city": null,
                "settlement_type": null,
                "settlement_type_full": null,
                "settlement": null,
                "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,
                "tax_office": "7705",
                "kladr_id": "77000000000702000",
                "okato": "45286560000",
                "oktmo": null,
                "unparsed_parts": null,
                "qc": null
            }
        },
        {
            "value": "г Москва, ул Серпуховская Б.",
            "unrestricted_value": "г Москва, ул Серпуховская Б.",
            "data": {
                "qc_complete": null,
                "qc_house": null,
                "postal_code": "115093",
                "postal_box": null,
                "country": "Россия",
                "region_type": "г",
                "region_type_full": "город",
                "region": "Москва",
                "area_type": null,
                "area_type_full": null,
                "area": null,
                "city_type": null,
                "city_type_full": null,
                "city": null,
                "settlement_type": null,
                "settlement_type_full": null,
                "settlement": null,
                "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,
                "tax_office": "",
                "kladr_id": "77000000000262500",
                "okato": "",
                "oktmo": null,
                "unparsed_parts": null,
                "qc": null
            }
        },
        {
            "value": "г Москва, пл Серпуховская Застава",
            "unrestricted_value": "г Москва, пл Серпуховская Застава",
            "data": {
                "qc_complete": null,
                "qc_house": null,
                "postal_code": "115191",
                "postal_box": null,
                "country": "Россия",
                "region_type": "г",
                "region_type_full": "город",
                "region": "Москва",
                "area_type": null,
                "area_type_full": null,
                "area": null,
                "city_type": null,
                "city_type_full": null,
                "city": null,
                "settlement_type": null,
                "settlement_type_full": null,
                "settlement": null,
                "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,
                "tax_office": "7725",
                "kladr_id": "77000000000262600",
                "okato": "45296559000",
                "oktmo": null,
                "unparsed_parts": null,
                "qc": null
            }
        }
  ]
}

Запрос:

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

Ответ:

<SuggestAddressResponse>
    <suggestions>
        <value>г Москва, Серпуховская пл</value>
        <unrestricted_value>г Москва, Серпуховская пл</unrestricted_value>
        <data>
            <qc_complete/>
            <qc_house/>
            <postal_code>115184</postal_code>
            <postal_box/>
            <country>Россия</country>
            <region_type>г</region_type>
            <region_type_full>город</region_type_full>
            <region>Москва</region>
            <area_type/>
            <area_type_full/>
            <area/>
            <city_type/>
            <city_type_full/>
            <city/>
            <settlement_type/>
            <settlement_type_full/>
            <settlement/>
            <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/>
            <tax_office>7705</tax_office>
            <kladr_id>77000000000702000</kladr_id>
            <okato>45286560000</okato>
            <oktmo/>
            <unparsed_parts/>
            <qc/>
        </data>
    </suggestions>
    <suggestions>
        <value>г Москва, ул Серпуховская Б.</value>
        <unrestricted_value>г Москва, ул Серпуховская Б.</unrestricted_value>
        <data>
            <qc_complete/>
            <qc_house/>
            <postal_code>115093</postal_code>
            <postal_box/>
            <country>Россия</country>
            <region_type>г</region_type>
            <region_type_full>город</region_type_full>
            <region>Москва</region>
            <area_type/>
            <area_type_full/>
            <area/>
            <city_type/>
            <city_type_full/>
            <city/>
            <settlement_type/>
            <settlement_type_full/>
            <settlement/>
            <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/>
            <tax_office></tax_office>
            <kladr_id>77000000000262500</kladr_id>
            <okato></okato>
            <oktmo/>
            <unparsed_parts/>
            <qc/>
        </data>
    </suggestions>
    <suggestions>
        <value>г Москва, пл Серпуховская Застава</value>
        <unrestricted_value>г Москва, пл Серпуховская Застава</unrestricted_value>
        <data>
            <qc_complete/>
            <qc_house/>
            <postal_code>115191</postal_code>
            <postal_box/>
            <country>Россия</country>
            <region_type>г</region_type>
            <region_type_full>город</region_type_full>
            <region>Москва</region>
            <area_type/>
            <area_type_full/>
            <area/>
            <city_type/>
            <city_type_full/>
            <city/>
            <settlement_type/>
            <settlement_type_full/>
            <settlement/>
            <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/>
            <tax_office>7725</tax_office>
            <kladr_id>77000000000262600</kladr_id>
            <okato>45296559000</okato>
            <oktmo/>
            <unparsed_parts/>
            <qc/>
        </data>
    </suggestions>
</SuggestAddressResponse>