Asset Location Tracking

Developer

Admin Panel

GoIndoor’s Admin Panel is a web based service which offers tools needed for the initial set up for your Indoor positioning project. It helps you manage your locations, create navigation routes, set up Points Of Interest (POIs), create notifications and define default properties for places, edges and notifications. This data is available to the applications through the GoIndoor library. Any changes made to any of the objects is instantly available to the applications through GoIndoor SDK.

The important change with this version is with respect to the UI of the application. It has been designed to make it more responsive and user friendly.

The Admin Panel functionalities discussed in the following sections are also exposed through a REST interface for use by third party applications. Refer this section for more details.

Login

To be able to access the Admin Panel, you need to contact us to register an account

After the account is successfully created, log in to the account and create a workspace account. Use the workspace credentials to login to the Admin Panel.

Manage Buildings

The first step of the setup is to provide the building and floor details to the GoIndoor library. Go to the ‘Mapping’ tab and use this console to create your building and add floor details.

To create a new building, follow the steps listed below:

  1. Go to the ‘Mapping’ tab from the left panel and click on the ‘+’ icon next to the ‘Create building’ drop down widget on the top of the page.

2. Provide building name and location on the following pop up screen. 

3. Click ‘Create Building’. This will create a new building.

4. All the buildings created will be shown in the drop down box at the top of the page.

Manage Floors

After creating a building, you can set up its floors. When a building is selected from the drop down menu on the top of the page, the existing floors for that building are listed under it. 

To add a new floor

  1. Click the ‘Add Floor’ button.

2. Enter the floor number and upload its detailed plan on the following page.

3. Click ‘Ok’.

4. Overlay the floor plan precisely on the underlying map . The floor plan image will show up on top of the map with three white dots. Decrease the overlay opacity and place those dots on the end points of the building. The ‘Keep Image Ratio’ switch on the map facilitates accurate placement of the plan on the map. It changes the way user can interact with the plan. When the switch is ON , the image vertex will be shown in blue and the user can resize the plan. With the switch OFF, three of its corners will be shown in white and can be moved to change the geometry of the plan, as needed.

5. Once the plan is properly placed, it appears as shown below.

6. The added floor shows in the floor list for the building.

7. Click ‘Save’ to save the information on the server.

8. You can add any number of floors to a building by repeating the steps listed above.

Note: Use the zoom features on the map to precisely mark the floor on the end points of the building. If you reach the maximum limit in satellite view, switch to the normal view.
 
To edit a floor
  1. Click the edit icon in front of the floor name in the floor list.

2. It shows the edit floor page.

3. Make changes as required and click Ok.

4. Click Save on the bottom to save the changes on the server.

 
To delete a floor
  1. Click the delete icon in front of the floor name in the floor list.
  2. Click ‘Ok’ on the confirmation page.

Manage Places

Places

A POI is a point or specific zone which may be interesting or useful to the visitors of the location. POIs can also be referred to as Places. For example, with reference to a university campus, the labs, library, canteen etc. may be referred to as POIs.

A POI can be a single point like in case of an ATM or a bigger area like a conference room in an office. 

This section will explain how to add Places Of Interest (POIs) on your map. 

To manage places, click on the ‘Places’ tab in the left pane. 

To add a new place

  1. Select the building and the floor where a new place is to be added.

2. This enables the ‘Add Place’ button. Click it to add a new place.

3. There are three types of place markers to choose from to mark your POI on the plan : pointed marker, circular marker or polygon drawer tool.

4. Choose the appropriate marker and give it a name.

5. Place the marker on the plan appropriately. The following sample image shows a circular place marked on the plan.

6. You can now edit the place to enter its properties, tags, color and associated notifications.

7. Click Ok.

8. Repeat the steps listed above to create any number of places for a floor. All the POIs for a floor will be listed under the floor.

9. The position or boundaries of the POI can be changed any time by clicking on it.

10. Click Save after making all the changes.

