подсказки и стандартизация

Адреса по
ГАР/ФИАС

Подсказки при вводе и разбор адреса: индекс, КЛАДР/ОКАТО/ОКТМО, кадастровый номер и гео-координаты.

Документация →
123M+
адресов в базе
~6мс
ответ метода
ГАР
обновление ежедневно
POST
200 OKapplication/json, 7ms
{
"query": "г Москва, ул Мясницкая, д 13 стр 13",
"suggestions": [
{
"value": "г Москва, ул Мясницкая, д 13 стр 13",
"full": "101000, г Москва, ул Мясницкая, д 13 стр 13",
"level": "house",
"is_active": true,
"confidence": 0.9346,
"federal_district": "Центральный",
"address": {…}, 8 полей
"components": {…}, 10 полей
"codes": {…}, 9 полей
"fias_id": "d8b858f9-8d04-410e-b9e0-ae8691f9be7f",
"fias_level": 8,
"geo": {…}, 3 поля
"timezone": "UTC+3",
"metro": […], 2 элемента
"beltway_hit": "IN_MKAD",
"cadastral_num": "77:01:0001037:3099",
"cadastre": {…}, 11 полей
"cadastral_cost": 440225770.04,
"cadastral_cost_per_unit": 234799.6,
"history_values": […], 1 элемент
"match": {…}, 2 поля
"capital_marker": "2",
"flat_area": 26.1
}
]
}

Часть полей заполнена значениями из других записей — чтобы был виден полный формат ответа.

что вы получаете

Возможности адрес

Компоненты

Регион, город, улица и дом отдельными полями с типом.

Коды

Индекс, КЛАДР, ФИАС-id, ОКАТО, ОКТМО.

Гео и кадастр

Координаты с точностью и кадастровый номер.

Поля ответа 92

Наши методы отдают структурированный JSON: каждая сущность — отдельным объектом.

/v1/suggest/address/v1/find/address/v1/clean/address

Переходите с DaData — те же подсказки, поиск по идентификатору, стандартизация работают по привычным адресам в их формате. Менять код не нужно: другими будут только базовый адрес и заголовок авторизации.

/suggestions/api/4_1/rs/suggest/address/suggestions/api/4_1/rs/findById/address/api/v1/clean/address

Адрес одной строкойАдрес одной строкой с индексомУровеньДействующий объектУверенностьФедеральный округАдресЧасти адресаКоды классификаторовИдентификатор в ФИАСУровень адреса в ФИАСКоординатыЧасовой поясБлижайшее метроВнутри или снаружи МКАДКадастровый номерКадастровые сведенияКадастровая стоимостьКадастровая стоимость за единицуПрежние названияСовпадениеПризнак центра региона или районаПлощадь помещения

Адрес — регион, город, улица, дом, район, населённый пункт, земельный участок, квартира

Части адреса — регион, город, административный округ, район города, улица, дом, район, населённый пункт, земельный участок, квартира

Коды классификаторов — почтовый индекс, код кладр, код региона в кладр, код региона по iso, код окато, код октмо, налоговая инспекция, налоговая инспекция для организаций, код фиас

Координаты — широта, долгота, точность координат

Кадастровые сведения — тип, наименование объекта, район, год постройки, источник года постройки, год ввода в эксплуатацию, этажей, подземных этажей, материал стен, дата регистрации, этаж

Совпадение — регион, квартира

Источник: ГАР/ФИАС, ФНС России — открытые данные.

Разбор по полям

Один запрос — структурированный результат: каждое поле отдельно, готово сразу в форму или базу.

запросг Москва, ул Мясницкая, д 13 с18
Индекс
101000
Регион
г Москва
Улица
ул Мясницкая
Дом
д 13 с18
ОКТМО
45378000
КЛАДР
7700000000071190097
ФИАС
ef24e814-…-a5c4c0cf193f
Кадастр
77:01:0001037:1069
Координаты
55.762924, 37.633271
о сервисе

Что такое подсказки адресов по ФИАС

Клиент вводит адрес в одно поле — вы получаете его в едином виде, пригодном для доставки, документов и отчётности. Сервис подсказывает адрес по мере набора и возвращает готовую строку вместе с разбором: регион, город, улица, дом, квартира. Рядом — почтовый индекс, коды КЛАДР и ФИАС, ОКАТО и ОКТМО для отчётности, координаты и кадастровый номер. Основа — государственный адресный реестр ГАР/ФИАС: 123,5 млн адресных объектов.

Как подключить подсказки адресов по ФИАС

Зарегистрируйтесь, получите ключ и добавьте подсказки в поле адреса — готовым виджетом или из своего кода. Дальше адрес приходит уже разобранным, с кодами и координатами. Накопленную базу приводят к реестру пакетно: загрузили строки — получили выверенные адреса. Работает и геокодирование, и обратная задача: по координатам сервис вернёт ближайший адрес. Подсказки входят в дневной лимит тарифа, на бесплатном — 10 000 запросов в сутки.

Что важно знать про подсказки адресов по ФИАС

Сервис работает по России и опирается на государственный адресный реестр: подсказка при вводе, разбор готовых строк, коды и координаты для документов и доставки. Подсказки идут по дневному лимиту тарифа, пакетная стандартизация — из предоплаченного пакета, 0,20 ₽ за запись. Характеристики объекта недвижимости — площадь, стоимость, год постройки — отдаёт кадастровый поиск.

API ФИАС: как обращаться к реестру

