Pushes courier positions from client
Pushes courier positions to the database for tracking.
Request
POST
https://api.courier.yandex.net/api/v1/couriers/{courier_id}/routes/{route_id}/push-positions-v3
Path parameters
|
Name |
Description |
|
courier_id* |
Type: integer The ID of the courier that is used in requests to the Track & Trace API. |
|
route_id* |
Type: integer The ID of the route that is used in requests to the Track & Trace API. |
Query parameters
|
Name |
Description |
|
apikey* |
Type: string Company's apikey. |
Body
application/json
{
"positions": [
{
"accuracy": 0,
"point": {
"lat": 0,
"lon": 0
},
"timestamp": 0,
"heading": 0,
"speed": 0
}
]
}
|
Name |
Description |
|
positions* |
Type: PositionV3[] |
PositionV3
|
Name |
Description |
|
accuracy* |
Type: integer GPS accuracy in meters. |
|
point* |
Type: Point |
|
timestamp* |
Type: integer<datetime> Timestamp of the courier position in UTC (in seconds). Min value: |
|
heading |
Type: integer Direction toward true North, in degrees. Not supported yet. |
|
speed |
Type: number<float> Instantaneous velocity. Not supported yet. |
Point
|
Name |
Description |
|
lat* |
Type: number<float> Location latitude. |
|
lon* |
Type: number<float> Location longitude. |
Responses
200 OK
Data was saved.
403 Forbidden
You do not have access to this object.
404 Not Found
No object found.
422 Unprocessable Entity
Incorrect input.
No longer supported, please use an alternative and newer version.