TransportProviderPositionUpdate
POSThttps://<3P_WEBHOOK_URI>¶ Description
This webhook delivers real-time location updates for the transport provider (driver) assigned to an order. Updates are sent periodically while the driver is en route to the pickup or dropoff location.
¶ Webhook Developer UUID
v1-rides-transport-provider-position-update
¶ Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| order_id | UUID | The id of the Order. | Y |
| requester_id | UUID | Unique identifier of the requester of this order. | Y |
| latitude | double | The latitude of the transport provider’s current position. | Y |
| longitude | double | The longitude of the transport provider’s current position. | Y |
| heading | double | The direction the transport provider is traveling, in degrees (0–360, where 0 is north). | N |
| updated_at | UnixTimeMillis | The timestamp of the position update. This is an ever-increasing number; you can safely discard this event if this timestamp is less than what you have seen previously. | Y |
¶ Example Request
{
"order_id": "550e8400-e29b-41d4-a716-446655440000",
"requester_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"latitude": 37.7749,
"longitude": -122.4194,
"heading": 270.0,
"updated_at": 1700000000000
}