Geographic & Indoor Maps

General Geographic Map

OpenWISP provides a unified geographic map to monitor network status across all scales: start with a global geographic overview, drill down into specific buildings via indoor maps, and switch between floors to track devices in real time.

The global map overview shows locations with installed devices and provides a visual overview of their monitoring status.

When a location contains multiple devices, its marker reflects the most common active health status.

Note

When a location contains multiple devices and the most common statuses are tied, any tied set including ok or problem is shown as problem. A tie limited to critical and unknown is shown as critical.

Deactivated devices are generally excluded from these calculations. If all devices at a location are deactivated, its marker is shown in the deactivated color.

See also

The geographic map dashboard is built on top of the OpenWISP Utils Dashboard.

It is enabled by default and can be disabled with the boolean OPENWISP_MONITORING_DASHBOARD_MAP setting. See OPENWISP_MONITORING_DASHBOARD_MAP.

Indoor Map View with Floor Navigation

The dashboard map includes an indoor view with floor switching and full-screen mode.

Shareable Geographic Map URLs

Interactions with location or device nodes on the geographic map update the URL, which can be bookmarked or shared.

Shareable Indoor Map URLs

Interactions with indoor device nodes update the URL, which can be bookmarked or shared.

Jump from Device Detail to General Map

Easily jump from the device detail page to the full geographic map, where the current device is already in focus and nearby devices are visible.

Jump from Device Detail to Full Indoor View

Easily jump from the device detail page to the full indoor map, where the current device is already in focus and nearby devices are visible.

Real-Time Device Position Updates

Device positions on the map are updated when new location data is received.

Real-time map updates are delivered using WebSocket connections, allowing the frontend to receive live location data without polling. The common location broadcast channel is available at /ws/loci/location/ and is used to push device location updates to geographic map views as soon as new data is received.

The location broadcast channel requires authentication. Access is controlled based on organization membership:

• Superusers: Can receive location updates for all organizations.

• Regular Users: Can only receive location updates for organizations they manage.

This ensures that location data is properly scoped and users can only receive real-time updates for locations within their managed organizations.