Nesta seção, mostramos como preparar o veículo para viagens. Conclua cada uma das etapas a seguir antes que o back-end possa associar um veículo a uma viagem.
Configurar listeners
Depois de inicializar o SDK do Driver e criar uma instância de GMTDRidesharingDriverAPI, configure listeners de eventos para monitorar o sucesso ou a falha das atualizações de veículos enviadas ao Fleet Engine e ao seu back-end. Esses listeners podem
acionar ações no app de motorista, como notificar o motorista se
a comunicação com o back-end falhar.
Detectar eventos de atualização do veículo
Quando o motorista ativa as atualizações de local no app, o SDK do Driver
envia atualizações regulares do veículo para o Fleet Engine e o back-end do cliente
pela classe GMTDVehicleReporter. É possível fazer com que o app responda
a eventos de atualização configurando o protocolo GMTDVehicleReporterListener.
Com o GMTDVehicleReporterListener, é possível processar os seguintes eventos:
vehicleReporter:didSucceedVehicleUpdateInforma ao app do motorista que os serviços de back-end receberam a atualização de localização e estado do veículo.
vehicleReporter:didFailVehicleUpdate:withErrorInforma ao listener que uma atualização de veículo falhou. Enquanto o motorista tiver as atualizações de local ativadas, a classe
GMTDVehicleReportervai continuar enviando os dados mais recentes para o Fleet Engine.
Os exemplos a seguir mostram como configurar o GMTDVehicleReporterListener para
processar esses eventos:
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
Detectar atualizações de localização do veículo
O SDK de navegação fornece atualizações de local ao SDK do Driver pela classe GMSRoadSnappedLocationProvider. Para receber essas atualizações, configure
o GMTDVehicleReporter como um listener.
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
Ativar atualizações do local
Para ativar as atualizações de local, defina locationTrackingEnabled como true em
GMTDVehicleReporter no app do motorista. Em seguida, a classe GMTDVehicleReporter
envia automaticamente as atualizações de local para o Fleet Engine. Depois que o Fleet Engine e os serviços de back-end do cliente correspondem e atribuem o veículo a uma viagem, a classe GMTDVehicleReporter envia atualizações de trajeto automaticamente quando o GMSNavigator está no modo de navegação, que é quando um destino é definido por meio de setDestinations.
O SDK do Driver define o trajeto para corresponder ao caminho de navegação atual do motorista. Para garantir atualizações do local precisas, defina o waypoint em setDestinations para corresponder ao destino no Fleet Engine.
O exemplo a seguir mostra como ativar as atualizações de local:
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
Definir o intervalo de atualização
Por padrão, quando você define locationTrackingEnabled como true, o SDK do Driver
envia atualizações de viagem e veículo para o Fleet Engine em um intervalo de 10 segundos. É possível
mudar o intervalo de atualização com locationUpdateInterval para um intervalo mínimo
de 5 segundos ou máximo de 60 segundos. Atualizações mais frequentes podem
resultar em solicitações mais lentas e erros.
Definir o estado do veículo como on-line
Depois de ativar as atualizações de local, defina o estado do veículo como ONLINE para que ele
fique disponível para consultas de pesquisa no Fleet Engine.
Os exemplos a seguir mostram como definir o estado do veículo como ONLINE. Para
mais detalhes, consulte 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