API ФИАС — это способ работать с государственным адресным реестром, не выгружая его к себе. Выгрузка ГАР/ФИАС — это десятки гигабайт, своя схема хранения, поиск с опечатками и ежедневные дельты, которые кто-то должен накатывать. Здесь реестр уже разобран: по коду ФИАС приходит актуальный адрес целиком, по строке — подсказка или разбор, по координатам — ближайший объект.

Чем подсказки адресов отличаются от автозаполнения браузера

Браузер подставляет то, что человек когда-то вводил сам, — вместе с опечатками и устаревшими названиями. Подсказки берут адрес из государственного реестра ГАР, поэтому в базу попадает действующий адрес с индексом и кодами КЛАДР, ОКАТО и ОКТМО. Разница видна на доставке: адрес из автозаполнения курьер разбирает глазами, адрес из реестра ложится в маршрут и в накладную без правок.

Как привести накопленную базу адресов в порядок

Адреса, которые копились годами, обычно лежат одной строкой и в разном написании: где-то «г. Москва», где-то «Москва г», где-то с индексом, где-то без. Пакетная обработка приводит их к реестру: на выходе единый вид, разбор на регион, город, улицу и дом, коды и координаты. После этого дубли видно, рассылка не возвращается, а отчёты по регионам наконец сходятся.

Автозаполнение адреса в форме заказа

Автозаполнение адреса, автодополнение, подсказки при вводе — в разных задачах это называют по-разному, речь об одном: человек набирает начало строки и выбирает готовый адрес из реестра. Форма из шести полей сворачивается в одно, индекс и коды приходят сами, а вместе с ними уходят опечатки, из-за которых заказ потом едет не туда.

Чистка и нормализация базы адресов

Чистка базы адресов, очистка, выверка, нормализация — задача одна: превратить разнобой строк в сопоставимые записи. К каждой записи приходит код качества разбора, поэтому база сразу делится на три части: что можно обновлять без просмотра, что показать оператору и что адресом вообще не является. Тихая подстановка «похожего» адреса хуже пустого поля, поэтому неуверенный результат помечается, а не выдаётся за точный.

Сколько стоит подключение подсказок адресов

Бесплатного объёма — 10 000 подсказок в день — хватает интернет-магазину со средним трафиком, и карта для него не нужна. Платные тарифы начинаются, когда объём вырастает: они поднимают дневной лимит и открывают дополнительные поля адреса. Пакетная обработка накопленной базы считается отдельно, по числу записей.

тарификация

Подсказки

Подсказки входят в дневной лимит тарифа и доступны на всех планах, включая бесплатный.

в подпискепо дневному лимиту
Все тарифы и цены →
сценарии

Где это полезно

пример заполнения и API

Адрес и контакты для доставки

Форма доставки с подсказками адреса: дом по ФИАС, индекс и город подставляются сами, ФИО и телефон получателя проверяются. Готовый пример и код API.

Посмотреть пример
пример заполнения и API

Адрес выездной услуги

Заявка на выезд мастера: подсказки адреса по ФИАС и координаты дома для маршрута заполняются сами после выбора подсказки. Пример формы и запрос к API.

Посмотреть пример
пример заполнения и API

Адрес для налоговых документов

Адрес для налоговых документов: подсказки по ФИАС заполняют ОКТМО, КЛАДР, код налоговой инспекции и идентификатор ФИАС. Пример формы и код API.

Посмотреть пример
пример заполнения и API

Зона курьерской доставки

Зона курьерской доставки по адресу: API показывает, внутри МКАД ли дом, ближайшее метро и часовой пояс получателя. Пример формы и код подключения.

Посмотреть пример
вопросы

Частые вопросы про подсказки адресов по ФИАС

Сколько это стоит?
Подсказки входят в дневной лимит тарифа: на бесплатном это 10 000 запросов в сутки. Пакетная стандартизация базы оплачивается отдельно — 0,20 ₽ за запись из предоплаченного пакета.
Подойдёт ли, чтобы разом почистить накопленную базу адресов?
Да. Пакетная стандартизация принимает списки адресов и возвращает их в виде государственного реестра, вместе с кодами для отчётности.
Что нужно, чтобы подключить подсказки к форме?
Ключ после регистрации и несколько строк в вёрстке: готовый виджет встраивается в поле адреса. Нужен свой интерфейс — те же данные доступны из вашего кода.
Мы переходим с DaData — придётся переписывать код?
Нет. Адресные методы отвечают в совместимом формате: достаточно поменять адрес сервиса и ключ.
по теме

Статьи про подсказки адресов по ФИАС

Адрес в форме: одна строка вместо шести полей, индекс и город — самиРегион, город, улица, дом, квартира, индекс — шесть полей и шесть шансов ошибиться. С подсказками человек набирает адрес в одной строке и выбирает дом из реестра, а индекс и город форма заполняет сама.Подсказки адресов на сайте: как подключитьШесть полей адреса в форме — это шесть шансов ошибиться и шесть причин её бросить. Подсказки сводят всё к одному полю. Ниже — два способа подключения и что оказывается на вашей стороне после выбора адреса.ФИАС и ГАР: чем отличаются и где брать адресаФИАС — государственный реестр адресов, ГАР — то, как его отдают наружу. Ниже: чем они отличаются на практике, какие коды живут внутри адреса и как получить адрес по коду, не выгружая реестр к себе.Аналог DaData: переход на hintdata.ruПодсказки и стандартизация адресов, организаций, ФИО, телефонов и почты. Формат ответа совместим, поэтому разбор данных на вашей стороне остаётся прежним.

Чистые данные за один запрос

Подключите подсказки в форму или вызовите API. Бесплатно до 10 000 запросов в день.

Документация