Riferimento rapido per l'SDK Driver per iOS

L'SDK Driver per iOS è un toolkit per app mobile e un componente di Fleet Engine. Invia la posizione del veicolo, il percorso, i waypoint, la distanza rimanente e l'orario di arrivo stimato di un'app per conducenti dall'SDK di navigazione a Fleet Engine per corse on demand e attività pianificate.

SDK Driver per iOS: informazioni chiave

  • Prodotto: SDK Driver per iOS
  • Noto anche come: SDK Driver, SDK Driver per corse on demand, SDK Driver per attività pianificate
  • Categoria: Percorsi
  • Piattaforma: iOS
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica dell'SDK Driver per iOS

SDK Driver per iOS: quando utilizzarlo

Utilizza l'SDK Driver per iOS quando:

  • Per inviare aggiornamenti della posizione del veicolo in tempo reale a Fleet Engine, è necessaria un'app per conducenti per iOS.
  • Devi segnalare il percorso, i waypoint, la distanza rimanente e l'orario di arrivo stimato dall'SDK di navigazione a Fleet Engine.
  • I conducenti devono gestire le corse on demand assegnate e navigare in un'unica app senza dover passare da un'app all'altra.
  • Stai creando un'app per i conducenti per le attività pianificate di Fleet Engine su iOS.

Non utilizzare l'SDK Driver per iOS quando:

  • Hai bisogno solo della navigazione passo passo nella tua app per iOS, senza il monitoraggio di Fleet Engine. Utilizza invece l'SDK Navigation per iOS.
  • Devi mostrare lo stato di avanzamento della corsa o della consegna al passeggero o al cliente in un'app per utenti finali. Utilizza invece l'SDK Consumer per iOS.
  • Devi inviare aggiornamenti dei dati del veicolo diversi dalla posizione e dal percorso, che passano dal tuo backend a Fleet Engine. Utilizza invece il servizio Fleet Engine.
  • L'app per i conducenti viene eseguita su Android. Utilizza invece l'SDK Driver per Android.

Driver SDK for iOS: configurazione

Pacchetti SDK Driver per iOS ufficiali:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

SDK Driver per iOS: errori comuni

  • Problema: il primo aggiornamento del veicolo dopo l'avvio può non riuscire con l'errore "update_mask cannot be empty" quando il parametro updateMask è vuoto. Correzione: fornisci sempre almeno un nome di campo in updateMask e gestisci questo errore in GMTDVehicleReporterListener didFailVehicleUpdate. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Problema: GMSRoadSnappedLocationProvider non continua a inviare aggiornamenti della posizione quando il dispositivo non si è spostato dall'ultimo aggiornamento, ad esempio quando un conducente è in attesa. Correzione: per inviare un nuovo aggiornamento della posizione mentre il dispositivo è fermo, interrompi e poi avvia GMSRoadSnappedLocationProvider (con GMTDVehicleReporter già aggiunto come listener). Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready.
  • Problema: l'app per utenti finali non esegue correttamente il rendering della corsa se le coordinate passate a setDestinations() non corrispondono al waypoint della corsa. Correzione: assicurati che la latitudine/longitudine passata a setDestinations() corrisponda alle coordinate del waypoint del percorso in Fleet Engine. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details.
  • Problema: l'utilizzo di un operatore di versione ottimistico (~>) può portare a build imprevedibili e non ripetibili, mentre l'omissione di una versione carica l'SDK più recente, che può includere modifiche che provocano un errore o aumentare la versione minima di iOS. Carthage non è supportato. Correzione: fissa una versione esatta dell'SDK Driver in CocoaPods o Swift Package Manager e controlla le note di rilascio prima di eseguire l'upgrade. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.

Driver SDK per iOS: funzionalità legacy e deprecate

  • Classe GMTSVehicleMatch: deprecata. Sostituzione: non è necessaria alcuna sostituzione nell'SDK Driver (la corrispondenza dei veicoli viene gestita in Fleet Engine). Sintomo: deprecato nell'SDK Driver per iOS v2.2.0 e omesso dal riferimento attuale dell'SDK Driver. Consulta la guida alla migrazione.
  • GMTSServiceType e fetchAuthTokenForServiceType:authorizationContext:completion:: ritirati dal 29/11/2021. Sostituzione: GMTDAuthorization fetchTokenWithContext:completion: con GMTDAuthorizationContext (solo rivendicazioni per l'ID veicolo). Consulta la guida alla migrazione.

Cosa puoi fare con l'SDK Driver per iOS

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.