Showcase/Port Vessels

Ocean Terminal Vessel Tracker

Monitor vessels in real-time as they approach and dock at U.S. ocean terminals. Select a port to track vessels within 100 meters of its terminals. Data updates live from AIS Stream.

How it works

• Server queries Deliberate API to map all U.S. ports with ocean terminals
• Subscribes to AIS Stream WebSocket for ocean terminal bounding boxes
• For each vessel position update, queries Deliberate API with within_radius spatial filter (100m)
• Maps terminals to their parent ports using relationship data

Example Spatial Query

For each vessel, we send this query to Deliberate API to check if it's near any ocean terminals:

json

{
  "where": {
    "tags": {
      "contains": "ocean_terminal"
    },
    "spatial": {
      "within_radius": {
        "lat": ship.latitude,
        "lng": ship.longitude,
        "radius_meters": 100
      }
    }
  },
  "limit": 10
}

The within_radius filter uses H3 geospatial indexing for efficient proximity detection. Only vessels within the specified radius of terminal boundaries are displayed.

Loading ports...