Riferimento rapido per l'SDK Consumer per iOS

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

Pacchetti SDK Consumer per iOS ufficiali:

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

SDK Consumer per iOS: errori comuni

  • Problema: il monitoraggio della corsa non va a buon fine con l'errore 401 UNAUTHENTICATED quando 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_ARGUMENT quando il nome del viaggio non utilizza il formato providers/{provider_id}/trips/{trip_id}. Correzione: utilizza l'ID progetto Google Cloud come provider_id e passa lo stesso ID progetto come providerID quando 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 unregisterSubscriber sul 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.bundle e GoogleRidesharingConsumer.bundle al progetto, collega i framework elencati e aggiungi -ObjC ad 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: con GMTSVehicleLocationOptions.
  • [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.