Préparer le véhicule

Configurer des écouteurs

Après avoir initialisé le Driver SDK et créé une instance GMTDDeliveryDriverAPI, vous pouvez configurer des écouteurs d'événements pour surveiller la réussite ou l'échec des mises à jour de véhicules envoyées à Fleet Engine et à votre backend. Ces écouteurs peuvent déclencher des actions dans votre application de chauffeur, par exemple en informant le chauffeur si la communication avec votre backend échoue.

Écouter les événements de mise à jour du véhicule

Lorsque le conducteur active les mises à jour de position dans l'application chauffeur, le Driver SDK envoie régulièrement des informations sur le véhicule à Fleet Engine et au backend client via la classe GMTDDeliveryVehicleReporter. Vous pouvez faire en sorte que l'application réponde aux événements de mise à jour en configurant le protocole GMTDVehicleReporterListener.

Avec GMTDVehicleReporterListener, vous pouvez gérer les événements suivants :

• vehicleReporter:didSucceedVehicleUpdate

  Indique à l'application Driver que les services de backend ont bien reçu la mise à jour de l'état et de la position du véhicule.

• vehicleReporter:didFailVehicleUpdate:withError

  Informe l'utilisateur qu'une mise à jour du véhicule a échoué. Tant que les mises à jour de la position sont activées pour le chauffeur, la classe GMTDDeliveryVehicleReporter continue d'envoyer les dernières données à Fleet Engine.

L'exemple suivant montre comment configurer GMTDVehicleReporterListener pour gérer ces événements :

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    deliveryDriverAPI.vehicleReporter.add(self)
  }

  func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
    // Handle update succeeded.
  }

  func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
    // Handle update failed.
  }
}

Objective-C

SampleViewController.h
@interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
@end

SampleViewController.m
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
 GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // ASSUMES YOU IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
  [delivervehicleReporter addListener:self];
}

- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
  // Handle update succeeded.
}

- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
  // Handle update failed.
}

@end

Activer les mises à jour de la position

Pour activer les mises à jour de la position, dans l'application chauffeur sur GMTDDeliveryVehicleReporter, définissez locationTrackingEnabled sur YES. La classe GMTDDeliveryVehicleReporter envoie ensuite automatiquement les mises à jour de position à Fleet Engine. De plus, lorsque GMSNavigator est en mode navigation (c'est-à-dire lorsqu'une destination est définie via setDestinations), la classe GMTDDeliveryVehicleReporter envoie automatiquement des informations sur l'itinéraire et l'heure d'arrivée prévue.

Le Driver SDK définit l'itinéraire pour qu'il corresponde au trajet de navigation actuel du conducteur. Pour vous assurer que les informations de localisation sont précises, définissez le point de cheminement dans -setDestinations:callback: pour qu'il corresponde à la destination dans Fleet Engine.

L'exemple suivant montre comment activer les mises à jour de la position :

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = true
  }
}

Objective-C

SampleViewController.m
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
 GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // ASSUMES YOU HAVE IMPLEMENTED THE SAMPLE CODE UP TO THIS STEP.
  deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}

@end

Remarque : Si l'appareil n'a pas bougé depuis la dernière mise à jour de la position, la classe GMSRoadSnappedLocationProvider n'envoie pas de mises à jour de la position en continu. Par exemple, si un conducteur est à l'arrêt dans la voiture. Si vous souhaitez envoyer une nouvelle mise à jour de la position et que vous avez défini GMTDDeliveryVehicleReporter comme écouteur après avoir appelé startUpdatingLocation sur GMSRoadSnappedLocationProvider, vous devez arrêter et démarrer GMSRoadSnappedLocationProvider.

(Facultatif) Définir l'intervalle de mise à jour

Par défaut, lorsque vous définissez locationTrackingEnabled sur YES, le Driver SDK envoie des mises à jour de localisation à Fleet Engine toutes les 10 secondes. Vous pouvez modifier l'intervalle de mise à jour avec locationUpdateInterval pour définir un intervalle de mise à jour minimal de 5 secondes ou maximal de 60 secondes. Des mises à jour plus fréquentes peuvent entraîner des requêtes plus lentes et des erreurs.