Skip to main content

Mapping

The Mapping module provides interactive maps for visualizing department resources, calls, and geographic data. It is managed by the MappingController.

Map View

The main map view displays an interactive map centered on the department's configured location (GPS coordinates or geocoded department address).

Map Data Layers

The GetMapData endpoint is the primary aggregation endpoint, supporting these toggleable layers:

LayerFlagDescription
StationsShowStationsStation group locations with geofences
CallsShowCallsActive call locations with priority markers
UnitsShowUnitsCurrent unit positions
PersonnelShowPersonnelPersonnel locations (permission-controlled)
POIsShowPOIsPoints of interest
DistrictsShowDistrictsResponse district boundaries
Permission Control

Personnel location visibility is controlled by the CanSeePersonnelLocations permission. This is configurable per department in the Security settings.

Map Layers

Map layers provide custom GeoJSON overlays on the map.

Creating Layers

Layers are defined using GeoJSON FeatureCollection format and stored in MongoDB.

FieldDescription
Layer NameDisplay name
GeoJSON DataFeature collection defining shapes and properties

Editing Layers

Modify layer name and GeoJSON data. Validates department ownership and not-deleted status.

Deleting Layers

Layers are soft-deleted (IsDeleted = true) rather than permanently removed.

Points of Interest (POIs)

POI Types

Create categories for points of interest with custom markers and images.

Individual POIs

Add specific locations under a POI type with:

  • Name and description
  • GPS coordinates (latitude/longitude)

POI Import (KML/KMZ)

Import multiple POIs from KML or KMZ files:

  • Uses IKmlProvider for parsing
  • Validates file type (.kml or .kmz)
  • Maximum file size: 10 MB

Viewing POIs by Type

The ViewType action filters the map to show only POIs of a specific type.

Live Routing

Call Routing

The LiveRouting action provides a routing view to a specific call location.

Station-to-Call Routing

The StationRouting action shows routing from a station to a call:

  • Resolves start coordinates from station address or GPS coordinates
  • End coordinates from call location

Data Endpoints

EndpointPurpose
GetMapDataAll map markers and geofences based on flag settings
GetTypesMapDataMap data for a specific POI type
GetPoisForTypePOI list for a specific type

Interactions with Other Modules

ModuleInteraction
CallsCall locations displayed as markers
GroupsStation locations and geofences displayed
UnitsUnit positions shown (from GPS tracking)
PersonnelPersonnel locations shown (permission-controlled)
DepartmentMap center, zoom, and refresh settings
SecurityPersonnel location visibility permission