@worldwideview/wwv-plugin-maritime
v1.0.4
Published
WorldWideView plugin for real-time vessel tracking via AIS feeds. Color-coded by vessel type with speed and heading indicators
Maintainers
silvertakanaReadme
@worldwideview/wwv-plugin-maritime
WorldWideView plugin for real-time vessel tracking via AIS (Automatic Identification System) feeds.
Features
- 🚢 Live vessel positions with heading and speed indicators
- 🎨 Color-coded by vessel type (cargo, tanker, passenger, fishing, military, sailing, tug)
- 🔍 Filters: vessel type, speed range
- 📍 Clustered point rendering with vessel name labels
- 🔄 Demo mode with realistic sample vessels when API is unavailable
Installation
npm install @worldwideview/wwv-plugin-maritimePeer Dependencies
@worldwideview/wwv-plugin-sdklucide-react≥ 0.576.0
Usage
import { MaritimePlugin } from "@worldwideview/wwv-plugin-maritime";
const plugin = new MaritimePlugin();Register the plugin with the WorldWideView plugin engine to start tracking vessels on the globe.
Data Source
Vessel data is fetched from the /api/maritime endpoint. Falls back to demo data with 15 sample vessels when the API is unavailable.
Vessel Colors
| Type | Color |
|---|---|
| Cargo | 🟡 #f59e0b |
| Tanker | 🔴 #ef4444 |
| Passenger | 🔵 #3b82f6 |
| Fishing | 🔵 #22d3ee |
| Military | 🟣 #a78bfa |
| Sailing | 🟢 #4ade80 |
| Tug | 🟠 #f97316 |
Changelog
- v1.0.3 — Added README with feature list and usage docs.
- v1.0.2 — Package metadata updates.
- v1.0.1 — Package configuration fixes.
- v1.0.0 — Initial release with AIS-based vessel tracking and ship-type filtering.
License
ISC