Location page

Location page

Overview


The Locations page provides real-time tracking and monitoring of all trackables on an interactive map. It combines live location updates, filtering capabilities, and issue/alert management in a unified interface.

Access: Applications > [Your Application] > Locations (left navigation menu)
URL Pattern: `/applications/{application_id}/locations`


Page Layout


Desktop View

The page is divided into two main panels:

Left Panel
- Two tabs: Assets and Issues (Alerts/Reporting)
- Tab selection updates the list content dynamically
- Search field to filter list by text
- Saved Filters section for quick filter access
- Property Type Filters for detailed filtering
- Multiple filter values can be selected simultaneously
- Status bar at bottom showing online (green) and offline (red) asset counts
- List updates in real-time based on selected tab and applied filters

Right Panel
- Interactive map with real-time locations

Mobile View

- Step 1: Configure filters
- Step 2: View trackable list
- Step 3: View map
- Navigate by swiping or clicking step headers


Trackables Tab [ 1 ]

Search Bar [ 3 ]

- Search by trackable name or tracking ID
- Real-time filtering with 300ms debounce
- Clear button to reset search

Saved Filters [ 4 ]

- Click to apply pre-configured filters
- Filters created in Filters menu
- Active filter is highlighted
- Shows only displayed filters

Property Type Filters [ 5 ]

- Expandable panel with all property types
- Multi-select values per property type
- Clear Filters button to reset all selections
- Save Filter button to create new saved filter

Trackable List [ 6 ]

- Shows filtered trackables (100 per page)
- Location status indicator (colored dot):
  • Green: Online with recent location update
  • Orange: Active but no location data
  • Red: Offline, no recent updates
- Click trackable to select and center on map
- Subtitle shows current zone and custom property


Issues Tab [ 2 ]

Zone Filter

- Multi-select dropdown for zones
- Filter issues by one or multiple zones
- Chip display for selected zones

Date Range Filter

- From: Start date-time
- To: End date-time
- Validation: Start must be before end
- Default: Today from midnight to current time

Action Buttons

- Refresh: Reloads issues list with current filters
- Reset: Clears date range and zone selection

Issues List

- Shows alerts and detections (15 per page)
- Color coded: Red (unsolved), Green (solved)
- Click issue to view on map
- Shows creation date and time


Map Features

Real-Time Tracking

- MQTT-based live location updates
- Trackables move on map in real-time
- Automatic floor switching based on altitude
- Location status monitoring

Floor Plans

- Indoor floor plans from NAO Cloud
- Multiple buildings and floors support
- Encrypted floor plan delivery
- Smooth transitions between floors

Outdoor Maps

- OpenStreetMap integration
- Seamless indoor/outdoor transitions
- Zoom and rotation controls

Zones Display

- Shows configured zones on map
- Color-coded by alert level:
  • Red: Critical alerts
  • Orange: Warning alerts
  • Yellow: Info alerts
- Click zone to view trackables inside

Map Toolbar

Site Selector

- Dropdown to switch between sites
- Only visible if multiple sites configured
- Changes map view to selected site

Building Selector

- Dropdown to switch between buildings
- Only visible if multiple buildings in site
- Updates floor selector options

Floor Selector

- Dropdown to switch between floors
- Shows altitude for each floor
- Updates map to display selected floor plan


Selection and Details

Trackable Selection

- Click trackable in list or on map
- Details panel appears on map
- Shows trackable attributes and property values
- Map centers on selected trackable
- Floor automatically switches to trackable's altitude

Zone Selection

- Click zone on map
- Details panel shows zone information
- Lists trackables currently in zone
- Shows trackable categories

Issue Selection

- Click issue in list
- Map highlights affected zone
- Details panel shows issue information
- Lists detections with timestamps and alert levels

#Details Panel

- Floating panel on map
- Resizable width
- Show More button for additional properties
- Actions menu (⋮) for single trackable:
  • Edit: Modify trackable attributes
  • Delete: Remove trackable
  • Dynamic Properties: Manage property values
- Close button to deselect

Location Status Indicators

Green (Online)

- Recent location update received
- Trackable is actively transmitting
- Location data is current

Orange (No Location)

- Trackable is active but no location data
- May be out of range of BLE listeners
- Check tag battery and listener coverage

Red (Offline)

- No recent location updates (older than 2 hours)
- Tag may be powered off or out of range

Status Check

