Get GPS Coords

Trip Management’s Get GPS Coords API gets all of the GPS coordinates that have been recorded for your previously generated route.

The following two variations of requests are supported for this functionality:

GET /gpsCoords/{tripId}

Request Fields

FieldDescriptionTypeRequired
tripIdThe alkTripId returned when you planned the trip.integerYes

GET /gpsCoords?tripId={tripId}

Request Fields

FieldDescriptionTypeRequired
tripIdThe alkTripId returned when you planned the trip or the tmsTripId in your planning system.
Note: Only one can be used when making a request through the URL. The search logic will check for the user’s trips with matching tmsTripId. If no trips are found with provided tmsTripId, then the check will continue for trips with matching alkTripId. If no trip is found matching with either of the Trip IDs, then no trip found response will be returned.
integer or stringYes

Response Fields

Same response for both the types of requests

FieldDescriptionType
coordsThe object containing the latitude/longitude of the GPS.Coords object
coords/latThe GPS latitude.string
coords/lonThe GPS longitude.string
SpeedThe Speed recorded from the GPS.integer
HeadingThe Heading of the GPS.integer
AltitudeThe Altitude of the GPS.integer
DeviceDTThe device’s timestamp of the GPS position. The value must be in ISO-8601 format.string

Sample Response

[
  {
    coords: {
      lat: "40.452627",
      lon: "-79.141919"
    },
    speed: 0,
    heading: 0,
    altitude: null,
    deviceDT: "2017-09-19T16:48:48"
  },
  {
    coords: {
      lat: "40.12345",
      lon: "-79.12345"
    },
    speed: 30,
    heading: 20,
    altitude: 1000,
    deviceDT: "2017-09-19T19:19:19"
  }
];