Login. General > Sites General > Levels General > Floor plans General > Accounts General > Geo-Fences

Transcription

1 Wi-Fi Location Monitor Dashboard 1 Please be aware that the Accuware dashboard is a powerful administration tool based on Javascript, CSS and HTML that uses exactly the same set of Accuware Wi-Fi Location Monitor API that we provide in order to integrate the indoor location capabilities, inside your applications. The Accuware dashboard allows to manage and monitor the resources associated with a site, without having to call the Accuware API. It is not a product that Accuware sells or customizes (even if we are open to suggestions to make it even more powerful). Login General > Sites General > Levels General > Floor plans General > Accounts General > Geo-Fences WiFi Location Monitor > Map WiFi Location Monitor > Nodes WiFi Location Monitor > Devices WiFi Location Monitor > Cloudtrax WiFi Location Monitor > Settings WiFi Location Monitor > Analytics WiFi Location Monitor > Heatmap Login Access the Accuware dashboard at at this link and follow the instructions on the login screen. Please supply the credentials contained in the from Accuware Activation and press the Login to Dashboard button. Demo account: if you do not have an Accuware account but you would like to test our powerful dashboard. You can do it by using these credentials: username: demo@accuware.com

2 Wi-Fi Location Monitor Dashboard 2 password: Accuware2018 General Sites

3 Wi-Fi Location Monitor Dashboard 3

4 Wi-Fi Location Monitor Dashboard 4 Once authenticated you will be automatically redirected under the Sites sub-section of the General section where you will find the following areas: Current Site: summarizes and lets you change basic information of the site. Site Id: your unique site identification. Name: your custom site name. Description: the expiration date of your site along with the type of account (FREE EVALUATION or PRODUCTION). Address: this coordinates allows to place the Map on the area of interest. Access: this is the access level associated with your account (identified by your address).

5 Wi-Fi Location Monitor Dashboard 5 Access level: Accuware accounts have 3 access levels for each account registered with a site. Users with Read-Only access (access = 10) are not allowed to make changes to the site, while users with Read-Write access (access = 20) can modify data regarding nodes (when available) and stations. Full control access (access = 30) is required to create and delete user accounts within a specific site. Available Sites: summarizes your list of sites (along with some basic information) and lets you switch from one site to another by clicking the Select button on the right side of the table. Levels

6 Wi-Fi Location Monitor Dashboard 6 This sub-section enables you to manage the logical levels associated with a specific site. Use the levels mechanism to group nodes based on: their vertical positions (e.g. groups of nodes placed on different floors of the same store). or their different locations (e.g. groups of nodes placed in different stores of the same shopping mall). PLEASE READ: For each Site you will find the default level with LevelID 0. This level can not be eliminated. Using the Accuware dashboard it is possible to create 30 Levels (in addition to Level 0). Additional levels can be created using this PUT API call. To create a new logical level you need simply to: 1. Click on the Add Level button. 2. Select a LevelID for the new level. 3. (OPTIONAL) insert a Name and a Description.

7 Wi-Fi Location Monitor Dashboard 7 4. Click on Save. You can also Edit the information associated with a level or Delete a level by using the buttons on the right side of the table. Floor Plans This sub-section enables the management of the floor plan(s) associated with each logical level of a site. Please keep in mind that even if it is possible to associate more than one floor plan for each one of the levels of a site, this practice is strongly discouraged. To upload a new floor plan you need simply to read the step by step guide at this link. You can also View a floor plan, Edit the information associated with a floor plan or Delete a floor plan by using the buttons on the right side of the table. Touch screen laptops: on some combination of laptops equipped with a touch screen and browsers it is not possible to use the touch pad mouse/bluetooth mouse/usb mouse to scale/move/rotate the image. If you encounter issues we recommend to try a different browser.

8 Wi-Fi Location Monitor Dashboard 8 Accounts This section enables the management of the users who are allowed to access to the Accuware dashboard (and allowed to call the Accuware API): Your account: allows the assignment of a new password for the user account currently logged in. Registered Accounts: gives a list of users currently registered in the site and allows to Change the Access level of a specific account (see below) or to Delete a specific account. To create a new account you need simply to: 1. Click on the Add Account button 2. Insert the address of the new user 3. Select the Access level for the new user (see below) 4. Click on Save Please be aware that the initial password for the new user will be EMPTY and the new user will be able to change his/her password under the Accounts section after the first login). Access levels: Accuware accounts have 3 access levels for each account registered with a site. Users with Read-Only access (access = 10) are not allowed to make changes to the site,

