Geotrigger Notification

Since version: 1.14

With the Geotrigger Notification profile, expressions control the information reported when a Geotrigger condition is met. For example, you can write an expression to customize a message displayed to a user when they enter a particular area of interest. Note that this profile does not check the condition itself - it simply reports that the event occurred.

This profile is used for configuring Geotrigger conditions in ArcGIS Maps SDKs for Native Apps. Whenever Runtime detects that a Geotrigger condition has been met, the notification rule is evaluated. The expression's return value can contain a custom message which uses attributes and geometry of the user's device location and the area or fence that they entered or exited.

Context

The following products implement this profile:

Spatial reference

The spatial reference of the map in which the expression executes determines the execution context's spatial reference.

Time zone

The time zone of the map in which the expression executes determines the execution context's default time zone.

Profile variables

Variable NameTypeDescription
$feedfeatureFeatureThe input feature (e.g. a device location or a feature) which caused the Geotrigger to be activated.
$fencefeatureFeatureThe fence feature (e.g. an area of interest) which was entered or exited and caused the Geotrigger to be activated.
$fencenotificationtypeTextA description of the event that occurred - either "entered" or "exited".

Note that, when the $feedfeature represents a device location, it includes position and metadata of the device - usually obtained from GPS. The feature has a Geometry (usually a point) and a fixed schema with the following properties:

PropertyTypeDescription
courseNumberThe course of the location in degrees clockwise, 0 being true North.
horizontalaccuracyNumberThe horizontal accuracy of the location in meters.

Function bundles

Core | Geometry

Return types

Text | Dictionary

If the return type is Text this will be used as the notification message. You can use the Dictionary return type to include further details for your specific workflow but you should include the key message in order to populate the notification message.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.