Map & Waypoints

The Map tab shows all nodes that have shared a position, overlaid on an Apple Maps base layer.

Node Pins

Each node that has reported a GPS position appears as a coloured circle pin on the map. The green solid line shows a directly connected node; orange dashed lines show nodes reached via the mesh. A purple star marks a waypoint. Tap a pin to see the node name, last heard time, signal info, and a shortcut to send a direct message.

Pins update automatically when a new position packet is received from the mesh.

Map Layers

Tap the layer icon (top-right) to switch between:

Layer Description
Standard Default Apple Maps street/satellite hybrid
Satellite Aerial imagery
GeoJSON Overlays Custom map layers loaded from .geojson files in the app’s file storage

Waypoints

Waypoints are named points of interest you can share across the mesh.

Creating a Waypoint

  1. Long press anywhere on the map.
  2. Enter a name, optional description, and lock icon (to limit editing to the creator).
  3. Tap Save — the waypoint broadcasts to all nodes on the primary channel.

Editing a Waypoint

Tap an existing waypoint pin, then tap Edit. Changes broadcast to the mesh immediately.

Deleting a Waypoint

Tap the waypoint, then tap Delete. The deletion broadcasts to all nodes.

Node Trail

When a node has reported multiple positions over time, a trail line connects the historical positions on the map, showing the node’s path.

Your Location

Your current GPS position appears as a blue dot (standard iOS location indicator). Enable position broadcasting in Settings → Position to share your location with the mesh.


Copyright © 2026 Garth Vander Houwen. Distributed under the GPL v3 License.
This site uses Just the Docs, a documentation theme for Jekyll.