9 Wi-Fi Location Monitor Dashboard 9 while users with Read-Write access (access = 20) can modify data regarding nodes (when available) and station. Full control access (access = 30) is required to create and delete user accounts within a specific site. Geo-fences

10 Wi-Fi Location Monitor Dashboard 10

11 Wi-Fi Location Monitor Dashboard 11 This section enables the management of the geo-fences associated to the levels of your site. Geo-fences are virtual polygons (made of multiple vertex) that can be used to divide a floor plan into multiple virtual fences allowing afterwards to identify the fence in which each device is located: looking at the Geo-fence column of the Map section of the Accuware dashboard. or looking at the areas field of the JSON returned by the station API call. To create a geo-fence: 1. Select the level of interest using the drop-down menu in the top-right corner of the map. 2. Leave the top-left button to INCLUDE. 3. Click on the button with the star and click on the map to define the first vertex of the geo-fence. 4. Click on the map to define the geo-fence (each geo-fence can contain an unlimited number of

12 Wi-Fi Location Monitor Dashboard 12 vertex). At the end click on the first vertex to close the geo-fence. The geo-fence has been created and an ID has been assigned to it. To modify a geo-fence: 1. Click on the geo-fence area. 2. Modify the geo-fence vertex. 3. Click outside the geo-fence area. In order to delete a geo-fence: 1. Click inside the geo-fence area. 2. Click on the Trash button. Accuware Wi-Fi Location Monitor Map

13 Wi-Fi Location Monitor Dashboard 13

14 Wi-Fi Location Monitor Dashboard 14 This page is your main view to your Accuware Wi-Fi Location Monitor installation: Accuware Wi-Fi Location Monitor maps: this section of the page shows for your current site summary information about the total number of nodes, the number of known devices detected in the past 5 minutes, the number of unknown devices detected in the 2 hours. the position(s) of the node(s): a green icon indicates a properly working node; a red icon means that there is a problem and the node is not sending any report to the Accuware server from at least 15 seconds. If the problem persists, check here for solutions. the location(s) of the station(s) detected by the nodes: ORANGE dots: unknown stations active in the past 10 minutes. YELLOW dots: known (registered) stations active in the past 5 minutes. GREY dots: known (registered) stations active in the past 60 days (but not seen anymore from more than 5 minutes). By clicking on the dots you will be able to see the last time a device has been seen in the site. Below the map it is possible to find a set of tools useful to filter the information shown on the map. In the top-right corner of the map there are: a button to enlarge the Map to full screen. a drop-down menu that allows to select the level of the site to be shown. In the top-left corner of the map there are 3 buttons that allow to customize the map underlying the floor plan. You can choose between the Google Satellite view, the Google Map view or the Floor Plan (previously uploaded). This last choice allows you to increase with no limits the zooming capabilities on your floor plan. Please try it! Devices: this section of the page shows the list of all the WiFi devices registered within the site (devices can be registered inside this area): Name: an optional name associated to the device. Description: an optional description associated to the device. MAC: is the MAC address of the device. Level ID: is the level on which the device has been added.

15 Wi-Fi Location Monitor Dashboard 15 Mfr/Type: if available, this field contains the manufacturer of the Wi-Fi chip of the device. This information is added at run time by a Javascript embedded inside the dashboard. If you are interested in having the same type of information, you can download the list of manufacturers prefixes from the official repository at this link. To find the manufacturer for a particular device, you use the first six digit of the station s MAC address for a look-up in the register (e.g AC:86:74XX:XX:XX > Open Mesh Inc.). Last Seen: shows when the device has been seen last time by at least one of the nodes. N/A means that the device has never been seen active or has not been seen active since the last upgrade of the Accuware dashboard. Geo Fences: shows the IDs of the geo-fences in which the device is currently located. Show button: enable the visualization of a specific WiFi devices. It must be used in conjunction with the Selected button bellow the Map. Nodes: this section of the page shows several information regarding the nodes registered within the site: Name: an optional name associated to the node. Description: an optional description associated to the node. MAC: is the MAC address of the node. Level ID: is the level on which the node has been added. Last Report: is when the node sent its last report to the Accuware server. Devices in Range: is the number of devices seen in the last report. Status: a node is considered ACTIVE, if it has been able to transmit at least a report in the last 15 seconds. Nodes

