- Introduction
- Pre-requisites
- Setup of the MIST GUI
- Setting up MIST map orientation
- Setting up Mist in SafeZone
Introduction
SafeZone can be integrated with Juniper MIST's indoor positioning system to locate alerts and check-ins within 5 metres on a specific floor of a building. When SafeZone is deployed on sites with multi-storey buildings this can reduce response times to incidents, increase situational awareness of your assets and in doing so increase positive outcomes.
Pre-requisites
- Juniper MIST license
- Juniper Access Point models which are recommended for indoor positioning and are deployed with sufficient density for the accuracy required (check with your Juniper representative)
- Setup a user for CriticalArc for the duration of the setup to verify config and assist with setup
- SafeZone Command with API integration license purchased from CriticalArc
- SafeZone Command should have a region above all buildings with indoor positioning
- Locations setup in MIST including with floorplans which are:
- Accurate and to scale and scale matches each building
- Floor Names should end with the ordinal number according to their location, e.g. 00 for ground, 01 for first, -1 for basement, etc.
Recommended format: {Building Name} {Floor number} - e.g. Science Center 01 / Library -2 / Central Tower 18 - With one drawing per floor of a building and one building per site
- Origin set at the top left corner of the image so X=0 and Y=0 (Under "Setup Floorplan" then "Set Origin")
- Orientated the same way for every floor of the building (e.g. north is always at the top of the page or a specified angle i.e. 37°)
- Same size in pixels for the overall image.
- Plan edges should not extend significantly beyond the bounds of the building
- Ideally have a solid background for the floor and are transparent outside the building (this is so it shows best on Command)
- Showing the necessary detail for Command view (the floorplan will display whatever is on the map in MIST)
Setup of the MIST GUI
NOTE: The guidance on the MIST system is for information and is correct at the time of writing since it is managed by Juniper and subject to change. Please speak to your system provider for the most up to date information on setting up the MIST system.
- Go to MIST setup page: https://manage.eu.mist.com/ and login
- Set the MIST system up as per the above pre-requisites
- Create a Mobile SDK Token (Organization – Mobile SDK)
- Create an API Token (Organization API Token)
Setting up MIST map orientation
NOTE: The guidance on the MIST system is for information and is correct at the time of writing since it is managed by Juniper and subject to change. Please speak to your system provider for the most up to date information on setting up the MIST system.
To orientate the map onto command you will need to use the API tool we need to setup Geo reference parameters on each floor.
- Log into the MIST GUI (https://manage.eu.mist.com/)
- Go to Location – Live View and use the dropdown selector to find the site
- Select any floor (ideally one which shows the outside walls of the building)
- Click On “Beacons” and then “Add VBeacon”
- A green beacon will appear in the middle of the map labelled “Anonymous” drag and drop it to a corner of the building which is distinctive enough to reference on Google Maps
- Note the x and y coordinates shown in the bottom right corner of the screen and importantly remove the minus symbol from the Y coordinate shown in the screenshot below.
- Note the equivalent points latitude and longitude in Google Maps by right clicking on the map and left clicking the lat / lon coordinates (E.g. 53.48038624996125, -2.2395416845943767)
- Move the VBeacon to another corner of the map and note the x,y coordinates again
- Reference the created point on Google Maps
- Move the VBeacon again, note the x,y coordinates and again reference against Google Maps.
- Cancel out of the beacon page
- You should now have 3 xy references linked to 3 lat / lon coordinates. Again note that the Y values should NOT be negative
- Make sure you are already logged in on the MIST site and then in a new tab go to the https://api.eu.mist.com/api/v1/sites/MIST-SITE-ID-HERE/maps/MIST-FLOOR-ID-HERE where:
- MIST Site ID is the end of the URL in the Location – Live View page after you use the dropdown selector to get the appropriate site
- MIST Floor ID is the section in the URL before the above Site ID in the Location – Live View page (after “…view/”).
- You should see a page like this:
- Enter the following into the second box marked with a “PUT” button underneath replacing the x and y and lat lon with the references created aboven and click PUT:
-
-
{"GeoRefParamsv2": {
"active": true,
"p1": {
"mist_xy": {
"x": 41.8274,
"y": -29.5208
},
"lat_lon": {
"x": 53.4803862499612,
"y": -2.23954168459437
}
},
"p2": {
"mist_xy": {
"x": 67.7965,
"y": -10.4218
},
"lat_lon": {
"x": 53.48081981,
"y": -2.238931443
}
},
"p3": {
"mist_xy": {
"x": 68.4189,
"y": -48.3576
},
"lat_lon": {
"x": 53.48062052,
"y": -2.238463798
}
}
}
}
-
-
-
Repeat steps 13-15 with new site and floor ids for each floor.
Setting up Mist in SafeZone
- Enable the MIST indoor positioning feature in SafeZone Command – Zone Configuration – Global Settings
- Select Juniper MIST Settings and enter
- Mist Access Token – This is created at an organization level in the MIST GUI under – Organization – Mobile SDK
- Mist Server API Token – This is setup at an organization level in the MIST GUI under – Organization – Settings – API Token – Create Token at a level that is at least “Network Admin”
- MIST Site ID can be left blank for now
- Go to the region you are setting up with indoor positioning and add the MIST Site ID: – This can be found at the end of the URL (…location/) in the Location – Live View page after you use the dropdown selector to get the appropriate site.
- Click “Refresh Overlays”, go to the Live screen and refresh the browser.
Comments
0 comments
Please sign in to leave a comment.