bark-marine-routes

name	bark-marine-routes
description	Plan inland shipping routes for captains using Marineplan API. Search locations, snap to waterway, calculate routes.

Bark Marine Routes Skill

Route planning for inland shipping captains via Marineplan Navigation API.

Status

• ✅ Search API - Werkt (locaties zoeken)
• ✅ Snap API - Werkt (coördinaten naar vaarwater)
• ⚠️ Routing API - Niet beschikbaar met huidige key (404)
• 📍 Gebruik externe routing of vraag Marineplan om routing toegang

Base URL

https://api.marineplan.com

Authentication

export MARINEPLAN_API_KEY="f76a834d-cc15-41be-a25a-4913f3d0e521"

Standardroutes

Voorgedefinieerde routes (opgeslagen in data/routes/):

Route	Van	Naar	Afstand (km)	Sluizen
Rotterdam-Antwerpen	Rotterdam	Antwerpen	~87	3
Amsterdam-Duisburg	Amsterdam	Duisburg	~230	8
Groningen-Bremen	Groningen	Bremen	~180	5

Endpoints

1. Search Location ✅

GET /api/search/1/search.json?q={query}&types=CITY,HARBOR&max=5&language=NL&key={API_KEY}

2. Snap to Waterway ✅

GET /api/mapmatching/1/snap.json?point={lat},{lon}&vessel=2&range=500&key={API_KEY}

3. Route Planning ⚠️ (Niet beschikbaar)

GET /api/routing/1/route.json?from={lat},{lon}&to={lat},{lon}&vessel=2...

Workaround: Gebruik snap + externe routing of vraag Marineplan om routing toegang.

Gebruik

Zoek Haven

./bark-routes.py search "Rotterdam"
# Output: Rotterdam @ 51.93123,4.51712

Snap naar Vaarwater

./bark-routes.py snap "51.93123,4.51712"
# Output: Dichtstbijzijnde waterway + afstand

Plan Route (Workaround)

./bark-routes.py plan "Rotterdam" "Antwerpen" --length 85 --width 9.5
# Zoekt coördinaten → Snap naar waterway → Toont route info

Scheepstypen

Code	Type
2	Cargo / Binnenvaartschip
3	Groot jacht
4	Cabin cruiser
5	Sloep
6	Kano

Coördinaten Database

data/locations.json - Veelgebruikte havens:

{
  "Rotterdam": {"lat": 51.93123, "lon": 4.51712},
  "Antwerpen": {"lat": 51.2194, "lon": 4.4025},
  "Amsterdam": {"lat": 52.3676, "lon": 4.9041}
}