daimon3332/address

Что это?

Ключевые возможности

• 01Охватывает 27 стран и регионов; фильтры учитывают административное деление каждой страны.
• 02Для каждого адреса указаны источник, точность совпадения и координаты.
• 03Доступен вывод на десяти языках, включая несколько китайских, японский, корейский и европейские языки.
• 04Фоновая инкрементальная синхронизация с ограничением числа повторных попыток и обнаружением исчерпания источника.
• 05API с аутентификацией по Bearer для генерации одного или нескольких адресов, поиска мест и перевода.
• 06Развёртывание с помощью одного файла Docker Compose; при первом запуске проект генерирует собственные секреты.

Сценарии использования

• Заполнение тестовых данных в формах оформления заказа и регистрации.
• Проверка форматов адресов в разных странах.
• Создание реалистичных адресов для демонстраций в сфере логистики или картографии.
• Генерация наборов адресов через API для конвейеров тестирования.

Быстрый старт

1. 1

   Скачайте файл Docker Compose

   curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml
2. 2

   Запустите все сервисы

   docker compose up -d
3. 3

   Проверьте готовность

   curl -fsS http://127.0.0.1:8787/api/v1/ready

Что важно знать

• !Требуется Linux (AMD64 или ARM64) с Docker Engine 24 или новее и Compose v2.
• !Необходимо не менее 4 ГБ ОЗУ. Для первого импорта данных по крупным странам рекомендуется 8 ГБ или больше.
• !Для исходных наборов данных действуют собственные лицензии и требования к указанию авторства.

В подборках

Темы

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

Что такое address?

Самостоятельно размещаемый генератор адресов, который возвращает реальные адреса из официальных реестров и открытых картографических данных для 27 стран и регионов. Address генерирует адреса для тестирования и демонстраций, которые соответствуют реальным местам, а не представляют собой случайно собранные строки. Каждая запись берётся из официального адресного реестра, открытых картографических данных или проверенного результата геокодирования и содержит источник, точность и координаты. Поля, для которых нет данных, остаются пустыми.

address можно использовать бесплатно? Какая у него лицензия?

address распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

address всё ещё поддерживается?

Активно поддерживается. Последний коммит в address — 4 нояб. 2026 г..

Для чего можно использовать address?

Заполнение тестовых данных в формах оформления заказа и регистрации. Проверка форматов адресов в разных странах. Создание реалистичных адресов для демонстраций в сфере логистики или картографии. Генерация наборов адресов через API для конвейеров тестирования.

Как установить address?

Скачайте файл Docker Compose: curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml Запустите все сервисы: docker compose up -d Проверьте готовность: curl -fsS http://127.0.0.1:8787/api/v1/ready

Где скачать address?

Исходный код и инструкции по установке — на GitHub: https://github.com/daimon3332/address