Trip

Introduction

This is a vehicles trip and a summary of the driving activity during that trip. To get more information about stops during a trip please see ExceptionEvent. A complete "trip" is defined as starting at the time in which the vehicle starts and begins being driven. The trip continues after the vehicle has been stopped and ends at the time the vehicle restarts and begins being driven again; which then starts the next trip.

**Important Note on Date Range Searches:** When you search for events using a fromDate and toDate, the API returns all events that were active at any point during your search period. This is the intended behavior.

Specifically, an event is returned if:

It starts and ends within your specified time frame.
It started **before** your fromDate but ends within your time frame.
It starts within your time frame but ends **after** your toDate.
It started **before** your fromDate and ends **after** your toDate, overlapping the entire period.

Properties

The distance the vehicle was driven after work hours (in km).

The duration the vehicle was driven after work hours.

Whether the trip ends after hours.

Whether the trip starts after hours.

The duration the vehicle was stopped after work hours.

The average speed in km/h. This only includes the average speed while driving.

The Device associated with the trip.

The distance the vehicle was driven during this trip (in km).

The Driver for the trip.

The duration between the start and stop of the trip.

A value indicating the engine hours as of the end of the trip (measured in seconds).

The unique identifier for the specific Entity object in the Geotab system. See Id.

Total end of trip idling (idling is defined as speed is 0 and ignition on). It is calculated from the beginning of this trip to beginning of next trip.

The maximum speed of the vehicle during this trip (in km/h).

The start date of the next trip, as well as the end of the current trip session.

A value indicating the vehicle odometer value as of the end of the trip (in meters).

The number of incidents where the vehicle reached the first range of speeding triggers.

The duration where the vehicle drove in the first range of speeding triggers.

The number of incidents where the vehicle reached the second range of speeding triggers.

The duration where the vehicle drove in the second range of speeding triggers.

The number of incidents where the vehicle reached the third range of speeding triggers.

The duration where the vehicle drove in the third range of speeding triggers.

The date and time that the drive session started. This also signals the start of the trip.

The date and time the trip drive session ended, and the vehicle stopped moving. Note that this doesn't correspond to end of the trip session.

The duration the vehicle was stopped at the end of the trip. This also includes any idling done at the end of a trip.

The Coordinate associated with this Trip's stop.

The version of the entity.

The distance the vehicle was driven during work hours.

The duration the vehicle was driven during work hours.

The duration the vehicle was stopped during work hours.

Rate limits

Method	Description	Limit	Period	Status
Get	Limit of 1000 Get requests per 1m.	1000	1m	Inactive
Set	Limit of 100 Set requests per 1m.	100	1m	Inactive
Add	Limit of 100 Add requests per 1m.	100	1m	Inactive
Remove	Limit of 100 Remove requests per 1m.	100	1m	Inactive
GetCountOf	Limit of 100 GetCountOf requests per 1m.	100	1m	Inactive
GetFeed	Limit of 60 GetFeed requests per 1m.	60	1m	Active

Pagination

Results limit

25000

Supported sort

Start

Stop

Timeout Limit

Method	Description	Limit	Status
GetFeed		180	Active

Loading API Runner...

Trip

afterHoursDistance

afterHoursDrivingDuration

afterHoursEnd

afterHoursStart

afterHoursStopDuration

averageSpeed

device

distance

driver

drivingDuration

engineHours

id

idlingDuration

maximumSpeed

nextTripStart

odometer

speedRange1

speedRange1Duration

speedRange2

speedRange2Duration

speedRange3

speedRange3Duration

start

stop

stopDuration

stopPoint

version

workDistance

workDrivingDuration

workStopDuration