Repolode
Enviar
daimon3332

daimon3332/address

Generador de direcciones autoalojado que devuelve direcciones reales de registros oficiales y datos cartográficos abiertos de 27 países y regiones.

Ver en GitHubSitio web
Estrellas
2,132
Forks
336
Issues abiertos
1
Último commit
hace 3 días

¿Qué es?

Address genera direcciones para pruebas y demostraciones que corresponden a lugares reales, en lugar de combinar cadenas al azar. Cada registro procede de un registro oficial de direcciones, de datos cartográficos abiertos o de un resultado de geocodificación validado, e incluye su fuente, precisión y coordenadas. Los campos sin datos se dejan vacíos en vez de completarse.

El proyecto se despliega con un único archivo de Docker Compose que ejecuta la aplicación web, PostgreSQL, las migraciones y un servicio de sincronización en segundo plano. Ofrece filtros por región, ciudad, distrito y código postal que respetan la jerarquía administrativa de cada país, resultados en diez idiomas de visualización y una consola de administración para gestionar fuentes, tokens de API y controles de acceso. Una API JSON con autenticación Bearer permite generar direcciones individuales y por lotes, buscar ubicaciones, consultar la cobertura y traducir direcciones; también incluye un documento OpenAPI 3.1.

Las direcciones se pueden copiar, exportar, guardar o abrir en Google Maps o AMap. Las claves opcionales de terceros amplían los datos de países específicos o permiten la traducción en línea.

Funciones clave

  • 01Cubre 27 países y regiones, con filtros que respetan la jerarquía administrativa de cada país.
  • 02Cada dirección incluye su fuente, la precisión de coincidencia y las coordenadas.
  • 03Los resultados están disponibles en diez idiomas de visualización, incluidos varios idiomas chinos, japonés, coreano y lenguas europeas.
  • 04Sincronización incremental en segundo plano con límites de reintentos y detección del agotamiento de las fuentes.
  • 05API con autenticación Bearer para generar direcciones individuales y por lotes, buscar ubicaciones y traducir.
  • 06Despliegue con un único Docker Compose que genera sus propios secretos al iniciarse por primera vez.

Casos de uso

  • Completar formularios de pago y registro con datos de prueba.
  • Validar formatos de dirección de varios países.
  • Crear direcciones realistas para demostraciones de logística o cartografía.
  • Generar lotes de direcciones mediante la API para flujos de pruebas.

Inicio rápido

  1. 1

    Descarga el archivo de Docker Compose

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

    Inicia todos los servicios

    docker compose up -d
  3. 3

    Comprueba que esté listo

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

Antes de usarlo

  • Requiere Linux (AMD64 o ARM64) con Docker Engine 24 o posterior y Compose v2.
  • Necesita al menos 4 GB de RAM. Se recomiendan 8 GB o más para la primera importación de países con muchos datos.
  • Los conjuntos de datos de origen tienen sus propias licencias y requisitos de atribución.

En colecciones

Apps autoalojadas

Temas

#address-generation#mock-data#test-data#self-hosted#geocoding#openstreetmap#docker#api#address#address-generator

Preguntas frecuentes

¿Qué es address?
Generador de direcciones autoalojado que devuelve direcciones reales de registros oficiales y datos cartográficos abiertos de 27 países y regiones. Address genera direcciones para pruebas y demostraciones que corresponden a lugares reales, en lugar de combinar cadenas al azar. Cada registro procede de un registro oficial de direcciones, de datos cartográficos abiertos o de un resultado de geocodificación validado, e incluye su fuente, precisión y coordenadas. Los campos sin datos se dejan vacíos en vez de completarse.
¿address es gratuito? ¿Qué licencia tiene?
address es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿address sigue mantenido?
Mantenimiento activo. El último commit de address fue el 4 nov 2026.
¿Para qué puedo usar address?
Completar formularios de pago y registro con datos de prueba. Validar formatos de dirección de varios países. Crear direcciones realistas para demostraciones de logística o cartografía. Generar lotes de direcciones mediante la API para flujos de pruebas.
¿Cómo se instala address?
Descarga el archivo de Docker Compose: curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml Inicia todos los servicios: docker compose up -d Comprueba que esté listo: curl -fsS http://127.0.0.1:8787/api/v1/ready
¿Dónde consigo address?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/daimon3332/address

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados