Configurar listeners
Depois de inicializar o SDK do Driver e criar um GMTDDeliveryDriverAPI
exemplo, você pode configurar listeners de eventos para monitorar o sucesso ou a falha de
atualizações de veículos enviadas ao Fleet Engine e seu back-end. Esses listeners podem
acionar ações no app do motorista, como notificar o motorista se
de comunicação com o back-end.
Detectar eventos de atualização do veículo
Quando o motorista ativa atualizações de localização no app do motorista, o SDK envia
atualizações regulares do veículo para o Fleet Engine e o back-end do cliente pelo
GMTDDeliveryVehicleReporter
. É possível fazer com que o app responda a
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 os atualização de estado e localização do veículo.
vehicleReporter:didFailVehicleUpdate:withError
Informa o listener que houve uma falha na atualização do veículo. Contanto que o motorista tenha atualizações de local ativadas, a classe
GMTDDeliveryVehicleReporter
vai continuar para enviar os dados mais recentes ao Fleet Engine.
O exemplo a seguir mostra como configurar GMTDVehicleReporterListener
para
lidam com estes 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, acesse o app do motorista na
GMTDDeliveryVehicleReporter
, defina locationTrackingEnabled
como
YES
Depois,
A classe GMTDDeliveryVehicleReporter
envia automaticamente atualizações de localização para
Fleet Engine. Além disso, quando o GMSNavigator
está no modo de navegação, que
é quando um destino é definido por setDestinations
, o
A classe GMTDDeliveryVehicleReporter
envia automaticamente atualizações de trajeto e HEC.
O SDK do Driver 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 referência em
-setDestinations:callback:
para fazer a correspondência com o 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 mudar
o intervalo de atualização com locationUpdateInterval
para um intervalo mínimo de atualização
de 5 segundos ou no máximo 60 segundos. Atualizações mais frequentes podem resultar em
solicitações e erros mais lentos.