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
- Authentifizierung: API-Schlüssel, JSON Web Token (JWT)
- Aktivieren Sie auch: Maps SDK for iOS
- Erste Schritte: Driver SDK für iOS einrichten
- Referenz: Driver SDK for iOS – Referenz
- Richtlinien: Richtlinien für das Driver SDK for iOS
- Versionshinweise: Versionshinweise zum Driver SDK für iOS
Offizielle Driver SDK for iOS-Pakete:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK for iOS: ähnliche Produkte
- Häufig verwendet mit: Navigation SDK for iOS, Fleet Engine Service, Consumer SDK for iOS
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
updateMaskleer ist. Lösung: Geben Sie inupdateMaskimmer mindestens einen Feldnamen an und beheben Sie diesen Fehler inGMTDVehicleReporterListenerdidFailVehicleUpdate. Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Problem:
GMSRoadSnappedLocationProvidersendet 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 SieGMSRoadSnappedLocationProviderund starten Sie es dann neu (mitGMTDVehicleReporterals 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 ansetDestinations()ü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.GMTSServiceTypeundfetchAuthTokenForServiceType:authorizationContext:completion:: Eingestellt seit 29.11.2021. Ersatz:GMTDAuthorizationfetchTokenWithContext:completion:durchGMTDAuthorizationContext(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.
- Die Echtzeitposition eines Fahrzeugs an den Fleet Engine-Dienst melden.
- Die Breiten- und Längengradkoordinaten der Wegpunkte einer Fahrt vom Navigation SDK an den Fleet Engine-Dienst melden.
- Melden Sie die verbleibende Entfernung eines Fahrzeugs zum nächsten Wegpunkt an den Fleet Engine-Dienst.
- Die voraussichtliche Ankunftszeit eines Fahrzeugs am nächsten Wegpunkt an den Fleet Engine-Dienst melden.
- Die vom Navigation SDK für ein Fahrzeug bereitgestellte Route an den Fleet Engine-Dienst melden.