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
Response
The processor adds a geoTrackingInfo
attribute with the following result
Attributes schema
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.
Attributes schema
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.
Last updated