Geographic & Indoor Maps

Intro

OpenWISP provides a unified web interface 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.

Indoor Map View with Floor Navigation

Indoor map view

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

Shareable Geographic Map URLs

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

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

Location View from Device Details Page

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

Indoor Device View from Device Details Page

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

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.