Что такое ФИАС и зачем он нужен
ФИАС в двух словах
ФИАС (Федеральная информационная адресная система) — единственный официальный справочник адресов России. Ведёт ФНС. Содержит 50+ млн адресных объектов: от регионов до квартир.
КЛАДР устарел. С 2017 года не обновляется. Если ваша система ещё использует КЛАДР — пора переходить на ФИАС.
Структура ФИАС
ФИАС — иерархическая система. Каждый объект вложен в родительский:
Россия
└── Московская область
└── г. Москва
└── ул. Ленинский проспект
└── д. 42
└── кв. 15
Уровни адресации:
- 1 — Регион (Москва, Московская область)
- 2 — Район / Административный округ
- 3 — Город
- 4 — Населённый пункт
- 5 — Улица
- 6 — Дом
- 7 — Квартира / Помещение
Идентификаторы в ФИАС
Каждый объект имеет уникальный идентификатор:
| Поле | Назначение | Пример |
|---|---|---|
OBJECTID | Уникальный ID объекта | 123456 |
OBJECTGUID | UUID объекта | a8c9b1e0-1234-5678-... |
PARENTOBJID | ID родительского объекта | 123400 |
Важно: OBJECTGUID — стабильный идентификатор. Используйте его для хранения в БД. OBJECTID может измениться при обновлениях.
Чем ФИАС лучше КЛАДР
| Критерий | ФИАС | КЛАДР |
|---|---|---|
| Статус | Актуальный | Устаревший (с 2017) |
| Обновления | Еженедельно | Не обновляется |
| Детализация | До квартиры | До дома |
| Структура | Иерархическая | Плоская |
| Координаты | Есть (частично) | Нет |
Где скачать ФИАС
Официальный источник: fias.nalog.ru
Форматы:
- XML — полная выгрузка (~10 GB в архиве)
- DBF — для совместимости со старыми системами
- Delta — инкрементальные обновления (еженедельно)
Как использовать ФИАС в проекте
Вариант 1: Развернуть локально
Плюсы: полный контроль, работает офлайн Минусы: нужен сервер, обновления вручную
-- PostgreSQL: поиск адреса
SELECT * FROM fias_objects
WHERE name ILIKE '%ленинский%'
AND level = 5
LIMIT 10;
Вариант 2: Использовать API
Плюсы: не нужен свой сервер, всегда актуальные данные Минусы: зависимость от внешнего сервиса
# HumanData API: поиск адреса
curl "https://api.humandata.ru/v1/suggest?query=москва+ленинский" \
-H "Authorization: Bearer YOUR_API_KEY"
Частые вопросы
Обязательно ли использовать ФИАС?
Для государственных систем — да. ФЗ-443 требует использовать ФИАС для адресов в госреестрах.
Для коммерческих проектов — рекомендуется. ФИАС даёт единообразие и актуальность данных.
Как часто обновлять базу?
ФИАС обновляется еженедельно. Для большинства проектов достаточно обновлять раз в месяц. Для критичных систем (логистика, госуслуги) — еженедельно.
Что делать с адресами не из ФИАС?
Некоторые адреса отсутствуют в ФИАС: новостройки, садовые товарищества, временные объекты. Варианты:
- Хранить как есть с пометкой «не верифицирован»
- Ждать появления в ФИАС
- Использовать ближайший родительский объект (улица без дома)
Итого
- ФИАС — официальный справочник адресов России
- КЛАДР устарел, переходите на ФИАС
- Храните OBJECTGUID, не OBJECTID
- Обновляйте базу минимум раз в месяц
- Для быстрого старта используйте API вместо локальной базы