bark-ais-tracking

name	bark-ais-tracking
description	Track vessel locations via Marineplan OpenShipData/AIS API. Real-time ship positions, destinations, and vessel metadata.

Bark AIS / OpenShipData Skill

Real-time vessel tracking via Marineplan OpenShipData API.

API Key

export MARINEPLAN_AIS_KEY="3f276632-8681-4746-8420-7b961c86066a"

Base URL

https://ais.marineplan.com

Endpoints

1. Find Ships in Area

Zoek schepen in een geografisch gebied.

GET /location/2/locations.json?area={sw_lat},{sw_lon};{ne_lat},{ne_lon}&maxage={seconds}&moving={0|1}&key={API_KEY}

Parameters:

Param	Beschrijving	Voorbeeld
area	Bounding box (SW;NE)	52.0,4.0;52.5,5.0
maxage	Max data leeftijd (sec)	1800 (30 min)
moving	Alleen bewegende schepen	1
source	Data bron	ANY, AIS, APPS

Voorbeeld:

curl "https://ais.marineplan.com/location/2/locations.json?\
area=51.9,4.3;52.0,4.6\
&maxage=1800\
&moving=1\
&key=3f276632-8681-4746-8420-7b961c86066a"

2. Get Specific Ship

Zoek een specifiek schip op naam of MMSI.

GET /location/2/ship.json?ship={name_or_mmsi}&key={API_KEY}

Voorbeeld:

curl "https://ais.marineplan.com/location/2/ship.json?\
ship=244045895\
&key=3f276632-8681-4746-8420-7b961c86066a"

3. Search Ships

Tekstuele zoektocht naar schepen.

GET /location/2/search.json?area={bbox}&query={name}*&max=30&key={API_KEY}

4. Get Planned Arrivals

Geplande aankomsten in een gebied.

GET /location/2/arrivals.json?area={bbox}&maxage=1800&key={API_KEY}

5. Track Multiple Ships

HTML interface voor tracking (gratis).

GET /location/2/ships.html?ships={mmsi1},{mmsi2}&language=NL

Response Format

{
  "locations": [
    {
      "mmsi": "244045895",
      "name": "JOHANNA",
      "callsign": "PI1234",
      "type": 2,
      "length": 85,
      "width": 9.5,
      "position": {
        "latitude": 51.95,
        "longitude": 4.45
      },
      "speed": 12.5,
      "bearing": 135,
      "destination": "Antwerpen",
      "eta": "2025-02-26T14:30:00Z",
      "timestamp": 1708956000
    }
  ]
}

Scheepstypen (AIS)

Code	Type
2	Cargo
3	Passenger
4	Tanker
5	Other
6	Sailing
7	Pleasure craft

Usage

# Zoek schepen in Rotterdam gebied
./bark-ais.py area --lat 51.9 --lon 4.4 --radius 10

# Zoek specifiek schip
./bark-ais.py ship "JOHANNA"
./bark-ais.py ship "244045895"

# Zoek schepen op naam
./bark-ais.py search "mvs*"

# Toon aankomsten
./bark-ais.py arrivals --lat 51.9 --lon 4.4

Data Bronnen

• AIS: VHF receivers wereldwijd (~100.000 schepen)
• APPS: Vaarkaart NL, Waterkaart NL, NavKid apps
• ANY: Alles samengevoegd

Update Frequentie

• Data wordt elke minuut ververst
• Maxage parameter bepaalt hoe oud data mag zijn

Coverage

Check coverage op: https://www.aishub.net/coverage Live map: https://maps.marineplan.com

Notes

• Schepen zonder AIS zender zijn niet zichtbaar
• Sommige schepen uitzenden niet continu
• Positie kan enkele minuten vertraging hebben