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

  • *imeimeid**
    _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