16 Wi-Fi Location Monitor Dashboard 16 This page allows the management of the nodes of your site: Node Map: this section of the page shows the all the nodes of a specific level of your site. It is possible to do the following actions: Add a node: you can do so by following these simple steps: 1. Chose the level on which you want to add the node(s) by using the drop-down menu in the topright corner of the map.

17 Wi-Fi Location Monitor Dashboard Activate the Floor Plan visualization by clicking the button in the top left corner of the Map (this enable the highest level of zooming we strongly invite you to use it!). 3. Click on the map to create a new node. The node positions, set using the Accuware dashboard, are used to resolve the location of the mobile devices by the Accuware Wi-Fi Location Monitor engine and this is why it is mandatory to closely match the nodes map locations with their physical locations. 4. Insert a the MAC address of the node(s) (MAC addresses must have this format AA:BB:CC:DD:EE:DD). 5. (OPTIONALLY) insert a Name and a Description for the node(s). Delete a node: you can do so by clicking on the node and clicking the Delete button. Move the node: you can do so by dragging and dropping one or more nodes in a new location. Nodes: shows the list of all Open Mesh nodes registered with the site. It is possible to Edit the information associated with a node (Name, Description, LevelID, Latitude and Longitude) or Delete a node by clicking the button on the right side of the table. Devices

18 Wi-Fi Location Monitor Dashboard 18 This page allows the management of all the stations (Wi-Fi devices) detected by the nodes: Known devices: this section of the page shows the list of all the known Wi-Fi devices registered within the site. It is possible to Edit the information associated with a Known device (Name, Description) or Delete a specific Known Device by using the buttons on the right side of the table.

19 Wi-Fi Location Monitor Dashboard 19 To add a Known device inside the list you need simply to: 1. Click on the Add Device button. 2. I n s e r t a t h e M A C a d d r e s s o f t h e d e v i c e ( M A C a d d r e s s e s m u s t h a v e t h i s f o r m a t AA:BB:CC:DD:EE:DD). 3. (OPTIONAL) insert a Name and a Description. Other devices: this section of the page shows the list of all the unknown Wi-Fi devices detected in proximity of the site during the past 2 hours. It is possible to Add a Wi-Fi device among the list of Known devices clicking on the Edit button under the Action column. Cloudtrax In this sub-section you will see the status of the Open Mesh nodes inside the Cloudtrax dashboard. The Cloudtrax dashboard is a third-party dashboard that provides a convenient way to monitor and configure the Open Mesh Wi-Fi network used by Accuware Wi-Fi Location Monitor. You have to keep in mind that this tool is NOT at all involved in the trilateration of the locations of the Wi-Fi devices detected. If you want to see more information about the status of the Open Mesh network and to modify all the parameters associated with your Open Mesh network you can login to Cloudtrax at this page using the credentials provided in the Accuware Activation . Settings

20 Wi-Fi Location Monitor Dashboard 20 This page allows the management of advanced information of the site: Report Frequency: this is the frequency at which the nodes scan the environment looking for MAC addresses on a specific channel. Right now it is NOT possible to increase the frequency of the reports. Node Type: indicates the type of node. Please make sure that the type of nodes you bought from Open Mesh is the same type listed here (OM2P, OM2P-LC or OM2P-HS). If not lease submit a support request using this form immediately! RssModel: using this setting you can force the system to use a specific model to estimate the positions of the devices. You can try to change this parameter to a specific value and see if you notice improvement in the positions: Linear works best if you operate the network in environments with many walls. Logarithmic is better suited for open spaces or buildings with large rooms. It can take up to 5 minutes before the new model kicks in. When this model is chosen the WiFi devices outside the perimeter of the nodes tend to be pulled towards the area with the WiFi nodes. Anyway, as explained inside this page, the locations outside the perimeter of the WiFi nodes are not accurate and should not be taken into account. Noise Reduction: enables a filter that will remove some of the noise present in the measurements. The filter should be able to make the locations less jumpy, although it might introduce some latency in the locations updates. Again, the best advice is to try different settings and see if any of them improves the locations. It will take up to 1 minute before this setting becomes active.

