Step 2. Get locations of all vehicles of a company and their proximity to your location of interest.

You have a load that needs to be picked up at an estimated time and specific location, and you’re unsure which vehicle to track for this purpose.

You now know, from Step 1 1, whose vehicles you can track. Having selected a carrier, you can find out which of their vehicles is most likely to meet your criteria.

In your request, indicate the carrier whose vehicle locations you want by providing one of the two types of company IDs to specify the carrier (you retrieved these IDs in the Step 1 response payload):

  • company_id: KeepTruckin’s ID for that carrier
  • dot_id: Federal ID(s) for that carrier

In your request, also define the pickup and dropoff locations using latitude and longitude (lat,lon). Add the estimated time for the carrier to pick up the load using the expected_time parameter.

Behind the scenes of this API is a sophisticated algorithm that compares all the fleet’s vehicles’ likelihood of reaching the destination you have defined within the time range you specified. The algorithm takes into consideration the following factors:

  • truck-based ETA (weighted at 50%)
  • the HOS cycle for the driver (weighted at 30%)
  • the current direction of the vehicle in relation to the location you have provided (weighted at 20%)

Using these three criteria, our algorithm returns a matching_score, which is the compatibility of each vehicle’s current attributes with your needs.

There is a rate limit of once every 12 minutes per consumer_company_id | producer_company_id pairing.

The response consists of a list of all vehicles, sorted by best matching_score. In addition, it contains the vehicle ID, the ID and name of the driver, and the vehicle’s relative distance from the pickup point.


Learn more

Read our reference documentation about the Vehicle Association endpoint for details.

Click Try It! to start a request and see the response here!