Maritime Security

Turqoa's Maritime Security module provides real-time vessel tracking, threat assessment, and automated alerting for port and coastal facilities. It fuses AIS data with radar, camera feeds, and intelligence databases to build a comprehensive maritime situational picture.

Architecture

The maritime security stack ingests data from multiple sources and produces a unified vessel risk picture:

AIS Receivers ─┐
Radar Feeds ───┤
Camera Feeds ──┼──→ Fusion Engine ──→ Risk Scoring ──→ Decision Engine ──→ Alerts
Intel Database ┤
Weather Data ──┘

AIS Integration

Turqoa ingests AIS data from multiple receiver types:

Supported Sources

Configuration

ais:
  sources:
    - name: primary_terrestrial
      type: tcp
      host: 192.168.10.50
      port: 10110
      protocol: nmea_0183
      priority: 1

    - name: satellite_ais
      type: api
      url: https://ais-provider.example.com/v2/positions
      api_key: ${AIS_API_KEY}
      poll_interval_seconds: 60
      priority: 2

    - name: ais_websocket
      type: websocket
      url: wss://ais-stream.example.com/feed
      auth_token: ${AIS_WS_TOKEN}
      priority: 1

  deduplication:
    enabled: true
    mmsi_window_seconds: 10
    prefer_source: highest_priority

  filtering:
    bounding_box:
      min_lat: 51.40
      max_lat: 51.55
      min_lng: -0.20
      max_lng: 0.10
    vessel_types: all  # or list: [cargo, tanker, passenger]

Decoded Fields

Turqoa decodes and stores the following AIS fields per vessel:

Threat Zone Management

Threat zones are geofenced areas with associated monitoring rules. When a vessel enters, dwells in, or exits a threat zone, the system evaluates configured rules and may trigger alerts.

Zone Types

{
  "zone": {
    "name": "LNG Terminal Exclusion",
    "type": "exclusion",
    "geometry": {
      "type": "Polygon",
      "coordinates": [
        [[-0.05, 51.48], [-0.04, 51.48], [-0.04, 51.49], [-0.05, 51.49], [-0.05, 51.48]]
      ]
    },
    "alert_level": "critical",
    "applies_to": {
      "vessel_types": "all",
      "exceptions": ["port_authority", "pilot_boats"]
    }
  }
}

See Threat Zones for detailed configuration.

Vessel Risk Scoring

Every tracked vessel receives a composite risk score from 0 (no risk) to 100 (maximum risk). The score is computed from eight weighted factors:

# Composite risk score calculation
def compute_risk_score(vessel, zone_context):
    factors = {
        "flag_state":       score_flag_state(vessel.flag) * 0.15,
        "ais_behavior":     score_ais_behavior(vessel.ais_history) * 0.15,
        "vessel_type":      score_vessel_type(vessel.type_code) * 0.10,
        "historical":       score_history(vessel.mmsi) * 0.15,
        "speed_anomaly":    score_speed(vessel.sog, zone_context) * 0.10,
        "route_deviation":  score_route(vessel.position, vessel.destination) * 0.10,
        "watchlist":        score_watchlist(vessel.mmsi, vessel.imo) * 0.15,
        "dwell_time":       score_dwell(vessel.mmsi, zone_context) * 0.10,
    }
    return round(sum(factors.values()), 1)

See Risk Scoring for the full model documentation.

Alert Thresholds

Next Steps

• Threat Zones -- geofence configuration and zone monitoring rules
• Risk Scoring -- full risk model and custom weight configuration
• Decision Engine -- automated response rules for maritime events
• API Reference: Events -- subscribe to maritime events via API