Отправляет позиции курьеров в базу данных

Отправляет позиции курьеров в базу данных для отслеживания.

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>

ID курьера, используемый в запросах к API Мониторинга.

route_id*

Type: integer<int64>

ID маршрута, используемый в запросах к API Мониторинга.

Query parameters

Name

Description

apikey*

Type: string

API-ключ компании.

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 в метрах.

point*

Type: Point

timestamp*

Type: integer

Время позиции курьера в UTC (в секундах).

Min value: 0

heading

Type: integer

Направление, в градусах по отношению к северу. Ещё не поддержано.

speed

Type: number<float>

Мгновенная скорость. Ещё не поддержано.

Point

Name

Description

lat*

Type: number<float>

Широта точки.

lon*

Type: number<float>

Долгота точки.

Responses

200 OK

Данные были сохранены.

403 Forbidden

У вас нет доступа к этому объекту.

404 Not Found

Объект не найден.

422 Unprocessable Entity

Неправильный ввод.