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.
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.
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:
- 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.
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
- 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.
- 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.
- Click the delete icon in front of the floor name in the floor list.
- Click ‘Ok’ on the confirmation page.
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
- 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.
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
- 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 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.
- 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.
- 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.
- 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.
- 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’.
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.