Geographic reference helps users quickly identify locations that are relevant to the case. By clearly indicating the position of a place on a map, you provide users with a transparent interface that helps them read geographic data.

You can add geographic reference by using a Map control or a location field. Both solutions display maps that are sourced from Google Maps API, but collect data about locations of map markers from different sources:

• The Map control draws marker data from an associated property or data page. The control supports multiple use cases, including user tracking, capturing location data, or displaying multiple markers at once.
• The location field contains a text field where the user enters an address, and the field uses this information to set up a marker. From a technical point of view, a location field is an object in your case data model that consists of two properties: one to capture the display address text, and another to capture the longitude and latitude data.

For example, a booking application might include a Map control linked to a data page that lists all hotels in a given city. The data page and the control are separate, and the control draws marker information from the data page. However, a ride-sharing app might include a location field that consists of the map of a city and a text field. When the user enters the pickup address into the text field, the map displays a marker, and the address is saved as the field value.

• Configuring dynamic system settings for geographic reference

  Provide users with a clear map of geographical points that are relevant to the cases that they work on. By configuring dynamic system settings with the appropriate Google API key, you prepare an environment in which the Map control and the location field can work correctly.

• Tracking mobile users based on geolocation data

  Record the location of users of offline-enabled mobile apps who work on specific assignments by enabling constant tracking for case types. For example, enable tracking in tasks for service employees in the field so that dispatchers can effectively assign work to the employees based on their current location.

• Configuring the Map control

  Help your users locate relevant geographic points with less effort by using the Map control.

• Adding a location field

  Help your users indicate geographic points more conveniently by providing the option to type an address in a location field. For example, a ride-sharing application might use the location field to help users set a pickup point.