Quando segui un viaggio, la tua app consumer mostra la posizione del veicolo appropriato per il consumatore. Per farlo, l'app deve essere avviata seguire un viaggio, aggiornarne i progressi e smettere di seguire un percorso quando si verifica vengono completate.
Questo documento illustra il funzionamento di questa procedura.
Inizia a seguire un viaggio
Ecco come iniziare a seguire un viaggio utilizzando la condivisione del percorso:
Raccogliere tutti gli input degli utenti, ad esempio i luoghi di consegna e ritiro da un
ViewController
.Crea un nuovo
ViewController
per iniziare direttamente il percorso di condivisione.
L'esempio seguente mostra come iniziare a condividere un percorso subito dopo il caricamenti di visualizzazioni.
Swift
/*
* MapViewController.swift
*/
override func viewDidLoad() {
super.viewDidLoad()
...
self.mapView = GMTCMapView(frame: UIScreen.main.bounds)
self.mapView.delegate = self
self.view.addSubview(self.mapView)
}
func mapViewDidInitializeCustomerState(_: GMTCMapView) {
self.mapView.pickupLocation = self.selectedPickupLocation
self.mapView.dropoffLocation = self.selectedDropoffLocation
self.startConsumerMatchWithLocations(
pickupLocation: self.mapView.pickupLocation!,
dropoffLocation: self.mapView.dropoffLocation!
) { [weak self] (tripName, error) in
guard let strongSelf = self else { return }
if error != nil {
// print error message.
return
}
let tripService = GMTCServices.shared().tripService
// Create a tripModel instance for listening the update of the trip
// specified by this trip name.
let tripModel = tripService.tripModel(forTripName: tripName)
// Create a journeySharingSession instance based on the tripModel
let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
// Add the journeySharingSession instance on the mapView for UI updating.
strongSelf.mapView.show(journeySharingSession)
// Register for the trip update events.
tripModel.register(strongSelf)
strongSelf.currentTripModel = tripModel
strongSelf.currentJourneySharingSession = journeySharingSession
strongSelf.hideLoadingView()
}
self.showLoadingView()
}
Objective-C
/*
* MapViewController.m
*/
- (void)viewDidLoad {
[super viewDidLoad];
...
self.mapView = [[GMTCMapView alloc] initWithFrame:CGRectZero];
self.mapView.delegate = self;
[self.view addSubview:self.mapView];
}
// Handle the callback when the GMTCMapView did initialized.
- (void)mapViewDidInitializeCustomerState:(GMTCMapView *)mapview {
self.mapView.pickupLocation = self.selectedPickupLocation;
self.mapView.dropoffLocation = self.selectedDropoffLocation;
__weak __typeof(self) weakSelf = self;
[self startTripBookingWithPickupLocation:self.selectedPickupLocation
dropoffLocation:self.selectedDropoffLocation
completion:^(NSString *tripName, NSError *error) {
__typeof(self) strongSelf = weakSelf;
GMTCTripService *tripService = [GMTCServices sharedServices].tripService;
// Create a tripModel instance for listening to updates to the trip specified by this trip name.
GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];
// Create a journeySharingSession instance based on the tripModel.
GMTCJourneySharingSession *journeySharingSession =
[[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
// Add the journeySharingSession instance on the mapView for updating the UI.
[strongSelf.mapView showMapViewSession:journeySharingSession];
// Register for trip update events.
[tripModel registerSubscriber:self];
strongSelf.currentTripModel = tripModel;
strongSelf.currentJourneySharingSession = journeySharingSession;
[strongSelf hideLoadingView];
}];
[self showLoadingView];
}
Smettere di seguire un viaggio
Smetti di seguire un viaggio quando questo viene completato o annullato. Le seguenti l'esempio mostra come interrompere la condivisione della corsa attiva.
Swift
/*
* MapViewController.swift
*/
func cancelCurrentActiveTrip() {
// Stop the tripModel
self.currentTripModel.unregisterSubscriber(self)
// Remove the journey sharing session from the mapView's UI stack.
self.mapView.hide(journeySharingSession)
}
Objective-C
/*
* MapViewController.m
*/
- (void)cancelCurrentActiveTrip {
// Stop the tripModel
[self.currentTripModel unregisterSubscriber:self];
// Remove the journey sharing session from the mapView's UI stack.
[self.mapView hideMapViewSession:journeySharingSession];
}
Aggiorna la tua posizione
Durante un viaggio, puoi gestire la tua posizione come segue:
Inizia ad ascoltare gli aggiornamenti. Per un esempio, vedi Esempio di inizio ad ascoltare gli aggiornamenti.
Gestisci gli aggiornamenti della corsa. Per un esempio, vedi Gestire l'esempio di aggiornamenti della corsa
Quando un percorso viene completato o annullato, interrompi l'ascolto degli aggiornamenti. Per un esempio, vedi Esempio di interruzione dell'ascolto degli aggiornamenti.
Esempio di Inizia ad ascoltare gli aggiornamenti
L'esempio seguente mostra come registrare il callback tripModel
.
Swift
/*
* MapViewController.swift
*/
override func viewDidLoad() {
super.viewDidLoad()
// Register for trip update events.
self.currentTripModel.register(self)
}
Objective-C
/*
* MapViewController.m
*/
- (void)viewDidLoad {
[super viewDidLoad];
// Register for trip update events.
[self.currentTripModel registerSubscriber:self];
...
}
Esempio di interruzione dell'ascolto degli aggiornamenti
L'esempio seguente mostra come annullare la registrazione dell'tripModel
di Google.
Swift
/*
* MapViewController.swift
*/
deinit {
self.currentTripModel.unregisterSubscriber(self)
}
Objective-C
/*
* MapViewController.m
*/
- (void)dealloc {
[self.currentTripModel unregisterSubscriber:self];
...
}
Gestire l'esempio di aggiornamenti della corsa
L'esempio seguente mostra come implementare GMTCTripModelSubscriber
per la gestione dei callback quando lo stato di viaggio viene aggiornato.
Swift
/*
* MapViewController.swift
*/
func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
// Update the UI with the new `trip` data.
self.updateUI(with: trip)
}
func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
// Handle trip status did change.
}
func tripModel(_: GMTCTripModel, didUpdateActiveRouteRemainingDistance activeRouteRemainingDistance: Int32) {
// Handle remaining distance of active route did update.
}
func tripModel(_: GMTCTripModel, didUpdateActiveRoute activeRoute: [GMTSLatLng]?) {
// Handle trip active route did update.
}
func tripModel(_: GMTCTripModel, didUpdate vehicleLocation: GMTSVehicleLocation?) {
// Handle vehicle location did update.
}
func tripModel(_: GMTCTripModel, didUpdatePickupLocation pickupLocation: GMTSTerminalLocation?) {
// Handle pickup location did update.
}
func tripModel(_: GMTCTripModel, didUpdateDropoffLocation dropoffLocation: GMTSTerminalLocation?) {
// Handle drop off location did update.
}
func tripModel(_: GMTCTripModel, didUpdatePickupETA pickupETA: TimeInterval) {
// Handle the pickup ETA did update.
}
func tripModel(_: GMTCTripModel, didUpdateDropoffETA dropoffETA: TimeInterval) {
// Handle the drop off ETA did update.
}
func tripModel(_: GMTCTripModel, didUpdateRemaining remainingWaypoints: [GMTSTripWaypoint]?) {
// Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}
func tripModel(_: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
// Handle the error.
}
func tripModel(_: GMTCTripModel, didUpdateIntermediateDestinations intermediateDestinations: [GMTSTerminalLocation]?) {
// Handle the intermediate destinations being updated.
}
func tripModel(_: GMTCTripModel, didUpdateActiveRouteTraffic activeRouteTraffic: GMTSTrafficData?) {
// Handle trip active route traffic being updated.
}
Objective-C
/*
* MapViewController.m
*/
#pragma mark - GMTCTripModelSubscriber implementation
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateTrip:(nullable GMTSTrip *)trip
updatedPropertyFields:(enum GMTSTripPropertyFields)updatedPropertyFields {
// Update the UI with the new `trip` data.
[self updateUIWithTrip:trip];
...
}
- (void)tripModel:(GMTCTripModel *)tripModel didUpdateTripStatus:(enum GMTSTripStatus)tripStatus {
// Handle trip status did change.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateActiveRouteRemainingDistance:(int32_t)activeRouteRemainingDistance {
// Handle remaining distance of active route did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
// Handle trip active route did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateVehicleLocation:(nullable GMTSVehicleLocation *)vehicleLocation {
// Handle vehicle location did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdatePickupLocation:(nullable GMTSTerminalLocation *)pickupLocation {
// Handle pickup location did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateDropoffLocation:(nullable GMTSTerminalLocation *)dropoffLocation {
// Handle drop off location did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel didUpdatePickupETA:(NSTimeInterval)pickupETA {
// Handle the pickup ETA did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateRemainingWaypoints:(nullable NSArray<GMTSTripWaypoint *> *)remainingWaypoints {
// Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}
- (void)tripModel:(GMTCTripModel *)tripModel didUpdateDropoffETA:(NSTimeInterval)dropoffETA {
// Handle the drop off ETA did update.
}
- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(nullable NSError *)error {
// Handle the error.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateIntermediateDestinations:
(nullable NSArray<GMTSTerminalLocation *> *)intermediateDestinations {
// Handle the intermediate destinations being updated.
}
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateActiveRouteTraffic:(nullable GMTSTrafficData *)activeRouteTraffic {
// Handle trip active route traffic being updated.
}
Gestire gli errori di blocco
Se hai sottoscritto un abbonamento a tripModel
e si verifica un errore, puoi ricevere il callback
di tripModel
implementando il metodo delegato
tripModel(_:didFailUpdateTripWithError:)
. Errore
seguono lo standard di errore di Google Cloud. Per errori dettagliati
le definizioni dei messaggi e tutti i codici di errore, consulta
Documentazione sugli errori di Google Cloud.
Di seguito sono riportati alcuni errori comuni che possono verificarsi durante il monitoraggio delle corse:
HTTP | RPC | Descrizione |
---|---|---|
400 | INVALID_ARGUMENT | Il client ha specificato un nome percorso non valido. Il nome della corsa deve seguire le
formato providers/{provider_id}/trips/{trip_id} . La
provider_id deve essere l'ID del progetto Cloud di proprietà di
il provider di servizi. |
401 | NON AUTENTICATO | Questo errore viene visualizzato se non esistono credenziali di autenticazione valide. Ad esempio, se il token JWT è firmato senza un ID corsa o il token JWT. è scaduto. |
403 | PERMISSION_DENIED | Ricevi questo errore se il client non dispone di autorizzazioni sufficienti (ad esempio, un utente con il ruolo consumer tenta di chiamare updateTrip), se il token JWT non è valido o l'API non è abilitata per il progetto client. Il token JWT potrebbe mancare o essere firmato con un ID corsa che non corrisponde all'ID corsa richiesto. |
429 | RESOURCE_EXHAUSTED | La quota di risorse è pari a zero o la frequenza di traffico supera il limite. |
503 | UNAVAILABLE | Servizio non disponibile. In genere il server non è attivo. |
504 | DEADLINE_EXCEEDED | Scadenza richiesta superata. Questo errore si verifica solo se il chiamante imposta più breve della scadenza predefinita del metodo (ovvero, la scadenza richiesta non è sufficiente per consentire al server di elaborare la richiesta). la richiesta non è stata completata entro la scadenza. |
Gestire gli errori dell'SDK consumer
L'SDK consumer invia errori di aggiornamento della corsa all'app consumer utilizzando un callback
meccanismo di attenzione. Il parametro di callback è un tipo restituito specifico della piattaforma (
TripUpdateError
su Android
NSError
su iOS).
Estrarre i codici di stato
Gli errori passati al callback sono in genere errori gRPC e puoi anche estrarre ulteriori informazioni sotto forma di codice di stato. Per per l'elenco completo dei codici di stato, consulta Codici di stato e loro utilizzo in gRPC.
Swift
Il numero NSError
viene richiamato tra tripModel(_:didFailUpdateTripWithError:)
.
// Called when there is a trip update error.
func tripModel(_ tripModel: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
// Check to see if the error comes from gRPC.
if let error = error as NSError?, error.domain == "io.grpc" {
let gRPCErrorCode = error.code
...
}
}
Objective-C
Il numero NSError
viene richiamato tra tripModel:didFailUpdateTripWithError:
.
// Called when there is a trip update error.
- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(NSError *)error {
// Check to see if the error comes from gRPC.
if ([error.domain isEqualToString:@"io.grpc"]) {
NSInteger gRPCErrorCode = error.code;
...
}
}
Interpretare i codici di stato
I codici di stato coprono due tipi di errori: quelli relativi al server e alla rete, mentre lato client.
Errori del server e della rete
I seguenti codici di stato riguardano errori di rete o del server e non occorre fare nulla per risolverli. L'SDK consumer viene li recupera.
Codice di stato | Descrizione |
---|---|
INTERROTTO | Il server ha smesso di inviare la risposta. Questo è causato di solito da un problema con il server. |
CANCELLATO | Il server ha terminato la risposta in uscita. Questa operazione normalmente
si verifica quando
l'app viene inviata in background o quando si verifica un cambiamento di stato App consumer. |
INTERRUPTED | |
DEADLINE_EXCEEDED | Il server ha impiegato troppo tempo per rispondere. |
UNAVAILABLE | Il server non era disponibile. Questo è causato di solito da una rete problema. |
Errori client
I seguenti codici di stato riguardano gli errori del client e devi intervenire per risolverle. L'SDK consumer continua a riprovare ad aggiornare il percorso finché condivisione del percorso, ma non si ripristina finché non intervieni.
Codice di stato | Descrizione |
---|---|
INVALID_ARGUMENT | L'app consumer ha specificato un nome di viaggio non valido. Il nome della corsa deve
sono nel formato providers/{provider_id}/trips/{trip_id} .
|
NOT_FOUND | Il viaggio non è mai stato creato. |
PERMISSION_DENIED | L'app consumer non ha autorizzazioni sufficienti. Questo errore si verifica quando:
|
RESOURCE_EXHAUSTED | La quota di risorse è pari a zero o la velocità del flusso di traffico supera la limite di velocità. |
NON AUTENTICATO | La richiesta non è riuscita a eseguire l'autenticazione a causa di un token JWT non valido. Questo si verifica quando il token JWT è firmato senza un ID trip oppure quando il token JWT è scaduto. |