Situm Map Viewer offers a wide set of query parameters that can be used to adapt it to any needs. As an example, you may use an URL like:
https://map-viewer.situm.com/?lng=es&navigation_from=100593&navigation_to=92993&buildingid=7033&floorid=14468
The following table summarizes the most important query params:
| Query param | Description | Dynamic / Static |
|---|---|---|
| Current user email | Static | |
| apikey | Current user API KEY. Use this endpoint or this Dashboard panel to get your api keys. | Static |
| buildingid | Indicates the selected building identifier. Use this endpoint to get your buildings ids. | Dynamic* |
| floorid | Indicates the selected floor identifier. Use this endpoint to get your floors ids. | Dynamic |
| poiid | Indicates the selected POI identifier. Use this endpoint to get your POIs ids. | Dynamic |
| navigation_to | Indicates the destiny POI identifier in a route. | Dynamic |
| navigation_from | Indicates the origin POI identifier in a route. | Dynamic |
| lng | Sets the language of the UI. Supported values: en (English), es (Spanish), fr (French), pt (Portuguese), it (Italian), tr (Turkish), ar (Arabic) and he (Hebrew). If not provided, the browser locale will be used if available (fallback language is English). | Static |
| rtl | Receives a boolean that when it’s true make texts and layout elements adapt to right to left languages. If not specified, it is false by default. | Static |
*While using the Map Viewer, some query params will be dynamically updated based on the actions performed by the user: this way, you may share the current state just by sharing the URL.
Email & apikey #
These two parameters are used together: they allow you to use your account and access to your organization’s available buildings.
https://map-viewer.situm.com/?email=<your_email_here>&apikey=<your_api_key_here>
buildingid & floorid #
These two parameters are used together: they trigger the display of the map in the specified floor that belongs to the specified building.
https://map-viewer.situm.com/?buildingid=7033&floorid=14467
poiid #
This parameter centers the view on the specified POI and shows the available information at the superior left corner. It usually goes with buildingid and floorid, which will autocomplete if missing.
https://map-viewer.situm.com/?poiid=47204
navigation_to #
Situm Map Viewer allows you to ask for a route to different places: the destination POI is specified on the navigation_to query param. This parameter is always recommended to be used in combination with poiid.
https://map-viewer.situm.com/?buildingid=7033&floorid=14467&navigation_to=47204
navigation_from #
When the destination is selected, only the origin is missing to finish the route calculation. To do this we have navigation_from, which specifies the POI where you are expected to be and you are starting to walk towards the destination.
https://map-viewer.situm.com/?navigation_from=47196&buildingid=7033&floorid=14467
lng #
Use lng query param to force the User Interface to be on a specific locale language
https://map-viewer.situm.com/?lng=es&poiid=47196&navigation_from=47196&navigation_to=47204&buildingid=7033&floorid=14467
rtl #
When it is true, the map Viewer will mirror the elements of the interface to adapt the UI to right to left languages. It is commonly used with lng=ar or lng=he.
https://map-viewer.situm.com/?rtl=true&buildingid=7033&floorid=14467