To edit the properties of the POI or delete a particular POI, click the edit or delete icons in front of the POI name.
 
Properties: Properties can be used to save additional information about the POIs. Like, if an area indicates a restaurant, you can use the property fields to store its opening and closing timings. This information can then be used in any way in the application. The SDK passes this information as it is to the applications when place information is fetched.
 
Tags: Tags can be used to save any attributes of a place. These tags can be used in the applications to group similar places, search through the places or for different graphical representations of the places. For example, if all the POIs which show doors marked as emergency exits have same tag, let’s say, ‘emergency_exit’, then the application can be coded so as to show these gates in a particular color on the map. The application can query the SDK with these tags to fetch only particular type of places.
 
Notifications

Notifications refer to different geolocalized events associated with a place or POI. There are four types of notifications that you can associate with any POI through the Admin Panel.

Enter – triggered when someone enters a particular POI.
Leave – triggered when someone leaves a particular POI.
Stay – triggered when someone is inside a particular POI and has stayed there for atleast a specified duration.

Nearby – triggered when someone passes nearby a particular POI.

You can create any number of notifications of these types to be sent to the visitors. These notifications are triggered by the SDK when the specified event happens and sent to the applications. It is then up to the application to handle them appropriately. 

To associate Notifications with a place

  1. Select the POI and click edit.

2. Go to the Notifications tab.

3. Select the type of notification to be added (enter, leave, stay or nearby) and click ‘Add Notification’ to add a new notification.

4. Add properties to that notification as required.

5. You can also add filters to select your target audience for the notification. Click on filtericon icon and add filters to the notification.

Choose the appropriate criteria and enter its value. This property and its value will be evaluated before sending a notification to a particular user. You can optionally mark it as a mandatory filter too which indicates that a particular criteria should be fulfilled for the notification to be sent.

Please note that the filter criterion shown in the drop down are the default user properties, which can be modified through the settings page.

6. For ‘STAY’ type of notification, there is an additional property, ‘Delay’ that can be set. It specifies how long to wait before sending the notification once the user has entered the place. Click the edit icon and set its value. The unit for this time attribute is seconds.

7. Similarly, for ‘NEARBY’ type of notification, there is an additional parameter, ’Distance’ that defines what can be the maximum distance of the user from the place when the notification is triggered. Its unit is meters.

 

 

Navigation

Navigation refers to the planned movement from source to destination, following a route. An edge represents a path on the map which can be used to navigate a user from one point to another. A route is a network of such edges traversed between source and destination. Navigation section of the Admin Panel allows you to define feasible paths inside a building which are required by the SDK while finding a suitable route for a user inside the building.

An edge can have any number of properties. These properties provide extra information about the edges. This information is used by the SDK to compute specific navigation routes for users based on their profiles and specific needs. For example, if the SDK is computing a path which is wheelchair_accessible, it will only look for edges where that property is true.

Please keep the following points in mind while creating your edges.

  • Orange dots mark the beginning and end of an edge.
  • Grey dots are used to create curved paths.
  • Crossroads can be created only from the orange dots.
  • Any intersection which is not over an orange dot is considered as a bridge and hence the application will not allow a left or right turn at that intersection.
Create an edge

  1. Go to the Navigation tab on the left.

2. Select the floor for which edges are to be added.

3. Click on ‘Add Path’.

4. Enter the details for the path to be created.

5. Select the property to be applied to the path from the drop down menu. The chosen properties will be listed below.

6. Choose a color to be shown for the path.

7. Select  icon if the path is a two way/ bidirectional path.

8. Click Create.

9. Click on the map from where this path is to begin. It will be indicated as an orange dot on the map.

10. Continue to place points on the map. All the dots will be shown in grey. Once the end point of the path is reached, press ‘Done’.

