← Back to User Guide
πŸ—ΊοΈ

Map

The Map is the heart of Xopoz. Use it to see your position, follow your team in real time, measure distances, and navigate the world around you.

Three Navigation Modes

The map operates in three distinct modes. You can switch between them using the on-screen controls.

🎯 Tracking Mode

The map automatically follows a selected team member. The view re-centres each time their position updates. Your chosen zoom level is preserved.

πŸ•ΉοΈ Free Navigation Mode

You have full manual control β€” pan and zoom freely without any automatic re-centering. The app still receives live position updates and displays them, but does not move the map. The app switches to this mode automatically whenever you pan or zoom manually.

πŸ“ Measurement Mode

Tap multiple points on the map to measure the distance between them. Distances are shown in real time in metric units. A grid overlay and precision cross-hair help with accurate placement. Measurements stay on screen until you clear them.

GPS & Position Tracking

Xopoz uses the direct Android GPS system (not Google Play Services), ensuring it works on all devices including custom ROMs.

Smart Battery Management

Movement Detection

The app detects movement using a 50-metre threshold. When you are moving, your map icon changes from a static circle to a directional arrow showing which way you are heading.

Location History Trails

The map shows a trail (line) of your recent path. You can configure the trail duration from 1 hour up to ~31 days using day and hour sliders. The default is 12 hours. Trails can be hidden or shown without losing the underlying history.

Map Display Features

Custom Map Servers

You are not limited to a single map style. Xopoz lets you configure any raster tile server β€” including private, enterprise, or offline tile servers.

Note: Only raster tile servers (PNG / JPG / WebP images) are supported. Vector tile servers are not compatible.

Visual Reference Tools

Compass & Heading Line

Hold your phone flat in portrait orientation to activate the compass overlay.

🧭 The compass only appears when the device is held flat (within 30° of vertical). It is automatically hidden in landscape mode to prevent orientation errors.

Team Members on the Map

Each team member's device appears as a circular icon containing their ticker or emoji. The icon adapts to show their current status:

Tap any team member icon to instantly centre the map on their current location.

Map Controls

On-Screen Buttons

Right side (bottom to top):

Left side (bottom to top):

Volume Buttons

When the map is active, the physical volume up / down buttons zoom the map in and out. A single press zooms one level; holding the button continues zooming. This is ideal for use with gloves or when your hands are occupied.