PubNub Order & Delivery Driver Specialist

When to Use This Skill

• Building a real-time delivery tracking page where customers watch their driver approach on a map
• Implementing GPS location streaming from driver mobile apps with battery-efficient updates
• Designing order status pipelines that transition through placed, confirmed, preparing, dispatched, en-route, and delivered states
• Creating dispatch systems that assign the nearest available driver to incoming orders
• Building fleet management dashboards with live positions and status for all active drivers
• Implementing driver-customer communication channels, ETA updates, and delivery confirmation flows

Core Workflow

1. Design Channel Architecture -- Define the channel naming conventions for order tracking, driver locations, fleet management, and dispatch coordination so each concern is isolated and scalable.
2. Implement Location Streaming -- Set up GPS publishing from driver devices with adaptive frequency, battery optimization, and fallback strategies for poor connectivity.
3. Build Order Status Pipeline -- Create the state machine that governs order transitions, validates each change, and broadcasts updates to all interested subscribers.
4. Configure Dispatch Logic -- Implement driver assignment using proximity calculations, availability checks, and load balancing through PubNub Functions or your backend.
5. Add Customer-Facing Tracking -- Build the tracking page that subscribes to order and driver channels, renders the map, displays ETA, and shows status updates in real time.
6. Handle Edge Cases -- Implement reconnection logic, offline queueing, failed delivery flows, driver reassignment, and proof-of-delivery capture.

Reference Guide

Key Implementation Requirements

GPS Location Publishing

import PubNub from 'pubnub';

const pubnub = new PubNub({
  publishKey: 'pub-key',
  subscribeKey: 'sub-key',
  userId: 'driver-1234'
});

let lastPublishedLocation = null;

function publishDriverLocation(latitude, longitude, heading, speed) {
  const location = {
    lat: latitude,
    lng: longitude,
    heading: heading,
    speed: speed,
    timestamp: Date.now(),
    driverId: 'driver-1234'
  };

  // Adaptive publishing: skip if driver hasn't moved significantly
  if (lastPublishedLocation) {
    const distance = haversineDistance(lastPublishedLocation, location);
    if (distance < 5 && speed < 1) {
      return; // Skip publish if moved less than 5 meters and nearly stationary
    }
  }

  pubnub.publish({
    channel: 'driver.driver-1234.location',
    message: location
  });

  lastPublishedLocation = location;
}

Order Tracking Channels

function subscribeToOrderTracking(orderId, driverId) {
  pubnub.subscribe({
    channels: [
      `order.${orderId}.status`,
      `driver.${driverId}.location`
    ]
  });

  pubnub.addListener({
    message: (event) => {
      if (event.channel.includes('.status')) {
        updateOrderStatusUI(event.message);
      } else if (event.channel.includes('.location')) {
        updateDriverMarkerOnMap(event.message);
        recalculateETA(event.message);
      }
    }
  });
}

Status Updates with Validation

async function updateOrderStatus(orderId, newStatus, metadata = {}) {
  const statusUpdate = {
    orderId: orderId,
    status: newStatus,
    timestamp: Date.now(),
    ...metadata
  };

  await pubnub.publish({
    channel: `order.${orderId}.status`,
    message: statusUpdate
  });

  // Also update the dispatch channel so fleet managers see the change
  await pubnub.publish({
    channel: 'dispatch.status-updates',
    message: statusUpdate
  });
}

// Example transitions
await updateOrderStatus('order-5678', 'dispatched', {
  driverId: 'driver-1234',
  estimatedDelivery: Date.now() + 25 * 60 * 1000
});

Constraints

• Always use separate channels for location data and status updates to avoid mixing high-frequency GPS messages with critical state changes.
• Never expose raw driver GPS coordinates to customers until the driver is within a reasonable proximity of the delivery address.
• Implement message deduplication for status updates since network retries can cause duplicate publishes.
• Cap GPS publishing frequency at no more than once per second to avoid exceeding PubNub message quotas and draining driver device batteries.
• Use PubNub presence to track driver online/offline state rather than relying on periodic heartbeat messages in the data channel.
• Store order status history using PubNub message persistence so customers can view the full timeline even after reconnecting.

Related Skills

• pubnub-presence - Tracking driver online/offline status and availability
• pubnub-functions - PubNub Functions for dispatch logic, geofence triggers, and status validation
• pubnub-security - Access Manager for isolating order channels and protecting driver location data
• pubnub-scale - Channel groups for fleet management dashboards

Output Format

1. Start with the channel naming convention and architecture diagram showing how channels relate to orders, drivers, and customers.
2. Provide complete JavaScript/TypeScript code for both the driver app (publishing) and customer app (subscribing) sides.
3. Include PubNub Functions code for any server-side validation, dispatch logic, or geofence triggers.
4. Add error handling for network failures, reconnection, and offline scenarios with code examples.
5. Finish with a testing checklist covering location accuracy, status transitions, ETA updates, and edge cases like driver reassignment.