11. You can also add indicators to any edge. They are used to associate extra information to any edge. An indicator is an object with an image and a text. Each edge can have two indicators. These will be used whenever system has problem detecting your direction. For example, at crossroads, when the system knows your exact position but does not know the direction you are facing, it may be difficult to generate instructions like ‘turn left’ or ‘go straight’, in such cases these indicators can be shown to eliminate ambiguity.

12. The newly created path will be shown like this on the map .

13. To edit or delete an edge, click anywhere on the edge, the red line in the above example and click the edit or delete icons. 

14. Continue to mark all the feasible paths on the floor plan to create the whole navigation network.

15. Click ‘Save’ after making all the changes.

 
 
Add a Floor Changer 
 
When a building has more than one floor, add floor changers to indicate the possibility of movement from one floor to another. Floor changer can be escalators, elevators or stairs.
  1. Go to the Navigation tab on the left.

2. Click on ‘Add Floor Changer’ button. 

3. Select the type of floor changer to be added. 

4. Click on ‘Floor connections’ and choose the floors to be connected by this floor changer. 

5. Choose the direction of the floor changer. 

6. Click Create. 

7. Place the floor changer appropriately on the floor plan. 

8. Place the floor changer appropriately on the floor plan. 

 
Combined Indicator
 
Combined indicator refers to an indicator which is assigned to a group of edges and not a single edge. A combined indicator is also an object consisting of an image and a text. It is used whenever it is a simpler to explain the path through an indicator instead of using the instruction set for the route.For example, assume the navigation route consists of a big hall to be crossed with a series of turns and nodes. In such a case, it may be simpler to show “Reach the exit gate 5" along with the image of the referred gate or something similar, instead of giving multiple instructions to cross the hall. 
 
Please keep the following things in mind while creating a combined indicator:
  • Choose edges linked together in series. There can be only one main edge and other edges forming a path in continuity.
  • The edges chosen for combined indicator should not form a loop.
  • There should be no crossroads in the chosen edges.
 
Create a combined indicator:
  1. Click the first edge to be included for the combined indicator. It will be referred to as the ‘Primary edge’ and will be indicated in red color.

2. Click the remaining edges in continuation. Those will be referred to as ‘Secondary edges’ and will be shown in blue color. 

3. Click ‘Done’ button on top of the page when all the involved edges are selected. 

4. Add an indicator to the set of edges chosen.


To delete the combined indicator, click on ‘+’ icon of the indicator and click ‘Delete’. 
 
Please note that deleting any edge which is part of a combined indicator will delete the combined indicator automatically.
 
 
Settings

The application allows us to add custom predefined properties to places, edges, notifications and users. Once a predefined property for any of these objects is created, it will be automatically be associated to the newly created objects of that type. This not only saves time while creating newer objects but also makes them uniform across similar objects and thus reduces scope of error. For every new object created, only the value of the property will have to be set. For example, if we define a predefined property for an edge ‘wheelchair_accessible’, then for every new edge created, we will only have to specify if this property is true or false for that edge.

1. To make these settings, click on Settings icon shown on the map under ‘Places’ and ‘Navigation’ tabs. 

2. Following screen appears

3. Add appropriate settings for places, notifications, edges or users.

4. Provide iBeacon’ proximity UUID, if required. This attribute is required by the iOS devices to be able to hear the iBeacon devices. Android devices, on the other hand, can hear all the beacon devices without any limitations. 
Please note that the default value of this field is set to UUID of the beacons provided by us. Change this attribute if you are using your own beacons with a different UUID. 

5. Click ‘Save’ to store these properties on the server.

The properties associated with places, edges and notifications are used to save additional information about them. These properties can be used in different ways in the applications to offer customization of UI and tasks. For example, a property ‘alert_type’ could be associated with notifications to inform the application how to alert the user when that notification is generated.

The user properties, on the other hand, are used to create a set of properties (of type – number/ string/ fixed values) that can represent a user profile. These user profile properties are used by the notifications to set filter targets. When a notification is defined, any set of user profile properties can be used to choose the subset of people to which that particular notification should be sent.