Entity Geo Tracker

Stateful based geo tracking using geofencing. State is held per tracking object for entry, dwelling and exit. As events enter, dwell and exit geofence an alert are generated. The event is tracked once it has entered a geofence.

Example

entity geo tracker:
    name: promotions
    entity key: imsi
    min dwelling time: 2
    timeUnit: MINUTES
    geofences:
      -
        id: 107
        coordinates: ["51.506645","-0.20406286"]
        radius: 150
      -
        id: 106
        coordinates: ["51.503845","-0.2172389"]
        radius: 150
      -
        id: 119
        coordinates: ["51.509743","-0.18553847"]
        radius: 150  

Attributes

Attribute	Description	Data Type	Required
geofences	List of geofences to trigger entity	See geofence attribute section
entity key	Entity value to track. provide unique key	String Default: id
geo tracking info	StreamEvent key to place tracking information	String Default: geoTrackingInfo
latitude field	StreamEvent field holding latitude value	String Default: latitude
longitude field	StreamEvent field holding longitude value	String Default: longitude
dwelling time	Minimum dwelling time within a geofence	Long Default: 15 Seconds
timeUnit	Time unit used to assess dwelling time. Supported units: SECONDS MINUTES HOURS	TimeUnit Default: SECONDS
default radius	Geofence radius override to be applied if reference data is missing	Float Default: 4.0f ( xx feet)
spatial index	An area is set out as a search tree. The default area is a flattened world divided out in to rectangles.	See spatial index documentation

Geofence Attribute

A geofence is a circle defined up a unique Id, its centre point(latitude and longitude coordinates) and radius. One or more geofences are defined as a list.

geofences:
  -
    id: 1000
    coordinates: ["51.4623328","-0.1759467"]
    radius: 150
  -
    id: 2000
    coordinates: ["51.5136287","-0.1137969"]
    radius: 150

Attributes

Attribute	Description	Data Type	Required
id	Unique Id for the geofence	Integer
coordinates	Centre latitude and longitute coordinates defined as string to ensure correct resolution	String Array
radius	Radius of geofence in feet	Float

Geo Tracking Info Field

The geoTrackingInfo field, or the one specified by the developer, is added to the processed StreamEvent object on processing completion. A GeoTrackingInfo object is assigned to the field. Below are the attributes held within the object.

Key: geoTrackingInfo 
Value: GeoTrackingInfo
      - trackingTag
      - currentSpeedAndDirection
      - previousSpeedAndDirection
      - distanceTraveled
      - previousDistanceTraveled
      - previousLat
      - previousLng
      - currentLat
      - currentLng
      - geoFenceOccupancyState
      - previousUpdatedTimestamp
      - currentUpdatedTimestamp