21 Wi-Fi Location Monitor Dashboard 21 Analytics If you see the error message Error, this site is not enabled for Accuware Analytics. Please submit a support request using this form to activate Accuware Analytics when trying to access the Analytics area of the Accuware dashboard, it could be for one of the following reasons: The Analytics section of the Accuware dashboard is not active. Please keep in mind that it is not activated by default with an Accuware WiFi Location Monitor

22 Wi-Fi Location Monitor Dashboard 22 account. If you want to activate the Analytics section on your account please submit a support request using this form. The Analytics section of the Accuware dashboard is active but your nodes have never been seen active. You will be able to access the Analytics section of the Accuware dashboard only when there will be at least 1 node active (GREEN) inside Accuware dashboard (and inside the Cloudtrax dashboard). If you just want to take a look at the Analytics section of the Accuware dashboard and the Analytics section is not yet active on for site, you can log-out from your site and login these credentials: username: demo@accuware.com password: LEAVE EMPTY Keep in mind also that it takes some hours for the Accuware Analytics charts to show meaningful information. The Analytics section of the Accuware dashboard allows to see and export the information related to 4 different metrics. Map View: a green icon indicates a properly working node; a red icon signifies that the node lost connectivity to the server. If the problem persists, you can find a solution in this page. Real-time Updates: summarizes the number of unique stations detected by all the nodes in their last reports. Every 5 seconds each node reports to the Accuware server the number of unqiue Wi-Fi devices detected and these reports are aggregated to show the count of unique visitors seen by all the nodes of your site. Site Statistics: shows the count of unique visitors seen since the beginning of the day, week and month. Recent Visitors: shows the number of unique visitors seen in the last 6 hours or the number of reports received by the Accuware server in the last 6 hours. Data is aggregated at 10 minutes intervals. EXAMPLE: if you walk by 3 times, say between 10:00:01 AM and 10:09:59 AM, it counts you as one.

23 Wi-Fi Location Monitor Dashboard 23 If you walk by again at 10:10:00 AM it will count you another time. If your site contains multiple nodes, use the Settings link (in the top-right corner of the graph) to display data from all the nodes or a sub-set of nodes. Historical Data: displays counts for a specific time period (From-To) and a specific granularity (Freq). By default you will see the unique visitors seen by all the nodes of your site during the past 7 days. Settings: if your site contains multiple nodes, use the Settings link (in the top-right corner of the graph) to display data from all the nodes or a sub-set of nodes. Under the Settings menu you can also choose between 4 different metrics: Unique Visitors (unmc): counts the number of unique visitors (unique MAC addresses). Again, if you select Freq Hourly, it will count you as one if you walk by any time between 10:00:00 AM and 10:59:59 AM, and then it will count you again if you walk by any time after 11:00:00 AM. Report Count (repc): counts the number of reports transmitted by nodes. When working properly, the nodes send 1 report every 5 seconds (a total 720 reports/hour). If there are problems with the Internet connection and the repc is lower than 720 reports/hour, then you might see a drop in the number of Unique Visitors (unmc) simply because the node is not able to transmit the reports to the Accuware server. In Place Visitors (idh3): represents for each hour, the number of visitors seen, at least once, during the previous 3 hours and it is used to see the stationary visitors. This means that if a MAC address is detected (at least once) between [7:00:00 AM-07:59:59 AM], between [8:00:00 AM-08:59:59 AM] and between [9:00:00 AM-09:59:59 AM], then at 10:00:00 AM, the MAC address is counted as a In place visitor. IMPORTANT: Obviously, the graph can be seen only with the Hourly frequency filter is selected. Unique daily devices by hour (undh) : represents for each hour, the number of new visitors seen during the previous hour. By new we mean never detected so far since the beginning of the day. This means that if a visitor is seen multiple time during a day it will be counted only once. IMPORTANT: Obviously, the graph can be seen only with the Hourly frequency filter is selected. Export (.csv): you can also export CSV files which contain the following fields for each row: the time stamp

