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

enum 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

enum 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

enum 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.