Configurar listeners
Depois de inicializar o SDK do Driver e criar uma instância
GMTDDeliveryDriverAPI
, é possível configurar listeners de eventos para monitorar o sucesso ou a falha das
atualizações do veículo enviadas para o Fleet Engine e seu 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 localização no app, o SDK do motorista envia
atualizações regulares do veículo para o Fleet Engine e o back-end do cliente usando a
classe GMTDDeliveryVehicleReporter
. Para que o app responda a eventos de atualização,
configure 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 o listener que houve uma falha na atualização do veículo. Enquanto o driver tiver as atualizações de local ativadas, a classe
GMTDDeliveryVehicleReporter
vai continuar enviando os dados mais recentes para o Fleet Engine.
O exemplo abaixo mostra 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.
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
Ativar atualizações de localização
Para ativar as atualizações de localização, no app do motorista em
GMTDDeliveryVehicleReporter
, defina locationTrackingEnabled
como
YES
. Em seguida, a
classe GMTDDeliveryVehicleReporter
envia automaticamente atualizações de localização para o
Fleet Engine. Além disso, quando o GMSNavigator
está no modo de navegação, ou seja, quando um destino é definido por setDestinations
, a classe GMTDDeliveryVehicleReporter
envia automaticamente atualizações de rota e ETA.
O SDK do motorista define a rota para corresponder ao caminho de navegação atual do motorista. Para
garantir atualizações de localização precisas, defina o ponto de passagem em
-setDestinations:callback:
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.
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
(Opcional) Definir o intervalo de atualização
Por padrão, quando você define locationTrackingEnabled
como YES
, o SDK do driver
envia atualizações de localização ao Fleet Engine em um intervalo de 10 segundos. É possível alterar
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.