Trip Settings

This API allows you to get or set specific values, such as event notification thresholds, for an individual trip. For the specified trip, these settings override the default API key settings that were selected at the time the API key was created.

For example, if the API key has a setting of 2 miles for the threshold of when an Out-of-Cooridor event is triggered, the Trip Settings API can set it to 1 mile or any other value for the specific trip only.

To get the correct values, users of this API must perform authentication using the API key that is associated with the Company Account.

POST /trip/{tripID}/settings/{setting}

GET /trip/{tripID}/settings/{setting}

Setting the Out-of-Corridor Threshold for a Trip

The “Out of Corridor” or OoC threshold is the distance a vehicle or GPS ping departs from the planned route at which the Trip Management service generates an OoC event notification.

Resource URL

https://tripmanagement.alk.com/api/trip/{tripID}/settings/ooc

Path Field

Field Description Type
tripId The alkTripId returned when you planned the trip.
integer
Yes

POST Body Field

Field Description Type
oocDistanceThreshold The threshold distance at which an Out of Corridor event notification will be triggered. Units in miles.
integer
Yes

Sample POST Request

{
  oocDistanceThreshold: 5
}

Sample POST Response

{
  success: true,
  message: null
}

Sample GET Response

{
  oocDistanceThreshold: 5.0
}
Last updated December 17, 2020.