Saltar al contenido principal

Inicio rápido: instala GeoLens localmente

Sigue estos pasos para pasar de curl -fsSL https://getgeolens.com/install.sh | sh a una instancia GeoLens completamente operativa con acceso de administrador y tu primer dataset cargado. No se requieren cuentas en la nube: todo se ejecuta localmente con Docker Compose.

La mayoría de las instalaciones están en marcha en pocos minutos; una compilación desde el código fuente tarda de 5 a 10 minutos.

¿Aún no quieres ejecutar Docker? Sáltate la instalación y explora la demo en vivo

Requisitos previos

  • ✓ Git y curl - el instalador clona el repositorio y descarga por HTTPS
  • ✓ Docker Engine 24.0+ - desde Docker Desktop o los paquetes de Docker Engine
  • ✓ Docker Compose v2.20+ - incluido en las versiones actuales de Docker Desktop, o instala el plugin compose aparte
  • ✓ Memoria: - 8 GB o más disponibles para Docker: el instalador avisa por debajo de 7 GB
  • ✓ Puertos locales abiertos: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Paso 1: Ejecutar el instalador público

Primera ejecución recomendada:

curl -fsSL https://getgeolens.com/install.sh | sh

El instalador clona en un directorio geolens. Ejecuta el resto de comandos de esta página desde dentro de él:

cd geolens

¿Prefieres un checkout del código fuente o el tarball de una versión? Clona el repositorio y ejecuta bash scripts/install.sh desde él. Instalar desde el código fuente (se abre en una pestaña nueva)

Paso 2: Iniciar sesión

Abre la interfaz de GeoLens en tu navegador:

http://localhost:8080

Inicia sesión con el usuario administrador (predeterminado: admin) y la contraseña que configuraste o que generó el instalador:

  • Usuario: admin
  • Contraseña: la contraseña que configuraste o la generada

Para mostrar una contraseña generada, ejecuta esto desde el directorio geolens:

grep '^GEOLENS_ADMIN_PASSWORD=' .env

El instalador espera a que todos los servicios estén en buen estado. Para comprobarlos tú mismo, ejecuta docker compose ps.

¿Vas más allá de una prueba local? Elige una contraseña de administrador robusta cuando el instalador la pida y luego lee la guía de despliegue en la nube (se abre en una pestaña nueva).

El catálogo estará vacío después de una instalación nueva; es lo esperado. Carga tu primer dataset en el siguiente paso.

Paso 3: Cargar tu primer dataset

Descarga una muestra pequeña de dominio público: shapefile de países Natural Earth 1:110m y cárgala mediante la interfaz de GeoLens.

curl -LO https://naturalearth.s3.amazonaws.com/110m_cultural/ne_110m_admin_0_countries.zip

En la interfaz de GeoLens, haz clic en Crear en el encabezado, elige Importar datos y selecciona el archivo ZIP. GeoLens detecta el CRS (EPSG:4326) y el esquema; confirma la importación para publicar. El dataset aparece en la búsqueda del catálogo. Las importaciones son privadas de forma predeterminada, así que la OGC API en http://localhost:8080/api/collections solo lo lista en solicitudes autenticadas (envía un token de portador) o cuando hagas público el dataset. Abrir esa dirección en el navegador es una solicitud anónima, así que solo muestra la colección del catálogo.

La muestra de Natural Earth incluye la Antártida, por lo que la importación recorta dos entidades en el límite de Web Mercator y la página del dataset muestra una advertencia sobre las coordenadas de origen. Con esta muestra la advertencia es lo esperado.

Lo que verás

Después del paso 3, el dataset que subiste aparece en el catálogo GeoLens. A medida que agregas más datos, el catálogo se llena como el de abajo: tarjetas de datasets con búsqueda, insignias de tipo y filtros por facetas. La vista previa del mapa, el panel de metadatos y los endpoints OGC API en http://localhost:8080/api/collections están activos; los datasets privados solo aparecen ahí en solicitudes autenticadas. Usa la barra de búsqueda para filtrar datasets, abre una tarjeta para ver metadatos y entra al constructor de mapas para componer mapas multicapa.

El catálogo de GeoLens sin sesión iniciada y sin consulta escrita: tarjetas de datasets (vectoriales) con insignias de tipo y miniaturas, una barra lateral de filtros con tipo, palabras clave, colección, ubicación, fechas y organización, y la barra de búsqueda, con un botón Sign In en la cabecera

Paso 4 (opcional): Cargar los mapas de demostración

¿Prefieres un catálogo completo en vez de un solo dataset? El repositorio incluye un script que construye siete mapas de demostración con datos abiertos públicos, incluido el horizonte 3D de Manhattan de la portada, además de una historia publicada y un mapa con panel. Desde el directorio geolens que creó el instalador:

pip install httpx
python scripts/seed-showcase.py --username admin --password "$(grep '^GEOLENS_ADMIN_PASSWORD=' .env | cut -d= -f2-)"

Requiere acceso a internet a las fuentes de datos abiertos.

Solución de problemas

Siguientes pasos