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.
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