Introduction #
Our Map Widget allows you to show indoor maps of your buildings on your website or digital kiosk! It is a fully interactive web widget that will allow you to:
- Show the indoor cartography of the buildings you’ve created in Situm Dashboard: floorplans, Points of Interest, etc.
- Search and locate Points of interest, showing them in a list or filtering them by name.
- Get route indications from different points of a building
- Share maps via QR
The viewer can be integrated in different ways:
- Use with URL. This will allow you to just open the Map Viewer into a browser without the need to do any integration, as you’d do with any other app. This is especially useful for kiosks whose only purpose is to show the Map Viewer. Installing an MDM in Kiosk mode is recommended so the viewer is always shown in full screen mode and users can not tamper with it.
- Use with iframe. This will allow you to integrate the Map Viewer into any web app or mobile app. You may show this application in your webpage, mobile app, kiosk, etc.
Use with URL #
The easiest way to open your Map Viewer is to copy & paste your Map Viewer URL and the Map Viewer will be shown as a regular web page.
There are 2 usage options:
- With API Key. You may create any read-only API Key in your account through Situm Dashboard. This way, the viewer will show the first venue in your account, and allow you to select other venues you may have. You may also retrieve this iframe from the “Map Viewer” section in our Dashboard.
- With Remote ID. Alternatively, you may input here the remote identifier that identifies the settings configured in your account. Through our Settings Panel, you’ll be able to have a great UX flexibility, such as configuring the venues to be shown, look & feel, etc.
Your URL will look like this:
https://map-viewer.situm.com?apikey=YOUR_API_KEY
https://map-viewer.situm.com/id/YOUR_REMOTE_ID
Use with iframe #
This Map Viewer widget can be easily integrated in your web app using the html tag <iframe/>. This will allow you to run the viewer into any It will be needed an apikey and several of the features can be managed from the url given on the src attribute of the iframe.
In order to show this widget, just copy & paste this code into your website’s code:
<iframe id="map-viewer-iframe" style="width:100%; height:600px" src="https://map-viewer.situm.com?apikey=YOUR_API_KEY"> </iframe>
<iframe id="map-viewer-iframe" style="width:100%; height:600px" src="https://map-viewer.situm.com/id/YOUR_REMOTE_ID"> </iframe>
Result #
The result will be something like this:
To know more about other integration query params or features you can check Map Viewer specifications.
