Реалізація Real-Time трекінгу кур'єра/замовлення на сайті
Користувач оформив замовлення і чекає на кур'єра. Сторінка «Мої замовлення» з полем «статус: в дорозі» — це вже минуле століття. Сучасний стандарт — карта з живим маркером кур'єра та лічильником «прибуде через N хвилин». Технічно це зв'язка трьох компонентів: мобільний додаток/пристрій кур'єра, бекенд-додаток, клієнтський браузер. Ми побудували такі системи для 30+ проектів доставки — від локальних сервісів до федеральних мереж. Пропонуємо рішення під ключ: від 4 днів на базовий трекінг. Зв'яжіться з нами для розрахунку вашого проекту.
Чому polling бази — поганий вибір?
Здавалося б, можна опитувати сервер кожні 5 секунд: GET /api/order/status. Але це створює зайве навантаження на сервер, збільшує TTFB для інших запитів і не дає миттєвого оновлення. WebSocket в рази ефективніше: подія приходить одразу, без затримки опитування. Однак проста реалізація WebSocket без авторизації відкриває доступ до чужих замовлень. Ми використовуємо PrivateChannel Laravel Broadcasting з перевіркою прав.
Архітектура потоку даних
[Пристрій кур'єра]
GPS → POST /api/courier/location кожні 3–5с
↓
[Backend]
Зберегти в Redis (TTL 60s)
Publish в Redis Pub/Sub канал order:{id}
↓
[WebSocket сервер (Laravel Reverb / Pusher)]
Broadcast event LocationUpdated
↓
[Браузер клієнта]
Оновити маркер на карті
Геопозиції не зберігаються в PostgreSQL при кожному оновленні — це 720 записів на годину на одного кур'єра. В базу пишемо тільки при зміні статусу замовлення та фінальну позицію при завершенні. Поточна позиція — в Redis з TTL.
Чому Redis — оптимальне сховище для геоданих?
Redis забезпечує низьку затримку запису і читання (субмілісекунди) та автоматичне видалення застарілих даних через TTL. Для трекінгу це критично: позиція кур'єра актуальна лише короткий час. Постійний запис в PostgreSQL призвів би до 720 записів на годину на одного кур'єра — невиправдане навантаження на базу. З Redis ми економимо ресурси та прискорюємо читання: отримати поточну позицію можна за один запит до in-memory сховища. Економія на серверній інфраструктурі може досягати 40% за рахунок відмови від постійного polling.
Приклад конфігурації WebSocket-сервера з Laravel Reverb
Для продакшну рекомендується використовувати Reverb з горизонтальним масштабуванням через Redis. Налаштування зводиться до встановлення пакету, публікації конфігу та запуску воркера. Детальніше — в офіційній документації Laravel.Таблиця замовлень
CREATE TABLE delivery_orders (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id),
courier_id BIGINT REFERENCES couriers(id),
status VARCHAR(50) NOT NULL DEFAULT 'pending',
-- pending | assigned | picked_up | in_transit | delivered | failed
address_lat DECIMAL(10, 8),
address_lng DECIMAL(11, 8),
address_text VARCHAR(500),
estimated_at TIMESTAMP,
delivered_at TIMESTAMP,
created_at TIMESTAMP NOT NULL DEFAULT NOW()
);
CREATE TABLE delivery_status_log (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES delivery_orders(id),
status VARCHAR(50) NOT NULL,
lat DECIMAL(10, 8),
lng DECIMAL(11, 8),
note TEXT,
created_at TIMESTAMP NOT NULL DEFAULT NOW()
);
API кур'єра: оновлення позиції та broadcast
class CourierLocationController extends Controller
{
public function update(Request $request, DeliveryOrder $order): JsonResponse
{
$data = $request->validate([
'lat' => 'required|numeric|between:-90,90',
'lng' => 'required|numeric|between:-180,180',
]);
$key = "courier_location:{$order->courier_id}";
Redis::setex($key, 60, json_encode([
'lat' => $data['lat'],
'lng' => $data['lng'],
'order_id' => $order->id,
'ts' => now()->timestamp,
]));
broadcast(new CourierLocationUpdated(
orderId: $order->id,
lat: $data['lat'],
lng: $data['lng'],
eta: $this->calculateEta($order, $data['lat'], $data['lng']),
));
return response()->json(['ok' => true]);
}
private function calculateEta(DeliveryOrder $order, float $lat, float $lng): ?int
{
$distanceKm = $this->haversineKm($lat, $lng, $order->address_lat, $order->address_lng);
return (int) round($distanceKm / 30 * 60);
}
}
// CourierLocationUpdated event
class CourierLocationUpdated implements ShouldBroadcast
{
use Dispatchable, InteractsWithSockets, SerializesModels;
public function __construct(
public readonly int $orderId,
public readonly float $lat,
public readonly float $lng,
public readonly ?int $eta,
) {}
public function broadcastOn(): Channel
{
return new PrivateChannel("order.{$this->orderId}");
}
public function broadcastWith(): array
{
return [
'lat' => $this->lat,
'lng' => $this->lng,
'eta' => $this->eta,
];
}
}
Авторизація каналу в routes/channels.php:
Broadcast::channel('order.{orderId}', function (User $user, int $orderId) {
return $user->id === DeliveryOrder::find($orderId)?->user_id;
});
Канал PrivateChannel гарантує, що тільки власник замовлення отримує координати. Це обов'язкова вимога безпеки.
Клієнтська частина: карта та анімація маркера
Використовуємо Mapbox для відображення карти. Альтернатива — Яндекс.Карти, краще для СНД.
import mapboxgl from 'mapbox-gl';
// ... ініціалізація карти
Echo.private(`order.${orderId}`)
.listen('CourierLocationUpdated', ({ lat, lng, eta }) => {
animateMarker(courierMarker, courierMarker.getLngLat().toArray(), [lng, lat]);
if (eta !== null) {
document.getElementById('eta').textContent =
eta < 2 ? 'Кур'єр вже поруч' : `Прибуде через ~${eta} хв`;
}
});
function animateMarker(marker, from, to, duration = 500) {
const start = performance.now();
function step(now) {
const t = Math.min((now - start) / duration, 1);
const ease = t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
const lng = from[0] + (to[0] - from[0]) * ease;
const lat = from[1] + (to[1] - from[1]) * ease;
marker.setLngLat([lng, lat]);
if (t < 1) requestAnimationFrame(step);
}
requestAnimationFrame(step);
}
Порівняння методів розрахунку ETA
| Метод | Точність | Час побудови маршруту | Залежності |
|---|---|---|---|
| По прямій (Haversine) | Низька (ігнорує дороги) | Миттєво | Немає |
| Routing API (OSRM) | Висока (враховує дороги) | 50–200 мс | Зовнішній сервіс |
| Google Directions API | Дуже висока (трафік) | 200–500 мс | API-ключ |
Порівняння підходів до real-time доставки
| Підхід | Затримка оновлень | Навантаження на сервер | Складність реалізації |
|---|---|---|---|
| Polling (HTTP кожні 5 с) | 5 сек в середньому | Висока | Низька |
| WebSocket (постійне з'єднання) | Миттєво | Низька | Середня |
| Server-Sent Events | Миттєво | Низька | Середня |
Як налаштувати Private Channel за 5 кроків
- Встановіть Laravel Reverb або Pusher.
- Налаштуйте broadcasting в config/broadcasting.php.
- Створіть Event, що реалізує ShouldBroadcast.
- Визначте PrivateChannel в routes/channels.php.
- Підпишіться на канал на клієнті через Echo.
Що входить в результат
- Аналітика: інтеграція з мобільним додатком кур'єра, узгодження протоколу.
- Проектування: схема даних, WebSocket-архітектура, авторизація.
- Реалізація: бекенд на Laravel з Redis, broadcast, карта на фронтенді.
- Тестування: навантажувальне тестування WebSocket (1k+ одночасних підключень).
- Документація: опис API, інструкція з деплою.
- Підтримка: гарантія на код, навчання команди.
Терміни орієнтовно
- Базовий трекінг (Redis + broadcast + карта): від 4 до 5 днів.
- Авторизація Private Channel + логіка доступу: від 1 дня.
- ETA-розрахунок по прямій (Haversine): від 0.5 дня.
- ETA через Routing API: від 1 до 2 днів.
- Анімація маркера + згладжування шляху: від 1 дня.
- Push-повідомлення при зміні статусу: від 1 до 2 днів.
- Адміністративна панель диспетчера: від 3 до 4 днів.
Чому варто замовити у нас
Ми реалізували real-time трекінг для 30+ проектів, включаючи великі служби доставки. Гарантуємо стабільну роботу WebSocket-з'єднань при тисячах кур'єрів, дотримання приватності каналів та плавну анімацію без ривків. Замовте оцінку вашого проекту — запропонуємо оптимальне рішення.