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 register an account here.

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.

5. You can edit or delete the building by opening the drop-down menu and clicking the edit  and delete icons respectively, shown in front of the building name.

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.

Settings

The settings tab allows user to set the languages, categories and shortcuts. These properties will then be available throughout the application. Click on the settings icon on the right pane in the application.

Following screen appears, where the user can enter the categories, shortcuts and languages

Languages: Languages to be supported in the application.

Default Language: Default language to be used.

Shortcuts: The list of shortcuts to be created with which the POIs will be associated. These will also be shown as menu items on home page of the application. For example, parking areas, toilets etc

Categories: The list of categories to be created with which the POIs will be associated. This helps categorize various POIs in the building and allows easy searching for the user.

Click Save after making all the changes.

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.

Shortcut: This field tells the shortcut to which the POI belongs. For example, there may be multiple parking areas in a building. So, each parking area can be assigned to category “parking_areas”. This helps applications to search easily and help users find the optimum paths for the users. Plug&Play framework shows all the shortcuts as menu items in the applications for ease of use.

Category: The category to which the POI belongs. A category is also used to divide POIs based on their usage. For example, there may be multiple labs in a school like physics lab, biology lab, computer lab etc. All of these may be assigned a category “lab”. Now when the application will ask for all POIs with category “lab”, the application will list all the POIs like physics lab, biology lab etc.

The difference between categories and shortcuts is that in case of shortcuts since the use of all the POIs are same, the application will automatically choose the nearest one and guide the user towards it. Whereas in case of category, the application will show the list of POIs belonging to the category and allow the user to choose a specific POI. With reference to the examples discussed above, if the user chooses the shortcut “parking_area”, the application will show the path to the closest parking area to the user. However, if the user requests for POIs with category “lab”, the whole list (physics lab, computer lab, biology lab) will be shown to the user. The user can then choose one to see its navigation route.

Please note that for the current release all the POIs should be associated with some category or shortcut. Otherwise, they will not be searchable.

Pictures: Upload any pictures to be associated with the POI.

Videos: Link for videos to be associated with the POI. As a limitation in the current release, the length of the link cannot be more than 50 characters. In order to add a Youtube link, the initial domain name is not required. For example, if the url for the video is https://www.youtube.com/watch?v=DfI1-ZMd800, use only DfI1-ZMd800.

Text: Any text to be shown when the user clicks the POI. Note that the text, if any, associated with a POI should be textile formatted.

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.

Title: identifier for the notification

Pictures: any pictures to be associated with the notification

Videos: links for videos to be associated with the notification. Please note that for this release, there is a limitation on the length of the url for the videos. It cannot be more than 50 characters long.

Go there: If checked, a Go there button will appear in the UI when the notification triggers. This button when clicked will navigate the user to the POI.

5. 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 in the following screen

5. Select if the path to be created is wheelchair accessible

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.

Above is a sample indicator used when the system has to indicate the path to be taken but is not sure whether to indicate it as ‘slight left’ or ‘straight’ with respect to the direction user is facing. 

Indicators can be added to any edge through the ‘Orientation From’ and ‘Orientation To’ inputs while creating the edge. Enter the associated text in the textbox and click ‘+’ to upload associated image. 

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.

Beacons

This section shows the list of beacons installed on each floor.

Beacon Proximity UUID – This field is required for iOS devices. Android devices can hear to all iBeacons without any limitation. However in iOS it is required to know the iBeacon Proximity UUID to be able to listen them in the device. A default value of UUID is assigned to all the beacons provided by GoIndoor to the clients but in case the user has beacons with another UUID, then it will be required to add the UUID here.

Click on any beacon to get its details or change its state.

Various states that the beacon can have are listed below. These states are used for reference by the admin.

OK – when the beacon is working properly

No Battery – when there is no working battery in the beacon.

Needs maintenance –when the beacon requires some maintenance.

Out of order – when the beacon is not working as expected.

Lost – when the beacon cannot be identified/ found.

Low battery – when the battery of the beacon is low.