Event Rule / Notifier variables
Note: for an updated version of this and other articles, we recommend you to check our knowledge base here
With this post we intend to describe the variables you can find by default in your Vehicle Tracker for your Event Rules notifications (Argument, Report Arguments, SMS, Email and Text notifications).
The format is the following:
Variable label | Variable name | Description
-- GENERIC variables (apply to all the Expressions in an Event Rule)
Rule name | [RULE_NAME] | The event rule name defined in the vehicle tracker interface
Trigger time | [EVENT_TIME] | The local time when the rule has been triggered
Event duration | [EVENT_DURATION] | The duration of the event until has reached its end state
Vehicle login id | [USER_USERNAME] | The username of the unit that generated the event defined in Details
Vehicle name | [USER_NAME] | The name assigned to the unit defined in Details
Vehicle description | [USER_DESCRIPTION] | The vehicle description assigned defined in Details
Application name | [APPLICATION_NAME] | The name of the application where the Event Rule has been executed
Position timestamp | [POS_TIME] | The time of the last valid/invalid position when the event occurred
Last valid Position time | [POS_TIME_LAST_VALID] | The time of the last valid position when the event occurred
Latitude | [POS_LATITUDE] | Latitude of the last position when the event occurred expressed in Signed degrees format
Longitude | [POS_LONGITUDE] | Longitude of the last position when the event occurred expressed in Signed degrees format
Heading | [POS_HEADIGN] | The heading in degrees of the vehicle at the moment of the event
Address | [POS_ADDRESS] | Address of the last valid position registered (geocoder dependent)
Mobile application login | | A link with the summary of the current events
Map link | http://maps.google.com?q|[POS_LATITUDE],[POS_LONGITUDE] | Google map link to the position where the event occurred.
-- DRIVER VARIABLES: the following variables will be displayed only when a vehicle generates an event, the proper Event Rule has been setup for Driver Identification and the Driver identified correctly in the platform (http://gpsgate.com/blogComment/how_to_add_a_driver_to_gpsgate)
Driver user ID | [DRIVER_USER_ID] | The driver unique identifier in the database
Driver ID | [DRIVER_ID] | The driver ID defined in the Driver Info property.
Driver name | [DRIVER_NAME] | The driver name defined in the Details of the driver.
Driver login id | [DRIVER_USERNAME] | The driver username defined in the Details of the driver.
Driver description | [DRIVER_DESCRIPTION] | The driver description defined in the Details of the driver.
-- VEHICLE variables: the following variables will be displayed only when the Driver is the one who triggers the event --
Assigned Vehicle Name | [ASSIGNED_VEHICLE_NAME] | The vehicle name assigned to the driver
Assigned Vehicle Username | [ASSIGNED_VEHICLE_USERNAME] | The vehicle username assigned to the driver
Assigned Vehicle ID | [ASSIGNED_VEHICLE_ID] | The ID of the vehicle in the database
Assigned Vehicle description | [ASSIGNED_VEHICLE_DESC] | The vehicle description
-- GEOFENCE variables: the following variables will be available when you select "4. Expression" a Geofence.
Geofence | [GEOFENCE_NAME] | The name of the geofence given
Geofence ID | [GEOFENCE_ID] | The ID of the geofence in the database
-- INTERVAL EVENTS variables: the following variables will be available when you select "4. Expression" Interval Event.
Interval kind | [Interval kind] | CustomPeriodic (unique value)
Current interval start value | [Current interval start value] | The value that will start the next interval event
Next interval start value: | [Next interval start value] | The value of the next start increment in your interval
Initial start value | [Initial start value] | The initial value set on the Event Rule
Interval size | [Interval size] | The interval size number set in the Event Rule
-- TIME INTERVALS variables: the following variables will be available when you select "4. Expression" Time Interval.
Time interval kind | [Time interval kind] | The time interval set in the Event Rule
Initial start time | [Initial start time] | The initial time interval set in the Event Rule
Current interval start time | [Current interval start time] | The current interval start time
Custom time interval length | [Custom time interval length] | The length of the custom time interval set in the rule
Next interval start time | [Next interval start time] | The next time interval
DateTimeServer | [_DateTimeServer] | The date & time of the server localized
-- POINTS OF INTEREST variables: the following variables will be available when you activate in Privileges and Features -> Point of Interests in your application and select "4. Expression" Points of Interest.
POI ID | [POI_ID] | The ID of the POI in the database
POI NAME | [POI_NAME] | The name set when creating the POI
POI DESCRIPTION | [POI_DESCRIPTION] | The description set when creating the POI
POI Category name | [POI_CATEGORY_NAME] | The name of the category where the POI was created into
POI Category description | [POI_CATEGORY_DESCRIPTION] | The description of the POI category
-- SPEEDING EXPRESSION variables: the following variables will be available when you activate the plugin Speeding Expression in your application and select "4. Expression" Speeding Expression.
How to steup the Speeding Expression plugin follow this guide: http://gpsgate.com/blogComment/speeding_expression
Speed Limit | [SPEEDING_SPEED_LIMIT] | The speed limit used during the evaluation of the Event Rule
Road Cateogory | [SPEEDING_ROAD_CATEGORY] | The road category such as Motorway or Primary road
Is Speed Limit Fallback | [SPEEDING_IS_SPEED_FALLBACK] | True if the speed limit used was a fallback value, otherwise false (data taken from OSM)
There are functions that you can include in order to get more information: $MAX, $MIN, $START, $FINAL and $END. By default the value that the variable gets is the one that triggers the event which would be the $START function. In order to use them just add them on the Report Argument when selecting the variable according to the convention: $FUNCTION([VARIABLE]).
$FINAL() is empty on an ongoing event, and the end value when the event finish. $END is the last value of on ongoing event, and the end value when the event finish.