This section describes the configuration screen available in the Map Viewer Configuration Panel. This screen allows users to customize various visual, functional, and advanced aspects of the navigation experience, adapting it to different use cases.
Opening the Configuration Panel #
To do so, enter your Map Viewer URL (or try this one for testing purposes), and press CTRL+”,”. This will open a Settings menu like the following one:
Within this menu, you’ll find different sections, each section grouping options that share a common purpose (e.g. settings that modify the appearance are bundled together). You may click on each section/subsection to explore and find the options that you seek. Alternatively, you may use the search bar to type the name of the option you’re seeking.
Creating a Configuration Profile #
Within your account, you can have different Configuration Profiles. To do so, just click on th “Open profiles list” icon, and you’ll see a menu to handle your profiles. You’ll be able to create new ones, select old ones, save any of them, change their names, etc.
Modifying a Configuration Profile #
Modifying a configuration is very easy. Just navigate through the Configuration Panel, find your setting and change it. Don’t worry, your changes will be saved locally, you will not be actually changing your production map.
With most setting changes, the viewer will change instantly (e.g. when you change UI colours like in the following video). Other setting changes are more subtle: perhaps they just affect to corner cases, secondary screens, or maybe they control behaviour on certain use cases or circumstances.
Saving your Configuration Profile #
When you’re happy, you can click on the “Save current profile” button and your profile will be automatically published at https://maps.situm.com/YOUR_PROFILE.
Using your Configuration Profile in your app #
The last step would be to use the configured profile in your web or mobile app. Once your settings are uploaded to your account, they will be assigned a “profile ID” (called “remoteID” in our mobile SDKs, for now). This identifier is a string that uniquely identifies a settings configuration (you may have different configurations assigned to your account).
Web apps #
In a web app, you’ll be loading our Map Viewer either using an iFrame or an URL in the browser navigation bar. Either way, you’ll need to specify the remote identifier like this, where PROFILE_ID is your identifier (e.g. my_configuration_1234).
Please remember that you may use different query params as well.
Mobile apps #
In a mobile app, you’ll need to pass the profile ID as the remote identifier parameter to the Map Viewer component. Please take a look at this document to know how to do it.
Understanding the Map Viewer Customizable Settings #
Appearance #
Customizes the visual appearance of the Map Viewer. This configuration includes, among others:
- Color palettes for app buttons, routes, and POIs.
- Application language.
- Visibility of functional buttons.
- Map cartography layers displayed.
Behaviour #
Configures how users interact with the map and how the navigation functions behave. Available options include:
- Map interactivity: Minimum and maximum zoom levels, panning control, auto-centering, and data refresh intervals.
- Routing parameters: Default route type (shortest or accessible), route instructions, and warnings.
- Navigation settings: Distances to trigger destination announcements, update guidance, and recalculate routes.
- Search behavior: Configuration of POI search bar behavior.
- Sharing: Ability to copy and share the current Map Viewer URL.
- Triggers: Actions that are automatically triggered under certain conditions (e.g., proximity-based announcements).
Developer Settings #
Advanced configuration options designed for technical users and integrators. Includes:
- Activation of features such as: Find My Car, favorite POIs, Augmented Reality (AR), and ticket selection.
- Configuration of positioning behavior.
- Visualization settings for elements like POIs, paths, 3D models, etc.
- Definition of offline mode content: what elements are cached for use without connectivity.
- Performance mode selection based on device capabilities or use case requirements.
Some features are intended for development or testing environments and should not be enabled without proper validation.
About #
This is an advanced settings section. It displays current Map Viewer state information:
- Establish current values as permanent
- Current map location.
- Account details.
- Other relevant diagnostic data.