24 Wi-Fi Location Monitor Dashboard 24 one or more of these metrics: 1. Unique Visitors (unmc) 2. Report Count (repc) 3. In Place Visitors (idh3) 4. Unique daily devices by hour (undh) Before exporting the CSV file, you have to: 1. Choose the metric(s) of interest by clicking the Settings button. 2. Filter on the time window (From-To). 3. Filter on the frequency (Freq). 4. Click on Export (.csv) button. The gear button in the top right corner of the page (under the siteid) allows you to change the Node sensitivity. This parameter allows you to set the sensitivity of all the nodes. This means that Analytics will count only the Wi-Fi devices with an RSS higher (or equal to) the chosen threshold. Moving the slider to the left reduces the threshold/detection radius (thus reducing the number of Wi-Fi devices counted). Please keep in mind that it is not possible to set different RSS thresholds for different nodes. RSS vs distance: even if it is true that the RSS value, for a Wi-Fi device, decreases as the distance from the node increases. It is also true that the RSS value does not decrease linearly and it is also affected by different materials in the environment. For these reasons we suggest to perform some empirical tests to determine how the RSS varies with the distance from the nodes (the spots) in your specific environment. These kind of empirical tests can be performed following the instructions in this support page. Heatmap

25 Wi-Fi Location Monitor Dashboard 25 A heatmap is a graphical representation of data where values in a matrix are represented as colors. A simple heat map provides a compact, visual summary of quantitative information. Some elaborate heat maps enable viewers to visualize complex data sets. Location-related data is usually overlaid on a map, a floor plan or a satellite view. The Heatmap section of the Accuware dashboard is a demonstration tool that allows to see the density, over time, of the devices detected by Accuware Wi-Fi Location Monitor. Location-related data is usually overlaid on a the Google Map/Satellite view or on the floor plan uploaded. Please be aware that: The Heatmap section of the Accuware dashboard is not activated by default with a Accuware Wi-Fi Location Monitor account. The Heatmap section of the Accuware dashboard is activated upon explicit request. The Heatmap section of the Accuware dashboard can be used ONLY in conjunction with: Accuware Wi-Fi Location Monitor. and the Accuware CSV service.

26 Wi-Fi Location Monitor Dashboard 26 The Heatmap section of the Accuware dashboard may be subject to changes and interruptions due to system maintenance and upgrades. Notifications of possible interruptions in case of updates are provided well in advance. If you just want to take a look at the Heatmap section of the Accuware dashboard and the Heatmap section is not yet active on your site, you can logout from your site and loging these credentials: username: demo@accuware.com password: EMPTY SiteID: 1001 How to visualize a heatmap 1. Select the desired floor plan using the pull-down menu in the top-right corner of the large map. The floor plan will appear superimposed on the map 2. Under Synchronization: 1. Check if the Timezone detected by the system is the correct timezone. If not, please change the timezone using the drop-down menu. 2. Fill the Sync data up to field with the number of previous days that you want to use in your analysis. 3. Click on Synchronize now to retrieve the data from the server. After the synchronization is complete, a density map will appear over the floor plan. 3. You can use the controls in the Display section to manage the data set. You can: view data for a specific day using the Select day pull-down menu. select the size (in terms of number of hours) of data to be displayed for each day. It is possible to see the aggregated data for a 24-hours period, or just data for a 10-minutes window. 4. You can use the controls in the Settings section to manage the data visualization by changing the following parameters: Opacity: the opacity of the heat map, expressed as a number between 0 and 1. Radius: the radius of influence for each data point, in pixels. Max Intensity: the maximum intensity of the heat map. By default (when set to 0), heat

27 Wi-Fi Location Monitor Dashboard 27 map colors are dynamically scaled according to the greatest concentration of points at any particular pixel location on the map. This property enables setting the maximum value. Setting the maximum intensity can be helpful when the data-set contains outliers with an unusually high intensity (e.g. if you set max intensity to 20, all the areas in which there are more than 20 points will be colored in red). How to integrate the heat maps inside your dashboard You can easily build a heat map visualization tool using: the data provided by the Accuware Wi-Fi Location Monitor API or the Accuware CSV service. and the Google Heat Maps APIs. Alternatively you can visualize the Heat maps area of the Accuware dashboard inside your web application following the info inside this support page.