LocationGeotriggerFeed QML Type
|Import Statement:||import Esri.ArcGISRuntime|
The GeotriggerFeed is the dynamic component of a Geotrigger. Typically, it is the data that moves around and triggers the condition. For example, if the condition is "notify me when my position comes within 50 meters of one of my target areas", the feed data is "my position".
To receive location updates, the underlying location data source must be started. If you call GeotriggerMonitor::stop, the underlying AbstractLocationDataSource is not stopped for you. In other words, it may continue to receive GPS readings.
If the LocationGeotriggerFeed is from a Geotrigger defined in a GeotriggersInfo, you must supply a AbstractLocationDataSource to provide the device location. Set the locationDataSource to your AbstractLocationDataSource - for example, using the LocationDisplay::dataSource.
A FenceGeotrigger can also take into account floors within buildings. If the feature table used to create the FeatureFenceParameters is referenced by a FeatureLayer that is FloorAware, and the AbstractLocationDataSource used to create the GeotriggerFeed includes LocationSourcePropertiesKeys::floor information, then fences will only be entered when they are intersected by a Location on the correct floor. If the fence or location data does not include valid floor information, the floor is ignored and the fence is entered when it is intersected by the location.
A floor aware feature layer or table must be part of a GeoModel that includes a valid GeoModelFloorDefinition. All layers and tables that are used by the floor definition are loaded when the GeotriggerMonitor is started.
A Location can contain the floor property as part of Location::additionalSourceProperties. This is populated automatically by IndoorsLocationDataSource, or can be supplied as part of your own implementation.
[since Esri.ArcGISRuntime 100.13] filter : ArcadeExpression
The expression uses the Arcade language to determine whether feed entity updates are suitable for monitoring. The ArcadeExpression must evaluate to a boolean where:
trueindicates that the update will be used.
falseindicates that the update will not be used.
Filtering out undesirable updates reduces inaccurate notifications from your GeotriggerMonitor. For example, you could filter out GPS updates where the horizontal accuracy is poor, to avoid
false enter and exit notifications.
With a LocationGeotriggerFeed, the expression inspects a new Location object and returns
true if it is suitable and
false if not. Typically, your expression excludes Location objects where the Location::horizontalAccuracy does not meet your criteria - but it could also consider other properties such as Location::velocity and Location::course.
Arcade gives you access to the properties of the feed entity with the $locationupdate profile variable. This represents a new Location received from your device GPS. For example, an ArcadeExpression with the following string rejects Location updates with a horizontal accuracy greater than
return $locationupdate.horizontalaccuracy <= 10;
This property was introduced in Esri.ArcGISRuntime 100.13.
locationDataSource : AbstractLocationDataSource
The location data source that provides updates for the device location.
To receive location updates, the underlying location data source must be started. If you call GeotriggerMonitor::stop, the underlying AbstractLocationDataSource will not be stopped for you. For example, it may continue to receive GPS readings.
Emitted when the filter property changes.
Note: The corresponding handler is
This signal was introduced in Esri.ArcGISRuntime 100.13.
Emitted when the locationDataSource property changes.
Note: The corresponding handler is