3. Kiosk - Setup Points of Interest (POI) Buttons
- Robert Cox
About
Points of Interest (POIs) help users quickly locate important locations on your Kiosk, such as restrooms, elevators, or specific rooms. This section explains how to add, categorise, and manage POIs, making it easy for users to find key destinations.
Page Contents
Steps to Set Up Points of Interest (POI)
1. Open the Kiosk Editor
In the Kiosk Manager, find the Kiosk you want to configure and click EDIT. This opens the Kiosk Editor, where you can customise the Kiosk’s interface and display options.
2. Add a POI Button
This adds a button for a specific, individual location, making it easily accessible in the Kiosk’s quick search menu.
Steps:
a. Click Add a POI button.
b. In the map preview, click on the POI (e.g., room, restroom) you want to add.
c. The Kiosk preview will reload, with the new POI button added.
3. Add a POI Category Button
Add a POI Category Button allows to add a button that will show all of the Point Of Interest type (e.g., all restrooms or elevators) on a map.
Steps:
a. Click Add a POI Category button.
b. From the dropdown, select the POI type (e.g., restroom, elevator).
c. Additionally, you can choose a specific building to limit showing the Points of Interests to a specific building.
If you leave the “Select Optional Building” blank, results will be shown based on the distance from the Kiosk.
d. Click Add poi category. The new button will appear in the Kiosk quick search menu.
e. The Kiosk preview will reload, with the new POI type added.
4. Add a “Nearest POI of Type” Button
This button directs users to the closest POI of a selected type, such as the nearest restroom.
Steps:
a. Click Add a “Nearest POI of type” button.
b. Select the POI type you want (e.g., nearest restroom).
c. A button will appear in the Kiosk menu that shows the closest location for that type when clicked.
5. Customise POI Names in JSON (Advanced)
Rename POIs for clarity or branding by editing the JSON data.
Steps:
a. Open the Raw JSON tab at the top of the Kiosk Editor.
b. Find the POI you want to rename in the JSON structure.
c. Change the text attribute to your preferred name (e.g., rename “Room 101” to “Conference Room”).
d. Click Save to apply the changes.
e. The Kiosk preview will reload with the changes applied.
6. Delete a POI Button in JSON (Advanced)
Remove unwanted POI buttons via the JSON editor.
Steps:
a. In the Raw JSON tab, find the code block for the POI button you want to delete.
b. Delete the entire block of code for that POI button, ensuring that any trailing commas are removed if it's the last item in a list.
c. Click Save to apply the changes.
d. The Kiosk preview will reload with the changes applied.
7. Reorder POI Buttons in JSON (Advanced)
Rearrange POI buttons in the Kiosk menu by adjusting their order in the JSON.
Steps:
a. In the Raw JSON tab, locate the POI you want to move.
b. Cut the entire code block and paste it into your desired position in the list.
c. Save your changes to update the order of POI buttons.
d. The Kiosk preview will reload with the changes applied.
Next Steps
After setting up POIs, proceed to 4. Kiosk - Advanced Editing of JSON File. for additional customisation options.
Troubleshooting Tips
Check the Editor: MazeMap validate the JSON and provide an error on the line when found.
Use JSON Validators: Validate your JSON with tools like JSONLint to avoid syntax errors.
Check for Missing Commas or Brackets: Common issues include missing or extra commas, especially after deleting or rearranging elements.
Hard Reload the Preview: If changes aren’t showing up in the Kiosk preview, click Hard reload Kiosk Preview to refresh the interface.
BaseMap not showing: Make sure that you are using the correct MapBox Style URL and ensure it is set to public.