Class GeotriggerMonitor
A GeotriggerMonitor monitors a Geotrigger condition and, when it is met, results in a GeotriggerNotificationInfo.
Inheritance
Namespace: Esri.ArcGISRuntime.Geotriggers
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class GeotriggerMonitor
Remarks
A Geotrigger defines a query that is evaluated against GIS data as it changes in real time. For example, "Notify me when my device location enters one of my target areas" or "Notify me when my device location is within 50 m of my destination".
A GeotriggerMonitor is created with a Geotrigger that it continually checks to determine whether the condition has been met.
Once a GeotriggerMonitor is created, you begin checking the condition by calling StartAsync(). Once you are finished, call Stop(). When a Geotrigger evaluates to true, a Notification is sent. You can subscribe to the notification info to receive details of where the Geotrigger was activated and the condition that was met.
A GeotriggerMonitor can continue monitoring its Geotrigger condition when a mobile application is in the background. To enable this in an iOS or Android application, the following is recommended:
- Use a LocationGeotriggerFeed with a LocationDataSource based on the GPS of the device.
- Add manifest entries and request user permissions to allow background location updates.
The GeotriggerMonitor uses processing time provided by device location updates to monitor the active geotrigger. For backgrounded applications, the timing of location updates (and therefore the timing of geotrigger notifications) is determined by the operating system. If a FenceGeotrigger uses FeatureFenceParameters that reference a ServiceFeatureTable, and the table is associated with a FeatureLayer that has a non-zero RefreshInterval, the geotrigger monitor requests fence updates from the server on that interval even when the application is in the background.
Constructors
Name | Description |
---|---|
GeotriggerMonitor(Geotrigger) | Initializes a new instance of the GeotriggerMonitor class with a Geotrigger condition. |
Properties
Name | Description |
---|---|
Geotrigger | Gets the Geotrigger that will be monitored. |
Status | Gets the current status of the GeotriggerMonitor. |
Warning | Gets an error that describes a problem encountered while starting or monitoring the Geotrigger. |
Methods
Name | Description |
---|---|
StartAsync() | Starts evaluating the Geotrigger. |
Stop() | Stops evaluating the Geotrigger. |
Events
Name | Description |
---|---|
Notification | Indicates that the Geotrigger condition has been meet. |
StatusChanged | Indicates that the Status property has changed. |
WarningChanged | Indicates that the Warning property has changed. |
Applies to
Target | Versions |
---|---|
.NET Standard 2.0 | 100.12 - 200.6 |
.NET | 100.13 - 200.6 |
.NET Windows | 100.13 - 200.6 |
.NET Android | 200.0 - 200.6 |
.NET iOS | 200.0 - 200.6 |
.NET Framework | 100.12 - 200.6 |
Xamarin.Android | 100.12 - 100.15 |
Xamarin.iOS | 100.12 - 100.15 |
UWP | 100.12 - 200.6 |