Skip to main content


Please do the following before getting started:

  • Disable the on-screen keyboard in the operating system of the computer the Kiosk app will run on
  • Disable the browser's position

Create Kiosk Locations in the CMS

Log in to the CMS and create a new Location Type. Give it a memorable name like e.g. "Kiosk".

Create all your physical Kiosks as Locations in the CMS, assigning them to the Location Type you just created.

Configure the Kiosk

To set up your Kiosk, you need to set a few parameters in the URL. The ? symbol has to be in front of the first parameter, and all other parameters are separated with an & symbol.

This is what the full URL for an app in Kiosk mode could look like:,availability,position

Splitting the URL, this is what it contains:

  • demo is the Alias for your Solution (you can use an API key in the same way if an Alias is not set). This is found in "Solution Details" -> "App Settings" -> "App Configuration" for the Alias, or "Solution Details" -> "App Settings" -> "API Keys" for API keys:
A screenshot of the page overview of AliasesA screenshot of the page overview of API Keys
  • originLocation=652cf26a26784b4e9a390d8b is the Location selected as "origin Location", i.e. where your Kiosk is located in the real world. This is a Location ID found in the "Location Details" panel, in the "Details" tab:
A screenshot of the page overview of the Kiosk
  • zoom=22 is the zoom level to start at
  • &timeout=20 is the timeout period (in seconds) before resetting the map view
  • &legend=true is whether the Legend should be displayed
  • &bearing=180 is how much the map should be rotated from North (in this case 180 degrees, so due South)
  • &pitch=60 is how much the map should tilt towards the horizon
  • &liveData=occupancy,availability,position is which Live Data Domains should be enabled on the Kiosk

All the parameters can be combined individually and differently for each Kiosk you set up.

The URL parameters are saved in the browser's local storage to persist across an app refresh, without the need for manually entering them again. They are all prefixed with MIKIOSK:param. The saved parameters are overwritten when new URL parameters are set, and can only be deleted by clearing the browser's local storage.

When testing the Kiosk, it is highly recommended to use Chrome's "Incognito" or Safari's "Private Browsing" feature to ensure the local storage is empty.

No URL Parameters

It is also possible to launch the kiosk without utilising URL parameters like those specified above, by using the link If the kiosk is launched in this manner, you will be asked to enter an API-key and a Location ID to use as an origin point, information on which can be found here. The kiosk will then launch based on these parameters.

A screenshot of the page overview of the Kiosk with no URL

Legend Fields

To update and present custom fields in the Legend, add Custom Properties to the Location set as originLocation.

The Custom Properties are grouped together by the index (number) defined in the key. You can add as many fields as you would like.


1LegendHeadingHeader text goes here
1LegendContentContent text goes here
2LegendHeadingHeader text goes here
2LegendContentContent text goes here

Google Analytics Tracking

Google Analytics is used for general analytics, page view and event tracking in the Kiosk app.

To collect statistics in Google Analytics, provide your MapsIndoors representative with a Google Analytics Property ID (tracking id).

You will receive stats and events in the Google Analytics Dashboard approximately 24 hours after the key has been set.

Page View Tracking

A page view event is sent for the following views:

  • Home
  • Search
  • Details

Event tracking

The following events is sent from the kiosk when triggered:

InitializationURL parameter configuredOrigin Location was setTrueWhen the origin location parameter is set
InitializationURL parameter configuredTimeout was setTrueWhen the timeout parameter is set
InitializationURL parameter configuredZoom parameter was setTrueWhen the zoom level parameter is set
InitializationURL parameter configuredBearing parameter was setTrueWhen the bearing parameter is set
InitializationURL parameter configuredPitch parameter was setTrueWhen the pitch parameter is set
InitializationURL parameter configuredLegend was setTrueWhen the legend params is set to true
InitializationURL parameter configuredLiveData parameter was set ([DOMAIN TYPES])TrueWhen live data parameter is set
HomeResetKiosk was resetTrueWhen the kiosk is dirty and has been idle for X amount of seconds
SearchLocation selectedLocation id: [LOCATION ID], Search query: [SEARCH QUERY]FalseWhen a location is selected in the list and a search query is entered
SearchLocation selectedLocation id: [LOCATION ID]FalseWhen a location is selected in the list
SearchCategory filter appliedSelected "[CATEGORY NAME]" CategoryFalseWhen a category is selected
DetailsQR CodeQR code generatedFalseWhen a QR code is successfully generated
DetailsSend SMSSMS successfully sentFalseWhen a SMS is successfully sent
DetailsSend SMSSMS failed to sendFalseWhen a SMS is unsuccessfully sent

