actions

A set of strings describing recommended actions based on this notification. Optionally, use these strings to determine whether your app will perform custom behavior, such as showing messages or starting/stopping tracking. Note that there is no requirement to take any action when a notification is delivered, but these provide a way to understand the intention of the author of the Geotrigger. This property can be empty.

These actions are the result of evaluating the Geotrigger.messageExpression for the specific objects that triggered this notification. If the expression returns a dictionary containing a list of strings with the key "actions", they are shown in this property.

For example, if the Geotrigger.messageExpression evaluates to a dictionary of GeotriggerNotificationInfo.messageProperties containing the following key value pairs:

  • "message" with the string "Hello world"

  • "actions" with a list of action strings "startTracking"

... then this property returns a list containing "startTracking". The list of actions are simple strings, so you can use them to control any custom action for your app.

The author of a Geotrigger can supply a set of all the possible Geotrigger.requestedActions when defining the Geotrigger. This property returns a list of strings indicating the actions that should be taken by your app, based on this GeotriggerNotificationInfo.

Since

200.1.0