Skip to main content

Map

The Map page provides interactive visualizations of your location data. You can view points, routes, heatmaps, and various other layers to explore your travel history.

Map Versions​

Dawarich offers two map implementations:

Map V1 (Leaflet)​

The original map implementation using Leaflet.js. This is the default for existing installations and provides reliable performance with standard features.

Map V2 (MapLibre GL JS)​

The newer map implementation using MapLibre GL JS. Map V2 offers:

  • Better performance - WebGL-based rendering for smoother interactions
  • Globe view - 3D globe rendering option
  • Search functionality - Built-in place search (see Search)
  • Modern styling - More map style options

To switch between map versions, access /map/v1 or /map/v2 in your browser URL, or configure your preferred version in settings.

Map Interface​

Time Range Selection​

Use the date picker at the top to select the time range for displayed data. You can view data from a single day to your entire history.

The sidebar provides:

  • Year/Month Navigation - Browse your data by time period
  • Countries & Cities - View statistics on places you've visited
  • Layer Controls - Toggle map layers on/off

Point Details​

Click on any point to see:

  • Timestamp
  • Coordinates
  • Altitude (if available)
  • Speed (if available)
  • Battery level (if recorded)

Route Details​

Hover over or click on a route to see:

  • Total distance
  • Duration
  • Average speed
  • Transportation mode (if detected)

Map Layers​

Points​

Shows individual GPS points on the map as markers.

Points

Polylines (Routes)​

Displays your routes connecting GPS points. Routes are automatically generated based on your configured time and distance thresholds.

Polylines

Heatmap​

Visualizes point density as a heatmap, showing areas where you spend the most time.

Heatmap

Fog of War​

Shows unexplored areas as "fog," revealing only the regions you've visited. Great for visualizing your travel coverage.

Fog of war

Scratch Map​

Highlights countries you've visited on a world map overlay.

Scratch map

Areas​

Shows custom areas you've drawn on the map. Also enables area drawing tools.

Areas

Photos​

Displays photos from connected Immich and/or Photoprism instances at their GPS locations.

Photos

Family (Map V2)​

When you have Family Location Sharing enabled, shows real-time locations of family members who are sharing their location with you.

Map Styles​

You can choose from multiple map styles:

Map V1:

  • OpenStreetMap (default)
  • Various other tile providers

Map V2:

  • Light theme
  • Dark theme
  • Satellite imagery
  • Multiple style variations

Speed-Colored Routes​

Enable "Fancy Routes" or "Speed Colored Routes" in settings to color your routes based on speed:

  • Green - Slower speeds (walking, cycling)
  • Yellow - Medium speeds
  • Red - Higher speeds (driving)

The color scale is customizable to match your typical travel speeds.

Globe View (Map V2)​

Map V2 supports 3D globe rendering:

  1. Go to Settings
  2. Enable "Globe Projection"
  3. The map will render as a 3D globe instead of flat projection

This provides a more realistic view when zoomed out and is particularly striking for visualizing global travel.

Live Map Mode​

When enabled, Live Map Mode:

  • Automatically updates with new points as they're recorded
  • Centers the map on your most recent location
  • Useful for real-time tracking

Point Drag & Drop​

In Map V2, you can drag points to adjust their position:

  1. Enable point editing mode
  2. Click and drag a point to a new location
  3. The point's coordinates are updated

This is useful for correcting GPS drift or inaccurate readings.

Bulk Selection Tool​

Select multiple points at once:

  1. Enable the selection tool
  2. Draw a rectangle around points to select
  3. Perform bulk actions (delete, export, etc.)

Map Settings​

Access map settings through the Settings button in the top right corner of the map. Available settings include:

SettingDescription
Preferred Map LayerDefault map style
Route OpacityTransparency of route lines
Fog of War MetersResolution of fog tiles
Minutes Between RoutesTime gap to start a new route
Meters Between RoutesDistance gap to start a new route
Speed Colored RoutesEnable speed-based route coloring
Globe ProjectionEnable 3D globe view (V2 only)
Live Map EnabledAuto-update with new points

Search (Map V2)​

Map V2 includes a built-in place search feature. See the Search documentation for details.

Tips​

  • Performance: For large datasets, disable layers you're not using
  • Time ranges: Start with shorter time ranges and expand as needed
  • Zoom levels: Some layers render differently at various zoom levels
  • Mobile: Pinch to zoom, two-finger drag to rotate (V2)