Admin User Guide · Maps Module

One map for
the control room.
One for the field.

Maps is the platform's visual command surface — a live operational map for everyday situational awareness, and a tactical Live Mission Map for coordinated Special Ops deployments, sharing the same targets, events, and responder data underneath.

🗺️ Live Map View 🎯 Tactical Mission Map 📡 Blue Force Tracking 🔥 Heatmaps & Geofences 🛰️ Google · Mapbox · OSM
39
Live events tracked
7
Responders on the map
28
Active geofence zones
3
Map providers supported
Scroll to begin ↓
Overview

Maps at a glance

Two purpose-built map tools, launched from one landing screen, drawing on the same live operational data.

Maps module landing screen with Map View and Live Mission Map cards
Maps → Map View (operational overview) and Live Mission Map (tactical mission tracking)

Every event, responder, target, and facility the platform tracks eventually needs to be seen on a map. Maps gives the control room two different lenses on that same data: a broad operational view for everyday monitoring, and a tactical view built specifically for coordinated Special Ops deployments.

Map View
Real-time operational map — responder locations, live events, and geofence overlays across the full coverage area.
Live Mission Map
Tactical mission map — Blue Force team tracking, waypoints, and real-time coordination for a specific deployment.

Same data, two audiences. Map View is where an operator watches everything at once. Live Mission Map is where a deployed team commander runs one mission — the tools change accordingly, from filters and heatmaps to routes, breadcrumbs, and encrypted tac chat.

Section 01

Map View

The everyday operational map — every event, responder, and asset, layered, filtered, and clustered for a clear read at a glance.

Map View opens on the full coverage area with every target type clustered by location. From here an operator can toggle layers on and off, filter by date or duty status, switch on a heatmap, and drill into any single pin.

Live Map View showing clustered targets across Southern Africa
Live Map View → clustered pins scale to zoom level; the legend along the bottom shows every active layer and its count

Layers, filters, and heatmap

Three controls shape what the map shows without ever leaving the view: Layers decides which target types are visible, Filters narrows by date range or status, and Heatmap switches to an intensity view for spotting patterns over time.

Toggle Layers panel listing Events, Responders, Users, Smartpoles, Fixed Targets, Mobile Targets, Facilities
Layers → toggle each target type, plus facility sub-types (Police, Hospitals, Clinics, Fire, Metro Police)
Filter Options panel with Active Only, date range, and On-duty only
Filters → Active-only events, a date range, on-duty-only responders, and responder type
Heatmap Settings panel with time range and export options
Heatmap → Last 24h / 7 / 30 days / All Time, with CSV and report export

Geofence overlays

Geofences shows every configured monitoring zone directly on the map, grouped by category, alongside official SAPS precinct boundaries for jurisdictional context.

Geofences panel with categories Hotspots, Customised, Communities, User Defined
Geofences → Hotspots, Customised zones, Communities, and User Defined, plus SAPS precinct boundaries toggle
Why zones stay categorized
Splitting geofences into Hotspots, Customised, Communities, and User Defined lets an operator show only the zones relevant to what they're watching — a community boundary review doesn't need crime hotspot overlays cluttering the view, and vice versa.

Fit All and Refresh. Fit All reframes the map to every currently visible target in one click — useful after changing filters. Refresh pulls the latest positions without reloading the page, keeping a long-running control-room session current.

Section 02

Target Layers & Details

Every pin opens into the detail an operator actually needs — no two target types show the same card.

The Targets panel on the left lists every category live on the map — Events, Responders, Users, Smartpoles, Fixed Targets, Mobile Targets, and Facilities — each expandable to its individual entries. Clicking any pin or list entry opens a detail card tailored to that target type.

Event detail popup showing a Medical event with code, status, and priority
Event pin → type, code, status, priority, and a View Details link into the full event record
Responder detail popup with Location History time range selector
Responder pin → name, type, on-duty status, call sign, and View History with selectable time ranges
Fixed Target facility popup for an ESKOM substation with Cameras and Access buttons
Fixed Target (facility) pin → status and address, plus direct jumps to Cameras or Access control
Smartpole target popup showing code, type, and offline status
Smartpole pin → device code, type, and live online/offline status
LayerMarkerWhat the card shows
EventsRedType, code, status, priority, View Details
RespondersBlueName, type, duty status, call sign, View History
UsersPurpleCitizen account markers for reported incidents
SmartpolesGreenDevice code, type, online/offline status
Fixed TargetsBlueFacility name, status, address, Cameras/Access/Details
Mobile TargetsOrangeTracked mobile assets (vehicles, patrol units)
FacilitiesBluePolice stations, hospitals, clinics, fire stations, metro police

