Nana and Opa Cruise Tracker

This repository contains the public ship-tracker map and the Node collector that listens for AIS position reports from Rotterdam (MMSI 245464000). The collector saves at most one point every 30 minutes using the ship's AIS timestamp and makes the saved route available over HTTP.

1. Copy .env.example to .env.
2. Put your AISStream key after AISSTREAM_API_KEY= in .env.
3. Run npm start.
4. Open http://localhost:3000/health and http://localhost:3000/positions.

The .env file and saved data/ folder are ignored by Git.

• GET /health reports the Rotterdam feed, a nearby-ship control feed, and the most recently saved point. Its diagnosis distinguishes a stale AIS feed from a period with no Rotterdam reports.
• GET /positions returns all saved positions as JSON.

The app reads Railway's PORT automatically. Set AISSTREAM_API_KEY as a Railway variable. For storage that survives deployments, mount a Railway volume at /data and set DATA_FILE=/data/positions.json.

The collector uses two AISStream connections: one filtered to Rotterdam and a small control area around its last known location. Only Rotterdam is stored. If the control feed is silent for 15 minutes, both connections restart with a conservative one-minute-to-one-hour backoff.