Configuring Chrome to Run in Kiosk Mode

Starting Chrome in "kiosk mode" enforces fullscreen mode, removes the address bar, the close and minimise buttons as well as bookmarks. Starting the browser in "kiosk mode" requires the --kiosk parameter along with a target URL.

Here's how you would do it on a computer running Windows:

  1. Create a shortcut to chrome.exe located in the application folder

    C:\Program Files (x86)\Google\Chrome\Application
  2. Right-click on the shortcut and select "Properties"

  3. In the "Target" field add the --kiosk parameter to the path

  4. Now add the target URL, e.g.:

    "C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --kiosk ""

Now close all instances of Chrome, and start Chrome in kiosk mode using the shortcut.

For the SMS feature to work, MapsPeople needs to activate it.

The limit for sending an SMS to the same phone number is 3 messages per 10 minutes.

URL Parameters


The originLocation URL parameter is set with a Location's ID. This can be found in the CMS on the Location's details page.

The Kiosk will center the viewport on the originLocation when initialized and every time it resets, and all routes start originate at this Location.

The originLocation URL parameter is saved in the browser's local storage as MIKIOSK:{miApiKey}-paramOriginLocation.



The liveData URL parameter is used for enabling Live Data. The URL parameter accepts a comma-separated list of Live Data Domain types.

Available Domain types can be found here:

The liveData URL parameter is saved in the browser's local storage as MIKIOSK:{miApiKey}-paramLiveData.

Get in touch to hear more about how to set up Live Data integrations for your Solution.



The zoom level URL parameter is used for setting a default zoom level. It defaults to 21 if the parameter is not set. The configured zoom level is used when the kiosk is initialized and every time it resets to the initial view. The zoom range will have to be between 0 - 22.

The zoom level URL parameter is saved in the browser's local storage as MIKIOSK:{miApiKey}-paramZoom.



The timeout URL parameter is used to set a period after which the Kiosk will reset to its initial state if it has not been touched. The entered value is in seconds.

The timeout URL parameter is saved in the browser's local storage as MIKIOSK:{miApiKey}-paramTimeout.



By adding the legend URL parameter, the Legend card is displayed on top of the map. The Legend provides a list of Categories for which there are Locations in the Venue associated with the originLocation.

The legend URL parameter is saved in the browser's local storage as MIKIOSK:{miApiKey}-paramLegend.



By adding the bearing URL parameter, the angle (heading) of the map is controlled. With a range between 0 and 360 degrees, where 0° is north, the map is rotated around its center.

The bearing URL parameter is saved in the browser's local storage as “MIKIOSK:{miApiKey}-paramBearing”.



By adding the pitch URL parameter, the angle towards the horizon measured in degrees of the map is controlled, with a range between 0 and 60 degrees. Zero degrees results in a two-dimensional map, as if you're looking straight down on the ground.

The pitch URL parameter is saved in the browser's local storage as MIKIOSK:{miApiKey}-paramPitch.


Live Data Badges

When subscribing to Live Data (see URL parameters), badges will be applied to the icons for Locations that have Live Data.

  • Availability: Will add a green badge with a checkmark, or a red badge with a cross, depending on the availability of the Location.

  • Occupancy: Will add a black badge with a number depicting the occupancy of the location (nrOfPeople).