Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

asw

auto-sea-way es un sistema open source para cálculo de rutas marítimas entre cualquier par de coordenadas, construyendo un grafo global desde datos OSM con celdas H3 adaptativas.

Ficha actualizada 28 sept 2026, 0:46 · upstream 28 sept 2026, 0:31 · release v0.7.0

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es asw

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

auto-sea-way genera automáticamente un grafo de navegación marina derivado de polígonos terrestres de OpenStreetMap, indexando el océano con una cuadrícula hexagonal H3 de resolución adaptable: res-3 en aguas profundas hasta res-13 en estrechos y canales. El sistema clasifica celdas como navegables mediante eliminación jerárquica e intersección poligonal, construyendo aristas entre celdas adyacentes del mismo o diferente nivel de resolución.

El proyecto está escrito en Rust con una arquitectura modular: asw-core para estructuras de datos y algoritmos A*, asw-build para construcción del grafo desde shapefiles, asw-serve como servidor HTTP API con axum, asw-cloud para pipelines de construcción remota y asw-cli como punto de entrada CLI. El grafo se serializa a un archivo binario plano memory-mapped (formato v4) que puede incluirse en imágenes Docker o montarse externamente.

La API expone endpoints protegidos con X-Api-Key para calcular rutas (GeoJSON LineString), consultar metadatos del grafo y realizar probes de salud. El sistema detecta segmentos terrestres cuando los puntos de origen/destino están sobre tierra, reportándolos en land_legs sin incluirlos en la distancia nautical.

CASOS DE USO
  • Planificación de viajes marítimos para flotas comerciales
  • Cálculo de rutas óptimas entre puertos y coordenadas arbitrarias
  • Análisis logístico transoceánico con soporte a canales (Panamá, Suez)
  • Visualización de trayectorias en sistemas GIS o dashboards de seguimiento
PUNTOS DESTACADOS
  • Grafo generado dinámicamente desde OSM (~40M celdas) con detalle costero adaptativo
  • Rendimiento sub-segundo para rutas cortas (205us Canal Inglés, 681us Estrecho Gibraltar)
  • Despliegue self-hosted con API HTTP incluida y sin costes por solicitud
  • Licencia MIT/Apache 2.0 compatible con múltiples entornos de producción
PRECAUCIONES
  • Requiere archivo de grafo pre-construido (~1.5 GB para planeta completo) o tiempo de build inicial
  • Detección de segmentos terrestres limitada a proximidad costera, no puntos arbitrarios en tierra firme
  • Solo navegación marina; sin soporte multimodal (terrestre, aéreo)
  • Necesita 4 GB RAM mínimo para instancia completa con swap desaconsejado
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

San Francisco to Mykolaiv — maritime route computed through Panama Canal, Atlantic, Mediterranean, and Black SeaH3 hexagonal grid at Marmaris Bay — adaptive resolution from open water to coastline
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Docker detectado

Usa imagen full (ghcr.io/auto-sea-way/asw:0.7.0-full) para despliegue inmediato sin configuración adicional. Espera a que /ready devuelva 200 antes de enviar consultas. Configura ASW_API_KEY en entorno y expone puerto 3000. Para producción, planifica ~2.5 GB RSS total con 4 GB RAM mínimo. Verifica SHA256SUMS si usas binarios precompilados.

✓Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsRustPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
3000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.