--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/courier-coordinates.md - https://yandex.kz/routing/doc/kk/delivery/courier-coordinates.md - https://yandex.kz/routing/doc/ru/delivery/courier-coordinates.md - href: ru/delivery/courier-coordinates.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt title: Яндекс Маршрутизация — получение координат курьеров --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/ru/llms.txt # Получение координат курьеров Логистам важно получать координаты курьеров в реальном времени, чтобы контролировать посещение курьерами заказов и складов и оценивать ожидаемое время приезда на заказ (ETA). Координаты передаются в Мониторинг с разной периодичностью: * если курьер в движении — каждые 20 секунд; * при стоянке — каждые 120 секунд. {% note warning %} Координаты, фактическое время которых отстает от текущего более, чем на 1 сутки, игнорируются. {% endnote %} В интерфейсе [Рабочего места логиста](https://yandex.ru/courier) могут отображаться не все переданные значения. Система фиксирует координаты в объеме, достаточном для построения маршрута. ## Источники координат {#coordinate-sources} Координаты могут поступать в Мониторинг из мобильного приложения или  GPS-трекера (см. раздел [Подготовка данных](https://yandex.kz/routing/doc/ru/delivery/load-data.md#data-preparation)), а также через API (этот способ настраивается специалистами техподдержки). Передача координат через API может применяться, например, если компания использует собственное мобильное приложение. Курьеры могут использовать одновременно и GPS-трекеры, и мобильное приложение [Яндекс Маршрутизация](https://yandex.kz/routing/doc/ru/rq-app/index.md): с помощью приложения курьеры получают информацию о заказах, оставляют комментарии и фотографии, а также определяют свое местоположение на карте. А GPS-трекер обеспечивает передачу в Мониторинг более точных координат, чем смартфон. ## Определение источника координат {#define-coordinates-source} Если координаты поступают из нескольких источников, можно указать, какой именно источник нужно использовать для отображения маршрута курьера и расчета ETA. Указать источник можно для всей компании или для отдельных курьеров. Если в качестве источника координат указан GPS-трекер, то приложение на смартфоне курьера не получает координаты с этого GPS-трекера, а определяет их самостоятельно. Координаты со смартфона при этом в Мониторинг не передаются. Задать источник координат для компании можно, только обратившись в службу поддержки. Задать источник координат для курьера можно [через API](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMobileEmployee), передав в теле запроса массив значений параметра `allowed_courier_position_sources`. Возможные значения: - `gps_tracker` — из GPS-трекера; - `app` — из мобильного приложения Яндекс Маршрутизация; - `s2s_api` — через API. Если для курьера параметр не задан, используется значение, установленное для компании. По умолчанию для компании разрешены все источники координат, а отдельно для курьеров параметры не заданы. Если для компании или курьера значение параметра `allowed_courier_position_sources` определено как пустой массив, координаты передаваться в Мониторинг не будут. ## Получение координат через API {#api-coordinates} Чтобы передать координаты курьера в базу данных, отправьте запрос к ресурсу [push-positions-v3](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/pushesCourierPositionsFromClientV3). В запросе укажите: * `courier_id` и `route_id` — ID курьера и ID маршрута, используемые в запросах к API Мониторинга. * `apikey` — API-ключ компании . Ключ указан в [настройках компании](https://yandex.kz/routing/doc/ru/delivery/interface/company.md#change-info), поле **API Key**. В заголовках запроса укажите `X-YaCourier-Signature`, в который должна быть добавлена [подпись](https://yandex.kz/routing/doc/ru/delivery/quickstart/api-signature.md). {% note warning %} Подпись вычисляется по [алгоритму](https://yandex.kz/routing/doc/ru/delivery/quickstart/api-signature.md#calculation-algorithm). Для вычисления используется секрет длиной до 32 символов (нужно получить через клиентского менеджера или службу поддержки). Секрет не является подписью. {% endnote %} **Запрос:** {% list tabs %} - Windows cURL ```html curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-OAuth-токен>" -H "X-YaCourier-Signature: <ваша-подпись>" -X POST -d @<Путь_до_файла_в_кодировке_UTF-8> https://api.courier.yandex.net/api/v1/couriers//routes//push-positions-v3?apikey= ```   Файл ```json { "positions": [ { "accuracy": 5, "point": { "lat": 59.987543, "lon": 30.353874 }, "timestamp": 1711964409 } ] } ``` - MacOS/Linux cURL ```html curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-OAuth-токен>" -H "X-YaCourier-Signature: <ваша-подпись>" -X POST -d '{"positions": [{"accuracy": 5, "point": {"lat": 59.987543, "lon": 30.353874}, "timestamp": 1711964409}]}' https://api.courier.yandex.net/api/v1/couriers//routes//push-positions-v3?apikey= ``` {% endlist %} **Результат:** ```json {} ``` Написать в службу поддержки [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))