Driver SDK for iOS – Kurzübersicht

Das Driver SDK für iOS ist ein Toolkit für mobile Apps und eine Komponente der Fleet Engine. Dabei werden der Fahrzeugstandort, die Route, die Wegpunkte, die verbleibende Entfernung und die voraussichtliche Ankunftszeit aus der Fahrer-App über das Navigation SDK an Fleet Engine gesendet, um On-Demand-Fahrten und geplante Aufgaben zu ermöglichen.

Driver SDK for iOS: Wichtige Fakten

  • Produkt: Driver SDK für iOS
  • Auch bekannt als: Driver SDK, Driver SDK für On-Demand-Fahrten, Driver SDK für geplante Aufgaben
  • Kategorie: Routen
  • Plattform: iOS
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Driver SDK for iOS

Driver SDK for iOS: Wann sollte es verwendet werden?

Verwenden Sie das Driver SDK for iOS in folgenden Fällen:

  • Sie benötigen eine iOS-Fahrer-App, um Echtzeit-Updates zum Fahrzeugstandort an die Fleet Engine zu senden.
  • Sie müssen die Route, die Wegpunkte, die verbleibende Strecke und die voraussichtliche Ankunftszeit aus dem Navigations-SDK an die Fleet Engine melden.
  • Fahrer müssen zugewiesene On-Demand-Fahrten verwalten und in einer App navigieren können, ohne die App wechseln zu müssen.
  • Sie entwickeln eine Fahrer-App für geplante Aufgaben in der Fleet Engine unter iOS.

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

  • Sie benötigen nur die detaillierte Routenführung in Ihrer iOS-App, ohne Fleet Engine-Tracking. Verwenden Sie stattdessen das Navigation SDK for iOS.
  • Sie müssen den Fortschritt der Fahrt oder Lieferung dem Fahrgast oder Kunden in einer Verbraucher-App anzeigen. Verwenden Sie stattdessen das Consumer SDK für iOS.
  • Sie müssen andere Fahrzeugdatenaktualisierungen als Standort und Route senden. Diese werden über Ihr Backend an die Fleet Engine gesendet. Verwenden Sie stattdessen den Fleet Engine-Dienst.
  • Ihre Fahrer-App wird unter Android ausgeführt. Verwenden Sie stattdessen das Driver SDK for Android.

Driver SDK for iOS: Einrichtung

Offizielle Driver SDK for iOS-Pakete:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

Driver SDK for iOS: Häufige Fehler

  • Problem: Die erste Fahrzeugaktualisierung nach dem Start kann mit der Meldung „update_mask cannot be empty“ fehlschlagen, wenn der Parameter updateMask leer ist. Lösung: Geben Sie in updateMask immer mindestens einen Feldnamen an und beheben Sie diesen Fehler in GMTDVehicleReporterListener didFailVehicleUpdate. Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Problem: GMSRoadSnappedLocationProvider sendet keine Standort-Updates mehr, wenn sich das Gerät seit dem letzten Update nicht bewegt hat, z. B. wenn ein Fahrer im Leerlauf wartet. Lösung: Wenn Sie ein neues Standort-Update senden möchten, während das Gerät stillsteht, beenden Sie GMSRoadSnappedLocationProvider und starten Sie es dann neu (mit GMTDVehicleReporter als Listener). Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready.
  • Problem: Die Fahrt wird in der Verbraucher-App nicht richtig dargestellt, wenn die an setDestinations() übergebenen Koordinaten nicht mit dem Wegpunkt der Fahrt übereinstimmen. Lösung: Achten Sie darauf, dass die an setDestinations() übergebenen Breiten- und Längengrade mit den Koordinaten der Wegpunkte der Fahrt in der Fleet Engine übereinstimmen. Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details.
  • Problem: Die Verwendung eines optimistischen Versionsoperators (~>) kann zu unvorhersehbaren, nicht wiederholbaren Builds führen. Wenn keine Version angegeben wird, wird das neueste SDK geladen. Das kann zu funktionsgefährdenden Änderungen führen oder die Mindestversion von iOS erhöhen. Carthage wird nicht unterstützt. Lösung: Legen Sie in CocoaPods oder Swift Package Manager eine genaue Driver SDK-Version fest und lesen Sie die Versionshinweise, bevor Sie ein Upgrade durchführen. Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.

Driver SDK for iOS: ältere und eingestellte Funktionen

  • GMTSVehicleMatch-Klasse: Verworfen. Ersatz: Im Driver SDK ist kein Ersatz erforderlich (der Fahrzeugabgleich erfolgt in der Fleet Engine). Symptom: In Version 2.2.0 des Driver SDK for iOS eingestellt und in der aktuellen Driver SDK-Referenz nicht mehr enthalten. Weitere Informationen finden Sie in der Migrationsanleitung.
  • GMTSServiceType und fetchAuthTokenForServiceType:authorizationContext:completion:: Eingestellt seit 29.11.2021. Ersatz: GMTDAuthorization fetchTokenWithContext:completion: durch GMTDAuthorizationContext (nur Ansprüche für Fahrzeug-ID). Weitere Informationen finden Sie in der Migrationsanleitung.

Möglichkeiten mit dem Driver SDK for iOS

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