Map Details
Map Core
When adding a new configuration profile, a Profile Name is required. Optionally, you can choose to inherit from an existing configuration profile. This will copy all variables from the parent profile while allowing you to override any of the inherited settings at any time.
The ID on the right is used when adding a map control. You can assign one or multiple map controls to use this as a configuration profile.
Provider Options
The Address Provider is required if you want to enable address search functionality. This list is populated based on the providers configured in the Provider Manager that support address search.
The Region Provider is required if you want to enable region search functionality. This list is populated based on the providers configured in the Provider Manager that support address search.
Calculation Engine Options
The Calculation Engine defines how the map control handles geographic calculations. Choose from these options:
| Engine Option | Description | Best For |
|---|---|---|
| Simple (Mercator) | Performs basic spatial calculations using the Web Mercator projection. Distances and areas are estimated on the 2D projected plane, introducing distortion at larger scales or high latitudes. | Fast, lightweight calculations — such as general mapping use cases. |
| GeoJSON.io (WGS84) | Uses the GeoJSON method for computing area based on WGS84 spherical geometry. Assumes Earth is a sphere. | Working with GeoJSON-based data or when needing consistency with common open-source GIS tools. |
| Spherical (WGS84) | Applies Haversine formula–based calculations on a WGS84 sphere, offering improved precision over planar methods. Appropriate for larger shapes or long-distance calculations. | More accurate geographic area and distance measurements without requiring complex geodetic libraries. |
| Custom JavaScript | Enables custom implementation of calculation logic using JavaScript. Supports integrating third-party spatial libraries or bespoke algorithms. | Advanced use cases needing specialized spatial analysis or high-precision requirements. |
For more detailed information on each engine, see Calculation Engine.
Base map Providers and defaults
The Base Map Provider is required if you want to enable base map functionality. This list is populated based on the providers configured in the Provider Manager that support base map. Here, you can enable one or more base map providers, making them available to the user and allowing them to switch between them. Once at least one provider is selected under Base Map Providers, the default options will be populated. Be sure to select a default provider to load when the map initializes.
Map Type
Map Type is a dropdown option with choices of either "Globe" or "Flat." Selecting this determines whether the map control uses a 3D globe or a 2D flat map structure
Data Tab Position
The Data Tab Position setting allows administrators to configure how the data tab is displayed to users. There are three positioning options available:
| Position | Description |
|---|---|
| Overlay Bottom | The data tab appears as an overlay at the bottom of the map |
| Dock Left | The data tab is docked to the left side of the map interface |
| Dock Right | The data tab is docked to the right side of the map interface |
Visual Examples
Overlay Bottom
Dock Left
Dock Right
Map View Limits
The Map View Limits configuration enables administrators to define the initial view limits for when the map loads, including specifying the default geographic location, setting the initial zoom level, and applying constraints to the map's navigable area. Additionally, administrators can configure minimum and maximum zoom levels to control the range of zooming available to users, ensuring an optimized and consistent user experience.
Below is a table of the expected inputs for the default view
| Field | Description |
|---|---|
| Default Location | [Latitude],[Longitude] . |
| Default Zoom | number 1-24 |
| Constraint to Region | Enter map bounds as [minLat],[minLng],[maxLat],[maxLng] (e.g. -32, 115, -31, 116) |
| Min and Max Zoom | this is zoom constraint and expects number 1-24 |
Above these controls, you’ll find an interactive map that helps you set these fields. Each action includes a "Set" button, which automatically captures the relevant information from the map and fills in the fields for you. For example, clicking Set Default View will use the current viewport of the above map to set the zoom level and the center point (latitude and longitude) based on your current map position.
