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 Name | Type | Description |
---|---|---|
$feedfeature | Feature | The input feature (e.g. a device location or a feature) which caused the Geotrigger to be activated. |
$fencefeature | Feature | The fence feature (e.g. an area of interest) which was entered or exited and caused the Geotrigger to be activated. |
$fencenotificationtype | Text | A 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:
Property | Type | Description |
---|---|---|
course | Number | The course of the location in degrees clockwise, 0 being true North. |
horizontalaccuracy | Number | The horizontal accuracy of the location in meters. |
Function bundles
Return types
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.