Skip to main content

AIS Vessel Tracker

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

⚠️ Android only
This feature is currently not available for the iOS version of the OsmAnd app.

Overview​

The AIS Vessel Tracker plugin displays Automatic Identification System (AIS) positions and detailed information about nearby vessels. The AIS data is received via a network connection from an external AIS receiver.

DISCLAIMER

This plugin is a hobby project and is not designed for reliability or accuracy. DO NOT rely on this software for navigation or safety of life.

Required Setup Parameters​

The ability to use Online maps is automatically enabled in iOS version of OsmAnd. To display Online maps in Android, you need to make the following settings:

  1. Enable AIS vessel tracker plugin in the Main Menu β†’ Plugins β†’ AIS vessel tracker.
  2. Configure the AIS settings
  3. Configure an AIS server connection or connect an external AIS receiver.
  4. Check that vessels are displayed on the OsmAnd map.

Vessels on the Map​

AIS operates on VHF frequencies (161.975 MHz and 162.025 MHz) and has a limited signal range due to line-of-sight propagation.

Typical AIS reception range:

  • 15–20 nautical miles (28–37 km)
  • Depends on antenna height, environmental conditions, and obstacles

AIS display on the map:

AIS vessel tracker

When correctly set up, vessel positions will appear on the map. Key features:

  • Vessels move based on real-time speed and course.
  • New ships enter and exit the visible area dynamically.
  • Tapping a vessel opens detailed information.

AIS Vessel Information​

AIS vessel tracker AIS vessel tracker

AIS vessels transmit three types of data:

  1. Static Information (unchanging data).
    Sent every 6 minutes or upon request.

    • Ship Name (if set)
    • MMSI (Maritime Mobile Service Identity) (Unique 9-digit ship identifier)
    • IMO Number (if available)
    • Call Sign
    • Ship Type (e.g., Cargo, Passenger, Fishing Vessel)
    • Ship Dimensions (Length and Width)
    • AIS Antenna Position (Relative to the ship's hull)
  2. Dynamic Information (real-time data).
    Sent at different intervals depending on speed and maneuvering.

    • Ship Coordinates (Latitude & Longitude)
    • Course Over Ground (COG)
    • Speed Over Ground (SOG)
    • Heading (Direction the bow is pointing)
    • Ship Status (Underway, Anchored, Maneuvering, etc.)
    • Rate of Turn (ROT) (Speed of course change)
    • Last Update Time
  3. Voyage Information (manually set by crew).
    Sent every 6 minutes, manually set by crew

    • Destination Port
    • Estimated Time of Arrival (ETA)
    • Draught (Ship's water depth below surface)
    • Cargo Type (if transmitted)
    • Number of People on Board (optional)

AIS Symbols and Legends​

Guidelines for AIS Symbol Presentation

SymbolsDescription
Vessel Types Symbols
Green triangleCargo ship
Blue trianglePassenger ship
Black triangleFishing vessel
Yellow triangleTugboat
Red triangleTanker
White triangleMilitary vessel
Orange triangleSpecial craft (e.g., pilot, icebreaker)
Flashing Red triangleVessel in distress
Navigational Aids Symbols
Green BuoyStarboard marker (right-hand side of the channel)
Red BuoyPort marker (left-hand side of the channel)
Anchor symbolAnchorage area
Ship symbol (SS)Ferry or passenger terminal
Port Crane symbolCargo port
Black circleOffshore platform
Status Indicators
Solid triangleMoving vessel
Hollow triangleAnchored or Moored
Rotating arrowUndergoing maneuver
Red Flashing iconEmergency alert
Orange Exclamation markAIS safety message
Route and Speed Indicators
Thin Blue linePlanned route
Dotted linePast track
Clock iconEstimated time of arrival (ETA)
Wave iconSpeed over water

Plugin Settings​

Menu β†’ Plugins β†’ AIS vessel tracker β†’ Settings

AIS settings

The AIS vessel tracker plugin offers various settings to personalize navigation and interaction for users with disabilities. These settings are applied for all profiles in OsmAnd.

SettingDescriptionExample
IP address settings
ProtocolChoose protocol for receiving AIS dataUDP/TCP
IP addressDefine IP of AIS data source (if TCP is used)192.168.200.16
TCP portDefine TCP port number for AIS data4001
UDP portDefine UDP port for OsmAnd AIS reception10110
AIS Signal reception timeout
Timeout for lost AIS objectsShips disappear if no signal received for a set time3 - 20 min
Timeout for ship visibilityShip icons will change state when no signal is received2 - 15 min / Disabled
Closest Point of Approach (CPA) Alerts
CPA Warning TimeVessel is marked red if time to CPA is below this limit1 - 60 min / Disabled
CPA Warning DistanceVessel is marked red if distance to CPA is below this limit0.02 - 2 nautical miles

AIS Simulation Mode​

You can simulate AIS vessel positions using OsmAnd Development plugin.

  1. Download AIS data text files:

  2. Load AIS data into OsmAnd
    Open Menu β†’ Plugins β†’ Development β†’ Settings β†’ Load AIS data from file and select one of the downloaded files.

  3. View AIS vessels on the map
    Vessel icons will appear based on the simulated data. Tap the vessel icon to view detailed information.

This article was last updated in March 2025