Updated: June 3, 2021



The map component is designed to display different business objects in the context of where it they are located as well as give a visual indication of what type the object is (point, polyline or polygon). It can also be used to show points of interest, optimized routing based on business criteria, and other quantitative location-based data.

Map features allow users to:

  • Quickly access geospatial and business data from the field.
  • Search for business objects.
  • See an overview of business objects and their locations.
  • Quickly access previews of business objects.
  • Get directions to business objects from their current location.
  • Show and hide different map view and feature layers.


A. Map Search

Search is an optional feature that can be included in the map view.

There are two types of search panels: one with a list of business objects displayed, and one with only the search bar. When using the Search panel with the list, the items should be presented as object cells, and the list can be filtered. Please refer to the object cell and filter guidelines for more details.

B. Toolbar

The toolbar appears at the top-right corner of the map. It contains buttons for performing actions relevant to the current view or the content within it. There are five default actions available to use in the toolbar and you may include up to six actions.

The five default actions are:

  • Map Settings: Map settings appears as a modal window when the user taps on the information icon.The content that appears within the settings modal depends on each app’s specific needs. Some examples for settings are Map View Options, Feature Layers Options, Near Me Radius and Map Unit Measure.
  • Current Position: Current position displays the user’s real-time location when s/he taps the button while the device’s GPS setting is turned on. The user’s current location is highlighted on the map. There are two states of the current position icon: on and off.
  • Show/Hide Panels: Tapping this button will move all panels (including the search box) off the screen. Tapping the button again will return the panels to their previous positions.
  • Map legend: This provides detailed information on the symbols and visual elements that appear on the map view.
  • Zoom Extents: This resets the map zoom to a level where all currently-available markers appear on screen at once.

C. Map Markers

Map markers typically represent either single or multiple business objects on a map. They can be represented by points, polylines, or polygons. Each marker type has a default and selected state.

  • Points are used to represent one or more business objects at a specific location. Point markers can be shown with icons, images, numbers, and letters to give additional information about the business object.
  • Polylines can represent linear assets, such as pipelines or water-distribution networks.
  • Polygons are used to represent areas, such as functional locations or regional boundaries.





Objects that are close together will cluster together or apart depending on the zoom level of the map. As the user zooms out, markers will merge into a single marker with a number count displaying how many objects are located with in the cluster. As the user zooms in, the marker will break apart into the individual objects. Objects that share one single geometry (location) will be displayed as a single marker with the number count. If objects in a cluster are different types, the marker should be set to a neutral color. If objects in a cluster are all the same type, then the marker should reflect the color set for that specific object type.

Users can select a cluster marker by tapping it and a list panel showing each object within the cluster should be displayed. Selecting one of the objects from the list will open the detail panel for that object.

D. Detail Panel

When a user selects a map marker, either a point, polyline or polygon, a detail panel will slide in from the left to reveal additional information.

This panel will display information about the selected business object, and can contain general details, navigation direction information, analytics, quick actions, etc. As the panel is constructed in a modularized fashion, the specific combination of content types will vary across applications.

Examples of different content types to include are:

  • Title: This section should always be at the top of the panel. Include the object’s name with an optional subtitle. Use tint color for the title when it’s possible to drill down further to see more details about the object.
  • Additional Information: Use this section to display additional information about the object. Short string of text, status icons and system-generated tags may be used.
  • Directions Button: A directions button with or with our the address may be used.
  • Actions Cell: Use this section to display quick actions related to the object.

Behavior & Interaction

From the map view, edit mode can be initiated two ways depending on if you are creating a new object or editing an existing object. The transition to edit mode will happen in place and preserve any filters and/or settings that have been set. 


Edit Existing Object

When editing an existing object, edit mode will be triggered from the action cell in the detail panel of the selected object. In edit mode, the selected object (point, polyline or polygon) will be displayed and can be edited as needed. Once the object’s new geometry is saved, the user will return to the previous map view.

Edit: Create New Object

When creating a new object, the edit mode is initiated from the ‘Add’ icon in the navigation bar. The user will be able to choose from a list what type of object they want to create. Point, polyline and polygon are supported. The transition to edit mode will happen in place and preserve any filters and/or settings that have been set.

Once in edit mode, the user can tap on the locations where they want a point, or series of points, to be placed. Point locations can be changed with a tap and drag gesture, or via the address fields in the edit panel. After the object is created and saved, the user will return to the map view from where they started.

Map Routes

Routes are path indicators that contain multiple stop sites in the map.


In their default state, routes display a call-out tag and stop sites. A route and its call-out tag is actionable for the user to select. Selecting a single route display the route’s stop sites’ as map markers. Each route’s information will also appear in the detail panel as an object list.
A route can be selected either by tapping on the route itself, or by selecting the corresponding object in the detail panel. The remaining unselected routes will change to a muted view on the map, while the selected route will be displayed with labeled map markers indicating how many items are associated with each stop.
When a route is selected, the detail panel for the route will slide in over the first panel. The new panel should show an object list with each stop on the route. The titles of the objects should match the names of each stop displayed on the route. From here, users can select one of the stops by tapping on one of the objects in the list, or by tapping a marker on the map. A new detail panel will slide in with the information for the selected stop.

Once you have drilled down into a stop on the route, you can drill into one specific object from the list. Here, selecting a single object will trigger the map to zoom-in so that you are able to see the exact location.

For example, in the image to the right, choosing the object “Lease Well 113” from the list will trigger the map to zoom into the location while having the object’s detail panel slide in with all the information associated with the selected object.


The map component is supported for both compact and regular widths, but some of the features will be displayed differently. At this time, edit mode is only available in regular width.

Example 1 – Map settings in compact is a full screen modal. In regular, settings is a modal window.

Example 2 – Map legend in compact is displayed at the bottom of the screen. When in landscape mode, the legend is anchored in the top left of the screen. In regular view, it always appears as a pop-over anchored to the floating toolbar.

Example 3 – The detail panel in compact slides up from the bottom of the screen. In regular, the detail panel slides in from the left and floats along the left side of the screen.