yesubzero/magi-ais-decoder repository overview

⁠MAGI AIS Decoder

El MAGI AIS Decoder es una solución potente y flexible diseñada para recibir, decodificar y procesar mensajes AIS (Automatic Identification System) en tiempo real. La imagen Docker implementa un servicio que escucha mensajes AIS en formato NMEA a través de un puerto UDP, los decodifica en formato JSON, enriquece los datos con descripciones legibles y los publica en un clúster Kafka para un procesamiento continuo.

⁠Características

• Recepción UDP: Recoge mensajes AIS en tiempo real desde cualquier fuente que utilice protocolos UDP.
• Decodificación NMEA: Transforma mensajes AIS en estructuras JSON detalladas utilizando la biblioteca pyais.
• Mapeo descriptivo: Convierte códigos AIS, como el tipo de embarcación o estado de navegación, en descripciones completas.
• Publicación en Kafka: Integra directamente con Kafka para permitir análisis y almacenamiento en tiempo real.
• Optimizado para IoT marítimo: Ideal para sistemas de monitoreo de tráfico marítimo, aplicaciones de seguridad y análisis logístico.

⁠Requisitos

• Clúster Kafka: Un servidor Kafka accesible para recibir los datos procesados.
• Red UDP habilitada: Configuración de red para permitir la recepción de mensajes en un puerto definido.

⁠Cómo Empezar

⁠1. Pull de la Imagen

docker pull yesubzero/magi-ais-decoder

⁠2. Ejecución Básica

Ejecuta el contenedor para escuchar mensajes AIS en el puerto 10110 y enviar datos al clúster Kafka configurado:

docker run -it -p 10110:10110 yesubzero/magi-ais-decoder

⁠Docker Compose

services:
  ais-decoder:
    image: yesubzero/magi-ais-decoder:latest
    container_name: ais-decoder 
    ports:
      - "10110:10110/udp" # UDP Port
    restart: always