One click from map to record. Every popup is a jumping-off point, not a dead end — View Details, View History, Cameras, and Access all route straight into the relevant module, so the map stays the fastest way to get to any target's full record.

Section 03

Live Mission Map

A tactical map built for one deployment at a time — mission intel, Blue Force tracking, and a radial action menu in place of ordinary map controls.

Live Mission Map is the control-room counterpart to the Special Ops flow in the Responder App — the same mission, tracked from the operator's side with a full tactical toolset layered over the map.

Mission Tools

Opening a mission surfaces a dedicated tools panel, grouped by function: measurement and orientation tools, navigation aids, team communication, and geofencing for marking zones directly on the tactical map.

Mission Tools panel with Tools, Navigation, Communication, and Geofencing groups
Mission Tools → Orientation, Routes, Range Tools · Track History, Waypoints, Radar View, GPS Lock · Video Feed, Team Chat, SITREP, Send Alert · Circle/Polygon/Rect Zone
🧭
Tools
Orientation, Quick Pic, Compass, Routes, Range Tools, Measurement, Clear Bearings.
📡
Navigation
Track History, Waypoints, Radar View, Map Layers, Grid Ref, GPS Lock.
💬
Communication
Video Feed, Team Chat, SITREP, Send Alert, Signal Strength, Settings.
📐
Geofencing
Circle Zone, Polygon Zone, Rect Zone — drawn live for the current operation.

Selecting a mission

A mission dropdown switches the entire tactical view to a different active deployment, each tagged with its own SPECOPS code and status. Selecting one loads its area of operations, routes, and live Blue Force positions.

Mission dropdown selector with SPECOPS mission codes
Mission selector → switch between active deployments (e.g. SPECOPS-2026-311), loading its own geofence, route, and team
Mission Intel panel and Blue Force roster over satellite imagery
Mission Intel → priority, area of operations, objectives, and rules of engagement, alongside a live Blue Force roster

The radial tactical menu

Tapping a team member's marker replaces standard map controls with a radial menu of mission actions — messaging, PTT, alerting, and tracking tools arranged one tap from the center.

Radial tactical menu with Tac Chat panel open
Radial menu → Private PTT, Navigate, Alert, Message, Threat Ring, Breadcrumbs, Lock On, Range/Bearing, Details
SITREP Log panel with routine reports and a responder assignment infographic
SITREP Log → timestamped situation reports from the field, including voice notes and attached briefing material

Built for a deployed team, not a solo call. Threat Ring, Breadcrumbs, and Lock On give a commander live tactical awareness of their own team's movement and exposure — tools an everyday single-responder assignment on Map View simply doesn't need.

Section 04

Map Providers & Settings

The tactical map isn't locked to one provider or one look — switch basemaps, layer types, and lighting presets per mission.

Map Settings controls how the tactical map itself renders — which provider powers it, what kind of imagery it shows, and a set of lighting/detail presets suited to different operating conditions.

Map Settings panel with provider, layer type, 3D buildings, and presets
Map Settings → Provider (Google / Mapbox / OSM), Layer Type (Road / Satellite / Terrain / 3D), 3D building tilt, and saved presets
Default
Standard daylight road view for routine tracking.
Night Ops
Darkened basemap tuned for low-light situational awareness.
Search Mode
Optimized contrast for scanning terrain during a search operation.
Surveillance
Satellite-first view for static observation of a fixed area.
Tactical 3D
Tilted 3D buildings for line-of-sight and approach planning.
Shared by Team
Presets other commanders have saved and shared for reuse.

Presets travel with the team. Once a commander saves a configuration, it can be shared to the whole team — so everyone deployed on a mission sees the map the same way, without each person reconfiguring providers and layers individually.

Map View and Live Mission Map, together

Map View keeps the control room oriented on everything happening across the coverage area; Live Mission Map gives a single deployment the tactical depth it needs once it's underway. See the Responder App Guide's Special Ops section for how this same mission looks from the field, and Responder Management for how team assignments are configured.