Trip Start

The TRIP_START_MESSAGE event is used to notify when a vehicle's trip begins. It marks the point when the ignition is turned on.

**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