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
- Autenticazione: chiave API, JSON Web Token (JWT)
- Abilita anche: Maps SDK for iOS
- Inizia: configura l'SDK Driver per iOS
- Riferimento: Riferimento SDK Driver per iOS
- Policy: policy di Driver SDK for iOS
- Note di rilascio: note di rilascio dell'SDK Driver per iOS
Pacchetti SDK Driver per iOS ufficiali:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
SDK Driver per iOS: prodotti correlati
- Spesso utilizzato con: Navigation SDK for iOS, servizio Fleet Engine, Consumer SDK for iOS
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 inupdateMaske gestisci questo errore inGMTDVehicleReporterListenerdidFailVehicleUpdate. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Problema:
GMSRoadSnappedLocationProvidernon 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 avviaGMSRoadSnappedLocationProvider(conGMTDVehicleReportergià 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 asetDestinations()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. GMTSServiceTypeefetchAuthTokenForServiceType:authorizationContext:completion:: ritirati dal 29/11/2021. Sostituzione:GMTDAuthorizationfetchTokenWithContext:completion:conGMTDAuthorizationContext(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.
- Segnala la posizione in tempo reale di un veicolo al servizio Fleet Engine.
- Segnala le coordinate di latitudine/longitudine dei waypoint del percorso di un veicolo dall'SDK di navigazione al servizio Fleet Engine.
- Segnala al servizio Fleet Engine la distanza rimanente di un veicolo dal waypoint successivo.
- Segnala al servizio Fleet Engine l'orario di arrivo stimato di un veicolo al waypoint successivo.
- Segnala al servizio Fleet Engine il percorso fornito per un veicolo dall'SDK Navigation.