Skip to main content
The Map View provides a geographic visualization of your Duck mesh network, showing device locations, message activity, and real-time GPS tracking.

​
Getting Started

1

Select a Papa Duck

Choose a Papa Duck from the selection panel to view its network on the map
2

Optional: Adjust Time Range

Select a time range filter (5 min, 1 hour, 24 hours, 1 week, 2 weeks, 1 month) to control which messages appear
3

View Markers

Device markers appear on the map showing the latest GPS location for each device
You must select a Papa Duck before any data or markers will appear on the map.

​
Papa Duck Selection Panel

The left panel displays all your Papa Duck gateways as cards:

​
Card Information

Each Papa Duck card shows:
  • Device Name: Papa Duck identifier
  • Mama Count: Number of connected Mama Ducks
  • Last Message: Time since the last message was received
  • Message Count: Total messages in the selected time window
Papa Ducks are sorted by most recent activity, so active networks appear at the top.

​
Map Controls

​
Map Style Options

Switch between different map visualizations:

Streets

Default street map with labels and terrain

Satellite

Aerial imagery view

Terrain

Topographic map with elevation contours

​
3D Buildings Toggle

Enable 3D building rendering for urban environments (not available in satellite mode).
  • Zoom: Use the +/- buttons or scroll wheel
  • Geolocation: Click the location icon to center on your current position
  • Rotation: Right-click and drag to rotate the map
  • Pan: Click and drag to move around

​
Device Markers

​
Marker Display

  • One marker per device showing the latest GPS location
  • Markers update in real-time as new GPS messages arrive
  • Device name appears above each marker
  • Markers cluster together when zoomed out for better visibility

​
Clicking on Markers

Click any device marker to open a popout with detailed information:
1

Device Info

View device name, unique ID, and parent Papa Duck
2

Online Status

See if the device is currently online (based on messages in the last 5 minutes)
3

Battery Status

View battery percentage, voltage, charging status, and temperature (if available within last 2 hours)
4

Last Seen

Timestamp of the most recent message from the device
5

Message History

Scroll through recent messages with event types, payloads, and timestamps
6

Actions

Click “View Device” to navigate to the full device detail page
The device popout stays anchored to the marker even when you pan or zoom the map.

​
Message Feed

The right panel displays real-time message activity for the selected Papa Duck:

​
Event Types

Messages are color-coded by event type:
Event TypeIconDescription
GPS📍Location updates with coordinates
Health❤️Battery, temperature, and device health metrics
Statusℹ️General device status messages
Sensor🌡️Environmental sensor readings
Unknown❓Other event types

​
Feed Interaction

1

Click Messages

Click any message in the feed to open the device popout
2

GPS Navigation

Clicking messages with GPS data will center the map on that device’s location
3

Live Updates

New messages appear at the top with a highlight animation
If a device doesn’t have GPS coordinates, clicking its message will show a notification instead of opening the popout.

​
GPS Location Tracking

​
How GPS Works

  • GPS Events: Standard GPS messages with lat/lng coordinates
  • JSON Payloads: Messages with embedded location data
  • Space-Separated Format: Legacy format with LAT: and LNG: properties

​
Location Updates

  • The system automatically processes GPS data from all supported formats
  • Only the latest location for each device is displayed
  • Older GPS coordinates are replaced when new ones arrive
  • Locations update in real-time via WebSocket connection

​
Time Range Filtering

Adjust the time range to control which messages and GPS data appear:
Time RangeUse Case
5 minActive debugging and real-time monitoring
1 hourRecent activity tracking
24 hoursDaily operations overview
1 weekWeekly pattern analysis
2 weeksMedium-term trends
1 monthLong-term historical view
Changing the time range updates both the message feed and the GPS markers on the map.

​
Tips

Performance: Start with a shorter time range (5 min or 1 hour) when monitoring active networks to reduce data load.
Popout controls: Press Escape or click outside the device popout to close it.
Reset filters: Click the “Reset to Default” button to clear all filters and return to the default view.
Connection status: Check the connection indicator in the corner to verify your WebSocket connection is active for live updates.