AIS Integration & OpenCPN — Architecture Guide

Penyedia API AIS Real-Time

Klik setiap provider untuk melihat detail endpoint, pricing, dan contoh kode integrasi.

Integrasi Langsung dengan OpenCPN

Cara menghubungkan data AIS ke OpenCPN, baik via plugin maupun NMEA TCP.

NMEA TCP Server

Cara paling umum & reliable

Jalankan script yang pull data dari AIS API, convert ke format NMEA !AIVDM, lalu serve via TCP port 10110. OpenCPN terima sebagai sumber AIS.

# ais_to_nmea.py — Minimal AIS → NMEA bridge
import socket
import json
import requests
from aislib import encode_ais

API_KEY = "your-api-key"
AREA = {"minlat": -7, "maxlat": -5,
        "minlon": 105, "maxlon": 115}

def fetch_ais():
    r = requests.get(
        "https://api.aisstream.io/v1/vessels",
        params={"api_key": API_KEY, **AREA},
        headers={"Accept": "text/event-stream"},
        stream=True
    )
    for line in r.iter_lines():
        if line:
            data = json.loads(line)
            yield encode_ais(data)

def serve_tcp(port=10110):
    srv = socket.socket(AF_INET, SOCK_STREAM)
    srv.setsockopt(SOL_SOCKET, SO_REUSEADDR, 1)
    srv.bind(("0.0.0.0", port))
    srv.listen(5)
    print(f"NMEA serving on :{port}")
    while True:
        conn, addr = srv.accept()
        for nmea in fetch_ais():
            conn.sendall((nmea + "\r\n").encode())
      

OpenCPN Settings

Options → Connections → Add Connection
Type: Network
Protocol: TCP
Address: localhost (atau IP server)
Port: 10110
Data: Check "AIS"

OpenCPN Plugin API

Custom plugin untuk API langsung

Buat plugin OpenCPN native (C++) yang langsung consume AIS API tanpa middleware terpisah. Lebih kompleks tapi lebih clean.

// ais_api_plugin.cpp (simplified)
class AISStreamPlugin : public opencpn_plugin {
  void OnAISMessage(AIS_Msgs* msg) {
    // Parse AIS message dari API stream
    if (msg->type == 1 || msg->type == 2
        || msg->type == 3) {
      AddAISTarget(
        msg->mmsi,
        msg->lat, msg->lon,
        msg->cog, msg->sog,
        msg->heading, msg->name
      );
    }
  }
};
        

VDR File Playback

Untuk testing & replay

Simpan data AIS yang sudah di-capture ke file .txt berisi NMEA sentences, lalu replay di OpenCPN via VDR plugin.

# Convert & save to VDR format
with open("ais_replay.txt", "w") as f:
    for nmea in fetch_ais():
        timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
        f.write(f"$TIMESTAMP,{timestamp}\n")
        f.write(nmea + "\n")

# Di OpenCPN: VDR plugin → Load file
        

Plugin OpenCPN Terkait AIS

aisradar_opc Radar-style AIS display

AIS Targets Alarm CPA/TCPA alerting

VDR (Voyage Data Recorder) Record & replay NMEA

nmea0183 multiplexer Combine multiple NMEA sources

Perbandingan Penyedia AIS

Tabel perbandingan fitur, cakupan, harga, dan kemudahan integrasi.

Provider	Tipe	Cakupan	Update Rate	Format Output	Free Tier	Harga Paid	OpenCPN Ready	Best For

Rekomendasi Berdasarkan Use Case

Prototyping / Development

AISstream (free tier generous) atau MarineTraffic (free demo key)

Indonesian Waters Only

Inmarsat via Pelindo/BASARNAS, atau AIS Indonesia (bila akses tersedia)

Production / Fleet Monitoring

Spire Maritime (satellite + terrestrial, enterprise API) atau VesselFinder Business

Budget-Constrained

Gunakan receiver AIS sendiri (RTL-SDR ~$30) + aisdecoder, gratis selamanya

DIY AIS Receiver (Gratis Selamanya)

Daripada berlangganan API, bisa pasang AIS receiver sendiri di lokasi. Total biaya awal sekitar $30-200, setelah itu gratis.

# Hardware yang dibutuhkan:
1. RTL-SDR dongle        ~$25
2. AIS antenna 162MHz   ~$15
3. Raspberry Pi / PC    ~$0 (sudah ada)

# Software stack:
$ sudo apt install rtl-sdr aisdecoder
$ rtl_ais -f 161975000 | aisdecoder -T "localhost:10110"

# Output langsung NMEA ke port 10110
# OpenCPN langsung bisa terima!
# Tidak perlu middleware sama sekali.
      

Keterbatasan: hanya coverage sekitar 20-40 NM dari lokasi receiver. Tidak mencakup laut lepas.

Networked AIS Station Sharing

Kamu bisa join jaringan volunteer AIS receiver untuk mendapat coverage lebih luas secara gratis.

# AISHub.net — Gratis, global network
# Kirim data receiver kamu, dapat akses semua data:

$ aisdecoder -T "localhost:10110" \
    | nc aishub.net 5321 "your_username"

# Lalu terima aggregate feed:
$ nc aishub.net 8321 "your_username" \
    | while read line; do
        echo "$line"  # NMEA !AIVDM
      done

# Output bisa di-pipe langsung ke
# OpenCPN via TCP port 10110
      

Alternatif serupa: ShipAIS.org, AISShare.net

Penyedia API AIS Real-Time

Arsitektur Integrasi AIS

Integrasi Langsung dengan OpenCPN

Perbandingan Penyedia AIS