- Automatic check every 2 minutes
- Updates status indicators in list
- Click status dot to filter by status


Filter Behavior

Combining Filters

- All filters use AND logic
- Search + Property filters + Status filter
- Filters apply to both list and map
- Real-time filtering as you type

Saved Filters (Filter Behavior)

- Click to apply saved filter
- Overrides current property selections
- Can be combined with search
- Deselects when modifying property filters

Clear Filters (Filter Behavior)

- Clears all property type selections
- Keeps search text
- Keeps saved filter selection
- Resets to full trackable list


Issue Management

View Issue Details

- Click issue in list
- Details panel shows issue title, creation date/time, alert level, affected zone, and detection history
- Map highlights affected zone

Resolve Issue

- Click Actions menu (⋮)
- Select "Resolve Issue"
- Issue marked as solved
- Color changes to green
- Remains in list for audit trail

Delete Issue

- Click Actions menu (⋮)
- Select "Delete"
- Confirmation required
- Permanently removes issue
- Admin permission required

Edit Issue

- Click Actions menu (⋮)
- Select "Edit"
- Opens issue edit page
- Admin permission required


Real-Time Updates

MQTT Connection

- Automatic connection on page load
- Status indicator in top-right corner
- Reconnects automatically if disconnected
- Error notifications if connection fails

Location Updates

- Batch processing for performance
- Updates map and list simultaneously
- Maintains filter state during updates
- Zone assignments update automatically

Data Synchronization

- Trackable attributes sync in real-time
- Property values update automatically
- Zone colors update based on alerts
- Issue list updates on new detections


Troubleshooting

Map Not Loading

- Verify API key is valid
- Check browser console for errors
- Refresh page

Trackables Not Appearing

- Check filters are not too restrictive
- Verify trackables are active
- Clear all filters and try again

Location Not Updating

- Check MQTT connection (top-right indicator)
- Verify BLE listeners are active
- Check tag battery level
- Verify tag is in range

Issues Not Loading

- Check date range is valid
- Verify zone filter is not empty
- Click Refresh button
- Check browser console for errors

Status Indicators Wrong

- Wait 2 minutes for automatic update
- Refresh page to force update
- Check trackable last_seen_at timestamp




Info
This page show real-time assets registered on application.

Left panel

On the left, there is 2 tab : asset tab  1  , and the alerts (reporting) tab  2  .The list   6  below dynamically updates to show the content of the selected tab.
This list can be filtered by typing text in the search field  3 , or by using filters (property types) or saved filters  4 . It is possible to switch between filters and saved filter, and select mutiples filters values at once  5 
 The status bar  7  give an overview of the number of tag which are online (green) or offline (red)

Map

The floor selector   8  allows to switch between floors, buildings, or sites.
The details card  9  shows data from the selected element : name, category, last location date, etc. The data is differents depending on the element you have selected (zone, trackable, issue...) whereas the table  9  gives informations about the tag current property value (if trackable is selected) and other information, if applicable.

Info
Filters and their values are saved in local storage of your web browser, meaning that the selected values are persistent even if you leave the page and go back on it.

Filtering

You can filter items  by clicking on status type   7 . To cancel status filtering, just click again on the status, below the list.

You can also filter with saved filter or property type (regular filter) but not both. You can however use status filter + regular filter

    • Related Articles

    • NAO Flow Overview

      NAO Flow menu is a NAO Viewer sub menu that allow tag & journey association, dissociation and also journey tracking. Menu description Journey definition : this menu allows the management of journey definitions and journey step definitions. Map ...

    • NAO Viewer - Overview

      Architecture Communications avec NAO Cloud et NAO JS SDK Open MicrosoftTeams-image.png

    • Services activation

      NAO Cloud services : Certain NAO Cloud services must be activated in order to allow the proper functionning of NAO Viewer. This configuration can be different depending on the type of asset you have on your application, tags and/or smartphone. ...

    • Location History - Process & Scenarios

      Basic Process How to Download Location History 1. Select Date Range: Choose start and end dates (maximum 24 hours) 2. Select Assets: Pick one or more assets from the list 3. Click Download: System retrieves location records 4. Wait for Processing: ...

    • Application list

      Overview Displays all NAO Viewer applications you have access to after login. Access: Click NAO Viewer logo or navigate to `/applications` As a regular user, you'll typically see 1-3 applications assigned to you. Screenshots may show more ...