L'SDK Consumer per iOS consente alle app per utenti finali iOS di seguire i percorsi on demand in Fleet Engine. Le sue classi, come GMTCTripModel e GMTCJourneySharingSession, modellano i dati della corsa e mostrano la posizione, il percorso, l'orario di arrivo stimato e la distanza rimanente del veicolo su una mappa.
SDK Consumer per iOS: informazioni chiave
- Prodotto: Consumer SDK for iOS
- Noto anche come: SDK Consumer per iOS
- 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 Consumer per iOS
SDK Consumer per iOS: quando utilizzarlo
Utilizza l'SDK Consumer per iOS quando:
- Devi avere un'app per iOS in cui i consumatori seguono un percorso di consegna o una corsa on demand monitorati da Fleet Engine.
- Devi mostrare la posizione quasi in tempo reale, il percorso e il traffico in tempo reale di un veicolo su una mappa in un'app per utenti finali iOS.
- Devi mostrare l'orario di arrivo previsto per il ritiro e la consegna e la distanza rimanente per una corsa on demand in iOS.
- Utilizzi già Fleet Engine e l'SDK Driver per le corse on demand e hai bisogno del lato consumer della condivisione del percorso.
Non utilizzare l'SDK Consumer per iOS quando:
- Devi fare in modo che i consumatori seguano le attività o le spedizioni programmate; l'esperienza del consumatore per le attività programmate è documentata per JavaScript. Utilizza invece l'SDK consumer JavaScript.
- Devi condividere l'avanzamento della corsa on demand in un'app per utenti finali Android. Utilizza invece l'SDK Consumer per Android.
- Devi condividere l'avanzamento della corsa on demand in un'app web. Utilizza invece l'SDK Consumer JavaScript.
- Devi inviare la posizione del conducente e lo stato della corsa dall'app per iOS del conducente a Fleet Engine. Utilizza invece l'SDK Driver per iOS.
SDK Consumer per iOS: configurazione
- Autenticazione: JSON Web Token (JWT)
- Abilita anche: Servizio Fleet Engine
- Inizia: configura l'SDK Consumer per iOS
- Riferimento: Riferimento SDK Consumer per iOS
- Norme: norme relative all'SDK Consumer per iOS
- Note di rilascio: note di rilascio dell'SDK Consumer per iOS
Pacchetti SDK Consumer per iOS ufficiali:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
SDK Consumer per iOS: prodotti correlati
- Spesso utilizzato con: servizio Fleet Engine, SDK Driver per iOS, SDK Driver per Android, Maps SDK for iOS
SDK Consumer per iOS: errori comuni
- Problema: il monitoraggio della corsa non va a buon fine con l'errore 401
UNAUTHENTICATEDquando il JWT viene firmato senza un ID corsa o è scaduto. Correzione: chiedi al tuo provider di token (GMTCAuthorization) di restituire un JWT emesso per l'ID corsa nel contesto di autorizzazione, memorizzalo nella cache per corsa e aggiornalo alla scadenza. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk. - Problema: Il monitoraggio del viaggio fallisce con 400
INVALID_ARGUMENTquando il nome del viaggio non utilizza il formatoproviders/{provider_id}/trips/{trip_id}. Correzione: utilizza l'ID progetto Google Cloud comeprovider_ide passa lo stesso ID progetto comeproviderIDquando inizializzi l'SDK. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk. - Problema: l'app continua ad ascoltare gli aggiornamenti dopo che un percorso è stato completato o annullato. Correzione: chiama
unregisterSubscribersul modello di percorso quando il percorso viene completato o annullato. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey. - Problema: le installazioni manuali di XCFramework omettono i bundle di risorse e le impostazioni di build richiesti, a meno che non li aggiungi in Xcode. Soluzione: utilizza CocoaPods dove possibile. Per le installazioni manuali, aggiungi
gRPCCertificates.bundleeGoogleRidesharingConsumer.bundleal progetto, collega i framework elencati e aggiungi-ObjCad Altri flag del linker per il debug e il rilascio. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.
SDK Consumer per iOS: funzionalità legacy e deprecate
- Inizializzatore
GMTSVehicleLocation-initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: deprecato dal 1° giugno 2025. Sostituzione:GMTSVehicleLocation-initWithOptions:conGMTSVehicleLocationOptions. [GMTCMapView initWithCoder]: ritirato dal 1° dicembre 2023. Sostituzione:GMTCMapView-initWithOptions:.
Cosa puoi fare con l'SDK Consumer per iOS
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Aggiungi una mappa interattiva e personalizzabile che monitora l'avanzamento di un percorso da Fleet Engine a un'app mobile.
- Aggiungi una polilinea del percorso che monitora un percorso da Fleet Engine a una mappa su una pagina web o un'app mobile.
- Aggiorna l'avanzamento della corsa lungo un percorso in una mappa su una pagina web o un'app mobile per una corsa di Fleet Engine.
- Modifica lo stile di strade, polilinee e poligoni su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Mostra o nascondi gli elementi della mappa su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Modifica lo stile delle icone e delle etichette di testo su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Applica stili di mappa diversi a livelli di zoom diversi su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Modifica la densità dei luoghi su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre il controllo della densità dei PDI è una funzionalità sperimentale della personalizzazione delle mappe basata su cloud (supportata solo negli stili di mappa chiari).
- Modifica lo stile degli edifici su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre la personalizzazione dello stile degli edifici in 3D e con impronta è una funzionalità di personalizzazione delle mappe basata su cloud sperimentale (supportata solo negli stili di mappa chiari).
- Modifica lo stile dei punti di riferimento su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre la personalizzazione delle icone dei punti di riferimento è una funzionalità di personalizzazione delle mappe basata su cloud sperimentale (supportata solo negli stili di mappa chiari).
- Personalizza un indicatore su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Personalizza la polilinea del percorso su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.