Przygotuj pojazd

W tej sekcji dowiesz się, jak przygotować pojazd do podróży. Aby Twój backend mógł dopasować pojazd do podróży, musisz wykonać wszystkie poniższe czynności.

Skonfiguruj detektory

Po zainicjowaniu pakietu Driver SDK i utworzeniu instancji GMTDRidesharingDriverAPI możesz skonfigurować detektory zdarzeń, aby monitorować powodzenie lub niepowodzeniem aktualizacji pojazdów wysyłanych do Fleet Engine i backendu. Te odbiorcy mogą wywoływać działania w aplikacji kierowcy, np. powiadamiać kierowcę, jeśli komunikacja z serwerem zawodzi.

Nasłuchuj zdarzeń dotyczących aktualizacji pojazdu

Gdy kierowca włączy aktualizacje lokalizacji w aplikacji, pakiet Driver SDK będzie regularnie wysyłać aktualizacje pojazdu do Fleet Engine i do backendu klienta za pomocą klasy GMTDVehicleReporter. Aby aplikacja reagowała na zdarzenia aktualizacji, skonfiguruj protokół GMTDVehicleReporterListener.

GMTDVehicleReporterListener umożliwia obsługę tych zdarzeń:

• vehicleReporter:didSucceedVehicleUpdate

  Informuje aplikację Kierowca, że usługi backendowe otrzymały zaktualizowane informacje o lokalizacji i stanie pojazdu.

• vehicleReporter:didFailVehicleUpdate:withError

  Informują detektora o niepowodzeniu aktualizacji pojazdu. Jeśli sterownik ma włączone aktualizacje lokalizacji, klasa GMTDVehicleReporter nadal wysyła najnowsze dane do Fleet Engine.

Poniższe przykłady pokazują, jak skonfigurować GMTDVehicleReporterListener do obsługi tych zdarzeń:

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.
    ridesharingDriverAPI.vehicleReporter.add(self)
  }

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

  func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, 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 have implemented the sample code up to this step.
  [ridesharingDriverAPI.vehicleReporter addListener:self];
}

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

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

@end

Nasłuchiwanie aktualizacji lokalizacji pojazdu

Pakiet SDK Nawigacji przekazuje pakiety Driver SDK informacje o lokalizacji za pomocą klasy GMSRoadSnappedLocationProvider. Aby je otrzymywać, musisz skonfigurować GMTDVehicleReporter jako detektor.

Uwaga: jeśli urządzenie nie zostało przeniesione po ostatniej aktualizacji lokalizacji, klasa GMSRoadSnappedLocationProvider nie wysyła powiadomień o lokalizacji w sposób ciągły, aby zwiększyć wydajność. Na przykład gdy kierowca czeka w samochodzie bezczynnie. Jeśli chcesz wysłać nową aktualizację lokalizacji i ustawić GMTDVehicleReporter jako detektor po wywołaniu funkcji startUpdatingLocation w GMSRoadSnappedLocationProvider, musisz zatrzymać i uruchomić GMSRoadSnappedLocationProvider.

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.
    if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
      roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
      roadSnappedLocationProvider.startUpdatingLocation()
    }
  }
}

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 have implemented the sample code up to this step.
  [_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
  [_mapView.roadSnappedLocationProvider startUpdatingLocation];
}

@end

Włącz aktualizacje lokalizacji

Aby włączyć aktualizacje lokalizacji, ustaw locationTrackingEnabled na true w GMTDVehicleReporter w aplikacji kierowcy. Następnie klasa GMTDVehicleReporter automatycznie wysyła aktualizacje lokalizacji do Fleet Engine. Gdy silnik floty i usługi backendowe klienta dopasują i przypiszą pojazd do przejazdu, klasa GMTDVehicleReporter automatycznie wysyła aktualizacje trasy, gdy GMSNavigator jest w trybie nawigacji, czyli gdy miejsce docelowe jest ustawiane za pomocą setDestinations.

Pakiet Driver SDK ustawia trasę tak, aby pasowała do bieżącej ścieżki nawigacji kierowcy. Aby aktualizacje lokalizacji były dokładne, ustaw punkt pośredni w setDestinations tak, aby pasował do miejsca docelowego we Fleet Engine.

Ten przykład pokazuje, jak włączyć aktualizacje lokalizacji:

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.
    ridesharingDriverAPI.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.
  ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}

@end

Ustawianie interwału aktualizacji

Domyślnie, gdy ustawisz locationTrackingEnabled na true, pakiet SDK Kierowcy wysyła do Fleet Engine aktualizacje dotyczące przejazdu i pojazdu co 10 sekund. Możesz zmienić interwał aktualizacji za pomocą locationUpdateInterval na minimalny interwał aktualizacji 5 sekund lub maksymalnie 60 sekund. Częstsze aktualizacje mogą powodować wolniejsze żądania i błędy.

Ustaw stan pojazdu na „online”

Po włączeniu aktualizacji lokalizacji ustaw stan pojazdu na ONLINE, aby pojazd był dostępny dla zapytań wyszukiwania we Fleet Engine.

W przykładach poniżej pokazujemy, jak ustawić stan pojazdu na ONLINE. Więcej informacji znajdziesz w sekcji updateVehicleState.

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.
    ridesharingDriverAPI.vehicleReporter.update(.online)
  }
}

Objective-C

#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.
  [ridesharingDriverAPI.vehicleReporter
                                   updateVehicleState:GMTDVehicleStateOnline];
}

@end

Co dalej?

Ustawianie szczegółów podróży