Быстрый ввод адресов по фиас

 

Ищет адреса в строгом соответствии с ФИАС. Ищет адреса в строгом соответствии с ФИАС.

Примеры и интеграции

  • C# / .NET
  • Excel VBA
  • Go
  • Java
  • Laravel (PHP 7.4)
  • Laravel (PHP 5.5+)
  • PHP
  • PHP (одним файлом)
  • Python
  • R
  • Symfony
  • 1С: адреса
  • 1С 7.7: адреса
  • ApiShip + 1C
  • LeadVertex
  • Woocommerce

Коды качества

Код проверки qc

Нужно ли вручную проверить распознанный адрес:

Код пригодности к рассылке qc_complete

Годится ли адрес для доставки корреспонденции:

Признак наличия дома в ФИАС qc_house и код точности координат qc_geo

Уточняют вероятность успешной доставки письма:

Код точности координат qc_geo

Точность координат адреса для курьерской доставки:

Что в ответе

Объект с массивом подсказок в поле suggestions:

Пример ответа { "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": "32fcb102-2a50-44c9-a00e-806420f448ea", "street_kladr_id": "77000000000713400", "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": "32fcb102-2a50-44c9-a00e-806420f448ea", "fias_code": "7700000000000007134", "fias_level": "7", "fias_actuality_state": "0", "kladr_id": "77000000000713400", "capital_marker": "0", "okato": "45263564000", "oktmo": "45305000", "cadastral_number": null, "tax_office": "7718", "tax_office_legal": "7718", "history_values": [ "ул Черненко" ], "source": null, "qc": null } }, ... ] }
  • Symfony
  • Источник данных: Федеральная информационная адресная система (ФИАС) Налоговой службы.

    Как подключить

    1. Зарегистрируйтесь и получите API-ключ
    2. Вставьте код из примера на свой сайт.
    3. Profit!
    <input id="address" name="address" type="text" /> <script src=""></script> <link href="@" rel="stylesheet" /> <script src="@"></script> <script> $("#address").suggestions({ token: "${API_KEY}", type: "FIAS", /* Вызывается, когда пользователь выбирает одну из подсказок */ onSelect: function(suggestion) { (suggestion); } }); </script>

    Параметр token — это API-ключ.

    Примеры вызова

    Заголовки и параметры

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

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

    • Angular
    • C# / .NET
    • Excel VBA
    • Go
    • Java (Spring)
    • Laravel (PHP 7.4)
    • Laravel (PHP 5.5+)
    • PHP
    • PHP (одним файлом)
    • Python
    • R
    • React
    • XmlHttpRequest

    Как вызвать

    Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

    Пример запроса:

    cURL curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Token ${API_KEY}" \ -H "X-Secret: ${SECRET_KEY}" \ -d '[ "мск сухонска 11/-89" ]' \ .NET // var token = "${API_KEY}"; var secret = "${SECRET_KEY}"; var api = new CleanClientAsync(token, secret); var result = await <Address>("мск сухонска 11/-89"); Go // // Использует API-ключ из переменной окружения DADATA_API_KEY, // а секретный ключ из переменной окружения DADATA_SECRET_KEY import ( "context" dadata "" ) func main() { api := () query := "мск сухонска 11/-89" result, err := ((), query) } var url = ""; var token = "${API_KEY}"; var secret = "${SECRET_KEY}"; var query = "мск сухонска 11/-89"; var options = { method: "POST", mode: "cors", headers: { "Content-Type": "application/json", "Authorization": "Token " + token, "X-Secret": secret }, body: ([query]) } fetch(url, options) .then(response => ()) .then(result => (result)) .catch(error => ("error", error)); PHP // $token = "${API_KEY}"; $secret = "${SECRET_KEY}"; $dadata = new \Dadata\DadataClient($token, $secret); $result = $dadata->clean("address", "мск сухонска 11/-89"); Python # from dadata import Dadata token = "${API_KEY}" secret = "${SECRET_KEY}" dadata = Dadata(token, secret) result = ("address", "мск сухонска 11/-89")

    Укажите при вызове:

    • Content-Type: application/json.
    • ${API_KEY} — API-ключ.
    • ${SECRET_KEY} — секретный ключ.

    Тело запроса передавайте в кодировке UTF-8.

    Частые вопросы

    По адресам

    Почему вернулся неправильный КЛАДР-код дома?

    Подсказки работают по справочнику адресов налоговой службы (ФИАС).
    В ФИАС нет кодов КЛАДР для домов.

    Поэтому код дома (последние четыре цифры в коде КЛАДР) подсказки берут из поля «Счетчик записей домов для КЛАДР 4» (COUNTER). Эти коды часто отличаются от указанных в КЛАДРе.

    Впрочем, в самом КЛАДРе с каждым обновлением базы коды домов меняются, поэтому использовать их в качестве «постоянного» идентификатора адреса невозможно.

    Как часто обновляется справочник адресов (ФИАС)?

    Один раз в неделю, на выходных.

    Общие

    Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)

    Возможные причины:

    • Не подтверждён адрес эл. почты. Проверьте в личном кабинете. Если почта не подтверждена — посмотрите почтовый ящик и папку «спам», там должно быть письмо от «Дадаты».
    • В запросе указан неправильный API-ключ. Проверьте в личном кабинете
    • Исчерпан лимит запросов на день. Проверьте в личном кабинете
    • Вы делаете запросы с сервера, при этом настроена привязка к домену. Отключите привязку к домену, либо делайте запросы из браузера.
    Что будет, если превысить 10 000 бесплатных запросов в день?

    Подсказки перестанут подсказывать ツ До начала нового дня, затем снова заработают.

    10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы...

    Источники

    Использованные источники информации при написании статьи:

    • https://dadata.ru/api/clean/address/
    • https://dadata.ru/api/suggest/fias/
    • https://dadata.ru/suggestions/usage/fias/
    0 из 5. Оценок: 0.

    Комментарии (0)

    Поделитесь своим мнением о статье.

    Ещё никто не оставил комментария, вы будете первым.


    Написать комментарий