Trip Start

**Event Type:**TRIP_START_MESSAGE

Trigger Condition

Subscription to the TRIP_START_MESSAGE event is mandatory.
This event is triggered immediately when the vehicle's ignition is turned on.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "TRIP_START_MESSAGE",
"deviceId": "2a82cb25-2d24-11ec-b7b6-73343065470c",
"networkService": 0,
"commStateConnected": 0,
"messageType": "TRIP_START_MESSAGE",
"messageIndex": "129109338",
"dimentionFix": 0,
"lastKnownLon": -80.288002,
"inputBit0": 0,
"inputBit2": 0,
"vin": "1GCNCPEH5FZ386651",
"id": "1c006372-e201-4556-895c-b0bf00483ba3",
"state": "FL",
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": "Miami-Dade",
"eventIndex": 0,
"assetNo": "a0R37000000e946EAA",
"fixStatusCorrected": 0,
"deviceSerial": "1070304390",
"groupName": "216 - Miami",
"lastKnownTime": 1662614865000,
"jmsType": "",
"vehicleName": "6734",
"deviceTypeId": 1,
"city": "Miami",
"latitude": 25.7654698,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 2748,
"tripNumber": 2982,
"spare": 0,
"address": "553-599, State Hwy 959, Miami, FL, 33144, USA",
"roaming": 0,
"stateId": 0,
"userId": "8a9388a8-7ece-11ca-0180-2a03414d30a0",
"eventCode": 0,
"batteryPercentage": 0,
"currentState": 0,
"messageEventTypeId": 0,
"zipCode": "33144",
"country": "US",
"deviceAssociatedVIN": "1GCNCPEH5FZ386651",
"groupId": "43dfb7d9-47b0-11e6-8c60-7f87a6884da0",
"vendorTypeId": 1,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": -80.2880055,
"locationTime": 1662614865000,
"odometer": 183722,
"offset": -240,
"virtualTripEnd": false,
"imei_meid": "352602114358374",
"insideHOO": true,
"milStatus": 0,
"lastKnownLat": 25.7654632,
"fixQuality": 0,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": "553-599, State Hwy 959, Miami, FL, 33144, USA",
"eventTripNumber": 2982,
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "3895a99b-5772-11e7-be83-4f9127ac3dc9",
"lastKnownFixQuality": 0,
"userName": "Vaugn HARRIS",
"tripState": "ACTIVE",
"messageTypeId": 8,
"imei": "352602114358374",
"location": {
"latitude": 25.7654698,
"longitude": -80.2880055
},
"commonState": 0
}

Reference

Field	Description
type String	Type of the event. Example: `TRIP_START_MESSAGE`
deviceId String,UUID	Unique identifier of the device. Example: `2a82cb25-2d24-11ec-b7b6-73343065470c`
messageType String	Type of message. Example: `TRIP_START_MESSAGE`
lastKnownLon Double	Last known longitude of the vehicle in degrees. Example: `-80.288002`
vin String	Vehicle Identification Number. Example: `1GCNCPEH5FZ386651`
id String,UUID	Unique identifier for the message. Example: `1c006372-e201-4556-895c-b0bf00483ba3`
state String	State of the vehicle location. Example: `FL`
locality String	Local region or area. Example: `Miami-Dade`
assetNo String	Asset number. Example: `a0R37000000e946EAA`
deviceSerial String	Serial number of the device. Example: `1070304390`
groupName String	Name of the assigned group. Example: `216 - Miami`
lastKnownTime TimeStamp	Last known timestamp in milliseconds.. Example: `1662614865000`
vehicleName String	Name of the vehicle. Example: `6734`
deviceTypeId Integer	Type ID of the device, 1-Datalogger Example: `1`
city String	City name. Example: `Miami`
customerId Integer	Unique ID of the customer. Example: `2748`
tripNumber Integer	Represents a unique ID assigned to a specific trip, allowing the system to track and reference that particular journey or route. Example: `2982`
address String	Full address of the vehicle location. Example: `553-599, State Hwy 959, Miami, FL, 33144, USA`
userId String,UUID	Unique ID of the user. Example: `8a9388a8-7ece-11ca-0180-2a03414d30a0`
messageEventTypeId Integer	ID of the event type. Example: `0`
zipCode String	ZIP code of the location. Example: `33144`
country String	Country Example: `US`
deviceAssociatedVIN String	VIN associated with the device. Example: `1GCNCPEH5FZ386651`
groupId String,UUID	Unique ID of the group. Example: `43dfb7d9-47b0-11e6-8c60-7f87a6884da0`
vendorTypeId Integer	Vendor type identifier. Example: `1`
locationTime Time Stamp	Time the location was recorded in milliseconds. Example: `1662614865000`
odometer Integer	Odometer reading in kilometers. Example: `183722`
offset Integer	Time zone offset Example: `-240`
virtualTripEnd Boolean	Indicates if virtual trip ended. Example: `false`
imei_meid String	IMEI or MEID of the device. Example: `352602114358374`
insideHOO Boolean	Indicates if inside hours of operation. Example: `true`
milStatus Integer	Malfunction Indicator Lamp status. Example: `0`
lastKnownLat Double	Last known latitude of the vehicle in degrees. Example: `25.7654632`
storedLocation Boolean	Indicates whether location is stored. Example: `false`
protocolVersionIdChange Boolean	Indicates whether protocol version changed. Example: `false`
lastKnownAddress String	Last known address. Example: `553-599, State Hwy 959, Miami, FL, 33144, USA`
eventTripNumber Integer	Trip number for event. Example: `2982`
privacyModeEnable Boolean	Indicates whether privacy mode is enabled. Example: `false`
vehicleId String,UUID	Unique vehicle ID. Example: `3895a99b-5772-11e7-be83-4f9127ac3dc9`
userName String	Name of the user. Example: `Vaugn HARRIS`
tripState String	State of the trip. Example: `ACTIVE`
messageTypeId Integer	Type ID of the message. Example: `8`
imei String	IMEI of the device. Example: `352602114358374`
location Location { latitude: 34.12 longitude: -82.14 }	Current location object of the vehicle
latitude Double	Latitude co-ordinate value in degrees Example: `34.12`
longitude Double	Longitude co-ordinate value in degrees Example: `-82.34`