Esta seção mostra como deixar o veículo pronto para viagens. É necessário concluir 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 do veículo enviadas ao Fleet Engine e ao back-end. Esses listeners podem
acionar ações no seu app do driver, 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 motorista
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 GMTDVehicleReporterListener
, é possível processar os seguintes eventos:
vehicleReporter:didSucceedVehicleUpdate
Informa ao app Driver que os serviços de back-end receberam a atualização de local e estado do veículo.
vehicleReporter:didFailVehicleUpdate:withError
Informa ao listener que houve uma falha na atualização do veículo. Enquanto o driver tiver as atualizações de local ativadas, a classe
GMTDVehicleReporter
continuará enviando os dados mais recentes para o Fleet Engine.
Os exemplos a seguir mostram como configurar 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
Ouvir atualizações de localização do veículo
O SDK Navigation fornece atualizações de local ao SDK 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 de localização
Para ativar as atualizações de localização, defina locationTrackingEnabled
como true
em
GMTDVehicleReporter
no app do motorista. Em seguida, a classe GMTDVehicleReporter
envia automaticamente atualizações de localização para o Fleet Engine. Depois que os serviços de back-end
do Fleet Engine e do cliente forem correspondentes e atribuirem o veículo a uma viagem, a
classe GMTDVehicleReporter
enviará atualizações de rota automaticamente quando o
GMSNavigator
estiver no modo de navegação, que é quando um destino é definido pelo
setDestinations
.
O SDK do motorista define a rota para corresponder ao caminho de navegação atual do motorista. Para garantir atualizações precisas de localização, defina o ponto de passagem em setDestinations
para corresponder ao destino no Fleet Engine.
O exemplo abaixo mostra como ativar as atualizações de localização:
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 motorista
envia atualizações de viagens e veículos ao Fleet Engine em um intervalo de 10 segundos. É possível
mudar o intervalo de atualização com locationUpdateInterval
para um intervalo mínimo de
cinco ou no máximo 60 segundos. Atualizações mais frequentes podem resultar em solicitações e erros mais lentos.
Definir o estado do veículo como on-line
Depois de ativar as atualizações de localização, defina o estado do veículo como ONLINE
para disponibilizar o veículo para consultas de pesquisa no Fleet Engine.
Os exemplos abaixo 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