Skip to content

Smart Location Setup

Your Kio Cloud Smart Location represents your organization’s physical locations - from your campuses and their buildings to the building floors and spaces. Setting up your Smart Location is required to begin your journey with the Kio Cloud location services.

The following sections explain how to set up your Smart Location.

Setup overview

First, you’ll create a campus and its buildings. Next, you’ll add the buildings' floors and define their spaces (rooms and corridors). You will need to upload a floor plan image for each building floor. The final step is to place the install location of your Kontakt.io Portal Beams and gateway devices (Kontakt.io Portal Lights or access points) into your spaces.

Important

Before you begin, make sure your Kontakt.io devices have been added to your account. See Add Devices.

Add Campus & Buildings

This section explains how to add a campus and its buildings.

Many organizations are different - you may have just one or many campuses. Commonly a campus is a single geographic location with one or multiple buildings. For example, you may have campuses located in different cities, then create a campus for each geographic location. Or maybe you have multiple campuses that are unique to their business services, you may then choose to have a campus for each business service location.

Step 1: Add a campus

A campus represents a collection of buildings. If you have more than one campus, complete this step for each campus.

From your Kio Cloud Launchpad, click Smart Location > from the upper-right corner, click ADD CAMPUS > enter the following campus information.

  • Address - where the campus is located
  • Name - unique name of the campus
  • Description - for information purposes only
  • Optionally upload an image file of the campus (click + to select a file). This image is displayed on your campus list.
Example: add a campus

Step 2: Add buildings

Buildings are located within a campus. You may have one or multiple buildings in a single campus. Complete this step for each building.

From the upper-right corner, click ADD BUILDING > enter the following building information.

  • Address - where the building is located (by default set to the campus address)
  • Name - unique name of the building
  • Description - for information purposes only
  • Optionally upload an image file of the building (click + to add file)

After your buildings are added, you are now ready to configure the building floors.

`
Example: add a building

Configure Building Floors

This section explains how to configure the floor of a building. Complete the following steps for each of your buildings.

Important

You will need a floor plan image file (sometimes called an indoor map) for each building floor.

Step 1: Add a floor

A building may have one or many floors. Be sure to repeat this step for each floor.

From the upper-right corner, click ADD FLOOR > enter the following floor information.

  • Level - what building level the floor is located on
  • Name - unique name of the floor
  • Floor Plan – upload the file (select +)
Example: add a floor

Step 2: Scale floor plan

You’ll now set the one-time Reference Point and Floor Outline. This ensures the floor plan is scaled correctly to visually display your Kontakt.io devices.

Important

These settings cannot be changed once they are saved.

Set the Reference Points: go to the Floor list > select the Floor name > click EDIT > click SET POINTS > set POINT A by clicking on the first reference point on the floor plan (purple X appears) > set POINT B by clicking on the second reference point > enter the distance between the two reference points > click NEXT.

Example: set one-time reference points

Set the Floor Outline: select DRAW FLOOR OUTLINE > select either the rectangle or polygon tool > hold down your mouse pointer over the start point and release - then drag the points to outline the floor plan (green line appears around the floor outline) > click SAVE AND CONTINUE.

Example: set floor outline

Step 3: Define spaces & place Portal Beams

During this step, you’ll define the floor’s spaces (room and corridors) and place each Portal Beam into a space to identify its exact install location.

To add a space select either of the drawing tools > draw the perimeter of the space > enter the following space information.

  • Name - identifies the room or corridor
  • Room ID - important unique ID that’s linked to the space and its installed Portal Beams. It’s recommended to allow the system to generate the Room ID in sequence as you add spaces.
  • Place the Portal Beam installed in the space - click Add Portal Beam > select the Portal Beam MAC address > from the floor plan map, place it at its exact install location > click SAVE.

If a space has multiple Portal Beams, be sure to add each of them.

Continue to draw a space for each room and corridor within the floor.

Example: defined space with Portal Beam

Step 4: Place Gateway (Portal Light or access point)

During this step, you’ll place the Gateways installed on the floor. A floor may have one or multiple gateways.

Select the Gateways tab > click ADD GATEWAY > select the Gateway > from the floor plan, place it at its exact install location > select SAVE.

If the floor has multiple gateways, be sure to place each of them.

Example: place a Portal Light

Step 5: Confirm floor configuration

When you’re done configuring the floor, from the upper-right corner click FINISH CONFIGURATION.

It may take some time for the Kio Cloud location services to display all location information.

Note

When you add a new Kontakt.io device or move a device to another space, be sure to place it at its install location. See Place Portal Light location or Place Portal Beam location