ArcGIS Runtime SDK for iOS: AGSFenceGeotrigger.h File Reference
ArcGIS Runtime SDK for iOS  100.15
AGSFenceGeotrigger.h File Reference

Go to the source code of this file.

Enumerations

enum  AGSFenceEnterExitSpatialRelationship { AGSFenceEnterExitSpatialRelationshipEnterIntersectsAndExitDoesNotIntersect = 0 , AGSFenceEnterExitSpatialRelationshipEnterContainsAndExitDoesNotContain = 1 , AGSFenceEnterExitSpatialRelationshipEnterContainsAndExitDoesNotIntersect = 2 }
 
enum  AGSFenceGeotriggerFeedAccuracyMode { AGSFenceGeotriggerFeedAccuracyModeUseGeometry = 0 , AGSFenceGeotriggerFeedAccuracyModeUseGeometryWithAccuracy = 1 }
 
enum  AGSFenceRuleType { AGSFenceRuleTypeEnter = 0 , AGSFenceRuleTypeExit = 1 , AGSFenceRuleTypeEnterOrExit = 2 }
 

Enumeration Type Documentation

◆ AGSFenceEnterExitSpatialRelationship

The spatial relationship that determines when a fence has been entered or exited.

When determining whether a feed entity has entered or exited a fence polygon, there are two spatial operations that can be used:

  • Intersects: the feed geometry must intersect the fence polygon.
  • Contains: the feed geometry must be contained by the fence polygon.

These operations determine whether a fence polygon has been entered, and also when it has been exited (the feed geometry no longer intersects or is no longer contained by the fence polygon). Because the contains condition is more strict than intersects (a geometry can intersect another geometry without being contained by it) it tends to result in fewer notifications when the two geometries are nearby. By using different combinations of these rules for enter and exit, you can control the likelihood that notifications will be sent.

Note that when the feed geometry is an AGSPoint, there is no difference between intersection and containment, so both options behave the same. When using an AGSLocationGeotriggerFeed, set AGSFenceGeotrigger::feedAccuracyMode to AGSFenceGeotriggerFeedAccuracyModeUseGeometryWithAccuracy in order to create a polygon geometry that accounts for the area of uncertainty around an AGSLocation::position.

Since
100.13
Enumerator
AGSFenceEnterExitSpatialRelationshipEnterIntersectsAndExitDoesNotIntersect 

The fence polygon is entered when it intersects an AGSGeotriggerFeed entity and exited when it no longer intersects.

AGSFenceEnterExitSpatialRelationshipEnterContainsAndExitDoesNotContain 

The fence polygon is entered when it contains the entity from an AGSGeotriggerFeed and exited when the entity is no longer contained.

AGSFenceEnterExitSpatialRelationshipEnterContainsAndExitDoesNotIntersect 

The fence polygon is entered when it contains an AGSGeotriggerFeed entity and exited when it no longer intersects.

◆ AGSFenceGeotriggerFeedAccuracyMode

The possible ways an AGSFenceGeotrigger uses accuracy information from an AGSGeotriggerFeed.

This enumeration defines cases for using accuracy information from an AGSGeotriggerFeed to provide the AGSGeometry for checking an AGSGeotrigger condition. In particular, you can choose how to use the AGSLocation::horizontalAccuracy property to reflect the uncertainty around a fixed AGSLocation::position. Due to various factors, GPS positions may be inaccurate, with AGSLocation::horizontalAccuracy representing a radius that defines the area containing the actual location. Spurious notifications may occur when the AGSLocation::position is inaccurate and is incorrectly reported as inside or outside of a fence. You can use the AGSLocation::horizontalAccuracy to account for that uncertainty.

These values are used in conjunction with AGSFenceGeotrigger::enterExitSpatialRelationship to affect when notifications are sent.

Since
100.13
Enumerator
AGSFenceGeotriggerFeedAccuracyModeUseGeometry 

The reported AGSGeometry from an AGSGeotriggerFeed is used.

AGSFenceGeotriggerFeedAccuracyModeUseGeometryWithAccuracy 

The reported AGSGeometry from an AGSGeotriggerFeed is used in conjunction with accuracy information.

◆ AGSFenceRuleType

The rule or query that determines whether an AGSFenceGeotrigger condition is met.

Since
100.12
Enumerator
AGSFenceRuleTypeEnter 

Check whether objects from the AGSGeotriggerFeed enter the AGSFenceParameters.

AGSFenceRuleTypeExit 

Check whether objects from the AGSGeotriggerFeed exit the AGSFenceParameters.

AGSFenceRuleTypeEnterOrExit 

Check whether objects from the AGSGeotriggerFeed enter or exit the AGSFenceParameters.