Map control properties

After you add a Map control (the pyTrackingMap rule) to a cell, you can configure settings that control the appearance, function, and behavior of the control.

Map rendering section

The Map Rendering properties control the initial appearance of the Map control.
Option Description
Custom initial scale Specifies the initial map scale. Select the check box to set the integer value of the initial scale. The larger the number, the greater the magnification.
Custom initial lat / long Sets the initial location when the control is first displayed and there is no marker or user track data to display. Select the check box to set the coordinates.
Update frequency Specifies how often the map is refreshed to show user locations. Select Custom to set the refresh interval in seconds.
Visibility Sets the conditions for whether the map is displayed based on user input.
 

Markers section

The Markers section controls how to display markers such as office locations.
Option Description
Enable markers Specifies whether markers are displayed on a map.
Type The data source type used to display points on the map, either a property or a data page:
Property
The Map control displays a single location.
Note: Using this setting disables other functionalities of the Map control.
Data page
The Map control displays a list of locations, along with labels.
Address property The value of the property at run time. Enter either a hardcoded static value or use a property reference:
  • To manually enter the address, enter the coordinates within double quotation marks, for example:

    “42.366200, -71.076936”

  • To use a property reference, enter a value similar to the following:

    .OfficeLocation, SomePage.HomeAddress, EmployeeList.pxResults(1).Location

Drag marker position to update address value Determines whether the address is updated when the user drags the marker. If selected, the values bound to the Address property and Lat / long logging property fields are automatically updated to the new position.
Data page Specifies the data page that contains a list of locations to be displayed.
Location property Specifies the property that contains location address or coordinates.
Info section Specifies the property that contains captions to be displayed as hover text for the markers.

Users section

The Users section controls how to display user locations, user tracks, and locations assigned to users, for example job locations.
Option Description
Enable users filter Specifies whether user locations should are displayed on a map.
Data page Defaults to a data page that contains a list of users to be displayed.
Info section Specifies the property that contains hover text for users.
Option Description
Enable tracks Decides whether user tracks should be displayed on a map.
Data page Defaults to a data page that contains users tracks that have been recorded on mobile devices and synchronized with the Pega Platform.
Option Description
Enable user markers Decides whether markers that represent case-related destinations, for example job locations, should display on a map.
Data page Specifies the data page that contains a list of locations to be displayed.
Note: To display markers that correspond to locations that are relevant to a case, define a data page that returns a list of locations. The location property can contain a pair of coordinates or an address.
Info section Specifies the property that contains the hover text for the markers.