Entity geo tracker

Real-time entity geo tracking for advanced use cases

Overview

Events with location information, longitude and latitude, can be used for entity based geo tracking. Entities such as mobile phone and GPS enabled devices with unique identifiers can used since they provide the required location attributes for the analytics to function.

This is a stateful based feature, once an entity enters a geofence it is tracked until it has exited. There are three states the entity triggers for further processing.

Key tracking features

  • Entry

  • Dwelling

  • Exit

Tracking information provided as an attribute geoTrackingInfo field within the the processed event, see the Geo Tracking Info Response section below.

Example & DSL attributes

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  

Response

The processor adds a geoTrackingInfo attribute with the following result

geoTrackingInfo:
    geoTrackingInfo:
        GeoTrackingInfo:
            trackingTag=1234567890, 
            currentSpeedAndDirection=Triple{x=0.018464618471082432, y=GeoDirection{description='NorthEast'}, z=58.10799195554135}, 
            previousSpeedAndDirection=Triple{x=0.03388915574387011, y=GeoDirection{description='East'}, z=79.01663649781628}, 
            distanceTraveled=92.32309235541216, 
            previousDistanceTraveled=169.44577871935053, 
            previousLat=51.504119873046875, 
            previousLng=-0.2196580022573471, 
            currentLat=51.50470733642578, 
            currentLng=-0.2187139093875885, 
            geoFenceOccupancyState={106=ENTERED}, 
            previousUpdatedTimestamp=1715617238476, 
            currentUpdatedTimestamp=1715617243476}, 
            latitude=51.50470697, 
            imsi=1234567890, 
            longitude=-0.218713905

Attributes schema

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.

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 schema

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 Response

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

Last updated