The Map component is designed to display the location of business objects and give a visual indication of the object type (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.
Example of the Map view on iPhone (left) and iPad (right)
- 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.
Search panel on the Map view
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 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 displays the user’s real-time location when if 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: moves all panels (including the Search box) off the screen. Tapping the button again will return the panels to their previous positions.
- Map Legend: provides detailed information about the symbols and visual elements that appear on the Map view.
- Zoom Extents: resets the map zoom to a level where all available markers appear on screen at once.
Map toolbar that displays the Map Legend
C. Map Markers
Map markers indicate 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 a 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.
Example of markers on Map view
Interacting with a map marker (using the design from SDK 6.1)
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 show 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 texts, status icons and system-generated tags may be used.
- Directions Button: A directions button with or without the address may be used.
- Actions Cell: Use this section to display quick actions related to the object.
Example of a Detail panel in a Map view
From the Map view, the 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, the 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.
Creating a new map marker (using the design from SDK 6.1)
Routes are path indicators that contain multiple stop sites in the map.
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.
Interacting with a map route (using the design from SDK 6.1)
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.
Adaptivity of the Map Settings screen
Example 2 – In compact view, the Map Legend 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.
Map views when the Map Legend is opened
Example 3 – In compact View, the Detail panel 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.