Skip to main content

Fleet Map

The Fleet Map provides a real-time, interactive view of your entire fleet on a Mapbox GL JS map. Track device locations via WebSocket, inspect asset status with a click, and overlay weather forecasts, danger zones, and geo-data from 40+ sources — all in a single view.


Map Interface

The Fleet Map uses Mapbox GL JS with the dark-v11 base style, optimized for control room and bridge environments where a dark background reduces eye strain.

Key Controls

ControlLocationDescription
Zoom in/outBottom-rightStandard +/- buttons or scroll wheel
CompassBottom-rightClick to reset bearing to north
FullscreenTop-rightExpand map to fill the browser window
Layer controlsTop-rightToggle satellite, weather, geo-alert, and geo-data overlays
Sidebar toggleLeft edgeShow/hide the asset list sidebar

Real-Time Device Tracking

Device positions update in real time via WebSocket subscriptions. When a device reports its location, the map marker moves to the new position without requiring a page refresh.

Pulsing Markers

Each device is represented by a pulsing green marker on the map. The pulsing animation makes it easy to distinguish device markers from static map features at any zoom level.

Location Age Coloring

Marker color indicates how recently the device reported its position:

ColorAgeMeaning
Green< 5 minutesDevice is actively reporting
Amber< 1 hourRecent position, but not current
Orange< 24 hoursStale position — device may be offline
Red> 24 hoursNo recent position — investigate connectivity
info

Location age is calculated from the device's last reported GPS timestamp, not the time the data was received by the platform. This accounts for satellite communication delays.


Click-to-Inspect

Click any device marker to open an inspection popup showing:

  • Device name and identifier
  • Current status (online, offline, idle)
  • Position — latitude, longitude, heading, speed
  • Last update time — when the position was last reported
  • Quick links — jump to asset detail, data explorer, or alarm view

The left sidebar provides a searchable list of all assets with map positions.

Features

  • Search — filter assets by name, type, or identifier
  • Status colors — each list item shows a color dot matching the device's location age
  • Click to focus — clicking an asset in the list pans and zooms the map to that device
  • Asset count — total number of tracked devices displayed at the top

Layer Controls

The layer control panel in the top-right corner lets you toggle multiple overlay categories on and off.

Satellite Imagery

Toggle satellite imagery on top of the base map for real-world visual context. Useful for identifying landmarks, coastlines, and terrain when correlating device positions.

Weather Overlays

Visualize weather conditions across your operating area using GFS (Global Forecast System) model data. Powoflow supports 14 weather parameters:

ParameterUnitDescription
Wind Speedm/s10-meter wind speed magnitude
Wind Direction°10-meter wind direction
Temperature°C2-meter air temperature
Dewpoint°C2-meter dewpoint temperature
Relative Humidity%2-meter relative humidity
PressurehPaMean sea level pressure
PrecipitationmmTotal precipitation (rain + snow equivalent)
Cloud Cover%Total cloud cover percentage
VisibilitykmHorizontal visibility
Wave HeightmSignificant wave height
Wave PeriodsMean wave period
Wave Direction°Mean wave direction
CAPEJ/kgConvective Available Potential Energy (storm indicator)
Snow DepthmSnow depth on ground
tip

Combine wind speed and wave height overlays to quickly identify weather windows for offshore operations. Use the forecast hour selector to plan ahead.

Weather Click-to-Inspect

Click anywhere on the map while a weather overlay is active to see exact interpolated values at that point. The popup displays:

  • All active parameter values at the clicked location
  • Forecast valid time
  • Data source and model run time

Forecast Hour Selection

Use the forecast hour slider to step through the forecast timeline:

  • Current conditions (analysis)
  • Up to 384 hours (16 days) ahead in 3-hour increments
  • Playback animation available

Color Scale Legends

Each weather parameter has a purpose-built color scale:

  • Temperature — blue (cold) through white to red (hot)
  • Wind Speed — green (calm) through yellow and orange to red (storm force)
  • Wave Height — blue (flat) through green and yellow to red (heavy seas)

The legend appears in the bottom-left corner when a weather overlay is active.

Weather Configuration

Configure weather data coverage and parameters:

  • Bounding box — draw a rectangle on the map to define the geographic area for weather data
  • Parameter selection — choose which of the 14 parameters to fetch and cache
  • Forecast horizon — set how far ahead to download forecasts (e.g., 72h, 120h, 384h)
info

Weather data is fetched on a schedule and cached. Adjusting the bounding box or forecast horizon affects data volume and storage. Keep the bounding box tight around your operating area for optimal performance.

Geo-Alert Overlays

Overlay global danger zones and travel advisories from 41 data sources. Geo-alerts are displayed as colored polygons, lines, or markers depending on the source type.

Examples of geo-alert categories:

CategorySourcesDisplay
Seismic activityUSGS, EMSC, GeoNetMarkers with magnitude
Tropical cyclonesNHC, JTWCTrack lines and forecast cones
Volcanic activityGeoNet Volcano, SmithsonianMarkers with alert level
Travel advisoriesUK FCDO, INFORM SeverityCountry polygons with risk level
Maritime securityIMB, MDATZone polygons
Severe weatherNOAA, MeteoalarmRegion polygons with severity
warning

Geo-alert data is sourced from third-party providers and is provided for situational awareness only. Always verify critical safety information through official channels.

Geo-Data Overlays

Display supplementary geographic data from 17+ sources with interactive filter panels. Each source has its own filter configuration allowing you to narrow down displayed features by:

  • Date range
  • Severity or magnitude
  • Category or type
  • Geographic region

Geo-data filter panels are specific to each source type, showing only the relevant filter options for that dataset.


Best Practices

tip

Control room setup: Use the Fleet Map in fullscreen mode with the dark base style for 24/7 monitoring. Enable only the overlays relevant to your current operations to keep the display clean.

  • Check location age colors daily — red markers indicate devices that may need connectivity troubleshooting
  • Set up weather bounding boxes tightly around your operating area to reduce data load
  • Use forecast playback to brief crews on upcoming weather windows
  • Enable geo-alert layers relevant to your operating region and review them at shift handover