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
- Authentifizierung: JSON Web Token (JWT)
- Aktivieren Sie auch: Fleet Engine Service
- Erste Schritte: Consumer SDK für iOS einrichten
- Referenz: Consumer SDK for iOS – Referenz
- Richtlinien: Richtlinien für das Consumer SDK for iOS
- Versionshinweise: Versionshinweise zum Consumer SDK für iOS
Offizielle Consumer SDK for iOS-Pakete:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK for iOS: ähnliche Produkte
- Häufig verwendet mit: Fleet Engine Service, Driver SDK for iOS, Driver SDK for Android, Maps SDK for iOS
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 Formatproviders/{provider_id}/trips/{trip_id}hat. Lösung: Verwenden Sie die Google Cloud-Projekt-ID alsprovider_idund übergeben Sie dieselbe Projekt-ID alsproviderID, 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
unregisterSubscriberim 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.bundleundGoogleRidesharingConsumer.bundlezum Projekt hinzu, verknüpfen Sie die aufgeführten Frameworks und fügen Sie-ObjCzu „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:durchGMTSVehicleLocationOptions.[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.
- Fügen Sie eine anpassbare, interaktive Karte hinzu, auf der der Fortschritt einer Fahrt von Fleet Engine zu einer mobilen App verfolgt wird.
- Fügen Sie eine Polylinie für die Route hinzu, die eine Fahrt von Fleet Engine zu einer Karte auf einer Webseite oder in einer mobilen App verfolgt.
- Aktualisieren Sie den Fortschritt einer Fahrt entlang einer Route auf einer Karte auf einer Webseite oder in einer mobilen App für eine Fleet Engine-Fahrt.
- Stil von Straßen, Polylinien und Polygonen auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird
- Kartenelemente auf einer Karte ein- oder ausblenden, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird.
- Stil von Symbolen und Textlabels auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird
- Sie können verschiedene Kartenstile auf verschiedene Zoomstufen einer Karte anwenden, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird.
- Dichte der Orte auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird Experimentell Hinweis: Die Unterstützung für das cloudbasierte Gestalten von Karteninhalten im Consumer SDK ist allgemein verfügbar, während die Steuerung der POI-Dichte eine experimentelle Funktion des cloudbasierten Gestaltens von Karteninhalten ist (nur bei hellen Kartenstilen unterstützt).
- Gebäudestil auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird Experimentell Hinweis: Die Unterstützung für das cloudbasierte Gestalten von Karteninhalten im Consumer SDK ist allgemein verfügbar. Die Anpassung von 3D- und Grundriss-Gebäudestilen ist jedoch eine experimentelle Funktion des cloudbasierten Gestaltens von Karteninhalten (nur bei hellen Kartenstilen unterstützt).
- Stil der Sehenswürdigkeiten auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird Experimentell Hinweis: Die Unterstützung für das cloudbasierte Gestalten von Karteninhalten im Consumer SDK ist allgemein verfügbar. Die Anpassung von Sehenswürdigkeitssymbolen ist eine experimentelle Funktion des cloudbasierten Gestaltens von Karteninhalten (nur bei hellen Kartenstilen unterstützt).
- Markierung auf einer Karte anpassen, auf der der Fortschritt einer Fahrt aus der Fleet Engine verfolgt wird
- Polylinie der Route auf einer Karte anpassen, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird