Стандартизация адресов
API проверяет адреса по актуальной базе ФИАС. Добавляет почтовый индекс, ФИАС-ID, координаты, коды ОКАТО/ОКТМО. Обновление базы — еженедельно.
Вход
"москва ленинский 42"Результат
{
"region": "Москва",
"city": "Москва",
"street": "Ленинский проспект",
"house": "42",
"postal_code": "119334",
"fias_id": "0c5b2444-...",
"geo_lat": 55.7023,
"geo_lon": 37.5871,
"is_valid": true
}Проблема
Адреса в базах данных — хаос:
- «Ленинский пр-т» vs «Ленинский проспект» vs «пр. Ленинский»
- Устаревшие названия улиц и районов
- Опечатки и сокращения
- Отсутствие индекса или неверный индекс
- Несуществующие адреса (ошибки ввода)
Результат: возвраты посылок, письма на несуществующие адреса, проблемы с геолокацией. По статистике логистических компаний, до 8% посылок возвращаются из-за ошибок в адресе.
Попробуйте сами
Что делает API
- ✓Разбирает адрес на компоненты (регион, город, улица, дом)
- ✓Проверяет по базе ФИАС/ГАР и возвращает fias_id
- ✓Определяет почтовый индекс
- ✓Обрабатывает транслит: Moskovskaya obl → Московская обл
- ✓Переводит английские названия: Moscow → Москва
- ✓Нормализует сокращения: г. Мск → г. Москва
- ✓Возвращает код качества (QC) для оценки результата
В планах (TODO)
- ○Геокодирование (координаты по адресу)
- ○Обратное геокодирование (адрес по координатам)
- ○Подсказки при вводе
- ○Определение часового пояса
- ○Проверка актуальности адреса
Как работает
Двухэтапная обработка:
- NER-разметка: модель на базе RuBERT определяет, где регион, город, улица, дом
- Проверка по ФИАС: сверка с официальной базой адресов России
- Дополнение данных: индекс, координаты, коды классификаторов
- Валидация: проверка существования адреса
База ФИАС обновляется еженедельно из официального источника ФНС. Содержит 60+ млн адресных объектов.
Возможности
Проверка по ФИАС
Валидация существования адреса в официальной базе
Почтовый индекс
Автодополнение или проверка существующего
ФИАС-идентификаторы
Уникальные ID для интеграции с госсервисами
ОКАТО/ОКТМО
Коды для налоговой и статистической отчётности
Координаты
Широта и долгота для геолокации
Стандартизация
Единый формат написания адреса
Batch-обработка
До 100 адресов в одном запросе
Альтернативы
Варианты при неточном совпадении
Примеры кода
curl
curl -X POST https://api.humandata.ru/v1/address/clean \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "москва ленинский 42"}'Python
import requests
response = requests.post(
"https://api.humandata.ru/v1/address/clean",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"query": "москва ленинский 42"}
)
result = response.json()
print(result["postal_code"]) # 119334
print(result["is_valid"]) # TrueJavaScript
const response = await fetch("https://api.humandata.ru/v1/address/clean", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({ query: "москва ленинский 42" })
});
const result = await response.json();
console.log(result.postal_code); // 119334Кейсы использования
Частые вопросы
Как часто обновляется база ФИАС?
Еженедельно. Мы загружаем дельта-обновления из официального источника ФНС каждый понедельник.
Что если адрес существует, но его нет в ФИАС?
Такое бывает с новостройками и недавно присвоёнными адресами. API вернёт is_valid: false, но попытается разобрать структуру. Рекомендуем проверить адрес через 1-2 недели после присвоения.
Поддерживаются ли адреса СНГ?
Только Россия. ФИАС — это база адресов РФ. Для других стран используйте специализированные сервисы.
Насколько точны координаты?
Координаты берутся из ФИАС. Точность зависит от уровня детализации: для домов — до дома, для улиц — центр улицы. Для критичной геолокации рекомендуем дополнительные источники.
Попробуйте бесплатно
1000 запросов в месяц — без оплаты. Достаточно для тестирования и небольших проектов.