Consumer SDK for iOS – Kurzübersicht

Mit dem Consumer SDK für iOS können iOS-Verbraucher-Apps On-Demand-Fahrten in der Fleet Engine verfolgen. Die Klassen wie GMTCTripModel und GMTCJourneySharingSession modellieren Fahrtdaten und zeigen den Standort, die Route, die voraussichtliche Ankunftszeit und die verbleibende Entfernung des Fahrzeugs auf einer Karte an.

Consumer SDK for iOS: Wichtige Fakten

  • Produkt: Consumer SDK for iOS
  • Auch bekannt als: iOS Consumer SDK
  • Kategorie: Routen
  • Plattform: iOS
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Consumer SDK for iOS – Übersicht

Consumer SDK for iOS: Wann sollte es verwendet werden?

Verwenden Sie das Consumer SDK für iOS in folgenden Fällen:

  • Sie benötigen eine iOS-App, mit der Nutzer eine On-Demand-Fahrt oder -Lieferung verfolgen können, die von der Fleet Engine erfasst wird.
  • Sie müssen den Echtzeitstandort, die Route und die aktuelle Verkehrslage eines Fahrzeugs nahezu in Echtzeit auf einer Karte in einer iOS-App für Endnutzer anzeigen.
  • Sie müssen die voraussichtliche Ankunftszeit für die Abholung und das Absetzen sowie die verbleibende Entfernung für eine On-Demand-Fahrt in iOS anzeigen.
  • Sie verwenden bereits die Fleet Engine und das Driver SDK für On-Demand-Fahrten und benötigen die Nutzerseite der Funktion „Fahrt teilen“.

Verwenden Sie das Consumer SDK für iOS nicht, wenn:

  • Sie benötigen Nutzer, die geplante Aufgaben oder Sendungen verfolgen. Die Nutzererfahrung für geplante Aufgaben ist für JavaScript dokumentiert. Verwenden Sie stattdessen das JavaScript Consumer SDK.
  • Sie müssen den Fortschritt einer On-Demand-Fahrt in einer Android-Verbraucher-App teilen. Verwenden Sie stattdessen das Consumer SDK for Android.
  • Sie müssen den Fortschritt einer On-Demand-Fahrt in einer Web-App teilen. Verwenden Sie stattdessen das JavaScript Consumer SDK.
  • Sie müssen den Standort des Fahrers und den Fahrtstatus von der iOS-App des Fahrers an die Fleet Engine senden. Verwenden Sie stattdessen das Driver SDK for iOS.

Consumer SDK for iOS: Einrichtung

Offizielle Consumer SDK for iOS-Pakete:

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

Consumer SDK für iOS: Häufige Fehler

  • Problem: Das Fahrtmonitoring schlägt mit dem Fehler „401 UNAUTHENTICATED“ fehl, wenn das JWT ohne Fahrt-ID signiert wurde oder abgelaufen ist. Lösung: Lassen Sie Ihren Tokenanbieter (GMTCAuthorization) ein JWT zurückgeben, das für die Fahrt-ID im Autorisierungskontext ausgestellt wurde. Speichern Sie es pro Fahrt im Cache und aktualisieren Sie es, wenn es abläuft. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • Problem: Das Fahrtmonitoring schlägt mit dem Fehler „400 INVALID_ARGUMENT“ fehl, wenn der Fahrtname nicht das Format providers/{provider_id}/trips/{trip_id} hat. Lösung: Verwenden Sie die Google Cloud-Projekt-ID als provider_id und übergeben Sie dieselbe Projekt-ID als providerID, wenn Sie das SDK initialisieren. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • Problem: Die App wartet auch nach Abschluss oder Abbruch einer Fahrt auf Updates. Lösung: Rufen Sie unregisterSubscriber im Fahrtmodell auf, wenn die Fahrt abgeschlossen oder abgebrochen wird. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • Problem: Bei manuellen XCFramework-Installationen werden erforderliche Ressourcen-Bundles und Build-Einstellungen weggelassen, sofern Sie sie nicht in Xcode hinzufügen. Lösung: Verwenden Sie nach Möglichkeit CocoaPods. Fügen Sie bei manuellen Installationen gRPCCertificates.bundle und GoogleRidesharingConsumer.bundle zum Projekt hinzu, verknüpfen Sie die aufgeführten Frameworks und fügen Sie -ObjC zu „Other Linker Flags“ für Debug und Release hinzu. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

Consumer SDK for iOS: Legacy- und eingestellte Funktionen

  • GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:-Initialisierer: Eingestellt seit dem 01.06.2025. Ersatz: GMTSVehicleLocation -initWithOptions: durch GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: Verworfen seit 01.12.2023. Ersatz: GMTCMapView -initWithOptions:.

Möglichkeiten mit dem Consumer SDK für iOS

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.