АКАлександр Ковалев

Открытый проект / beta

GAR Service

Самостоятельно разворачиваемый сервис для загрузки Государственного адресного реестра в локальную PostgreSQL-базу и поиска адресов через REST API, CLI и PHP.

Контур сервисаbeta
01 / импортXML-выгрузки ГАР
02 / хранениеЛокальная PostgreSQL
03 / использованиеREST API · CLI · TUI
GoApache-2.0

01 / описание

ГАР и сервис адресов в вашем контуре

Государственный адресный реестр (ГАР) — государственный информационный ресурс со сведениями об адресах. Федеральная информационная адресная система (ФИАС) обеспечивает его формирование, ведение и использование.

GAR Service загружает XML-выгрузки ГАР в вашу локальную PostgreSQL-базу, применяет региональные дельты с возможностью отката, строит поисковый индекс и публикует REST API. Данные и поиск разделены по регионам, а версия фиксируется отдельно для каждого региона.

Развёртывание в собственной инфраструктуре даёт контроль над нагрузкой и доступностью API: работа не зависит от тарифов, ограничений или доступности внешних поставщиков адресных сервисов. При этом исходные данные ГАР по-прежнему получают из официального источника ФНС.

В одном приложении есть консольные команды, административный TUI и фоновые процессы для очереди заданий.

Контур
Локальная инфраструктура
Статус
Beta
Язык
Go
База данных
PostgreSQL 16+
Лицензия
Apache-2.0

02 / краткая инструкция

Начните с требований и README

Для запуска нужны Linux x86-64 или самостоятельная сборка, PostgreSQL 16+, расширения ltree и pg_trgm, а также официальный набор открытых данных ФНС. Адресные данные в репозиторий не входят.

  1. 01

    Клонировать и собрать

    Получите исходный код, соберите приложение и проверьте версию.

  2. 02

    Подготовить PostgreSQL

    Создайте базу и включите нужные расширения.

  3. 03

    Проверить и загрузить данные

    Запустите preflight, затем первичный импорт или фоновое задание.

03 / внедрение

Нужен GAR в вашей системе?

Опишите задачу: какие регионы нужны, откуда поступают данные и кто будет использовать API. Обсудим установку и подключение к вашему проекту.

Оставить заявку ↗