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<int64>

The ID of the courier that is used in requests to the Track & Trace API.

route_id*

Type: integer<int64>

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 Timestamp of the courier position in UTC (in seconds). Min value: `0`
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.

Was the article helpful?

Gets order info

Overview