Update location (v2)

POST

/tracking/driver/update/v2

POST

/tracking/driver/update/v2

1 import { ChrtClient } from "@chrt-inc/typescript-sdk";
2 
3 async function main() {
4     const client = new ChrtClient({
5         token: "YOUR_TOKEN_HERE",
6     });
7     await client.tracking.driver.updateV2({
8         location: {
9             geometry: {
10                 type: "GeometryCollection",
11                 geometries: [
12                     {
13                         type: "LineString",
14                         coordinates: [
15                             [
16                                 -122.4194,
17                                 37.7749,
18                             ],
19                             [
20                                 -122.418,
21                                 37.7755,
22                             ],
23                             [
24                                 -122.417,
25                                 37.776,
26                             ],
27                         ],
28                     },
29                 ],
30             },
31             type: "Feature",
32         },
33         schema_version: 1,
34         timestamp: "2024-01-15T09:30:00Z",
35     });
36 }
37 main();

1 {
2   "cargo_tracking_count": 3,
3   "driver_by_driver_ping_recorded": true,
4   "driver_updated": true,
5   "task_group_tracking_count": 2
6 }

Records driver location updates with a client-supplied capture timestamp. Writes a driver_by_driver ping on every call, updates the driver’s last seen, and records tracking data for all IN_PROGRESS task groups and their associated IN_TRANSIT cargos. | auth: api_key | (DriverByDriverDataPointClientCreate1) -> (DriverUpdateRes)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

locationobjectRequired

GeoJSON Feature with typed properties for locations

The geometry field is strongly typed as Geometry (union of all geometry types) but remains optional to match the base Feature class specification. To ensure geometry is always present, validate it at runtime or make it required.

schema_versionintegerRequired

timestampdatetimeRequired

Response

Successful Response

cargo_tracking_countinteger

driver_by_driver_ping_recordedboolean

driver_updatedboolean

task_group_tracking_countinteger

Errors

422

Driver Update V2request Unprocessable Entity Error