Erste Schritte mit dem Treiber-SDK für iOS

Sie können das Driver SDK verwenden, um die Navigation und das Tracking auf Ihrem Computer zu verbessern. App „Fahrt & Bestellfortschritt“. Das Driver SDK stellt Updates zu Standorten und Aufgaben der On-demand Rides and Deliveries-Lösungsflotte.

Das Driver SDK informiert die Fleet Engine-Dienste und Ihre benutzerdefinierten Dienste Standort und Zustand des Fahrzeugs. z. B. ONLINE oder OFFLINE und der Fahrzeugstandort ändert sich im Laufe der Fahrt.

Mindestsystemanforderungen

  • Auf dem Mobilgerät muss iOS 14 oder höher installiert sein.
  • Xcode Version 15 oder höher.
  • Vorbereitung

    In diesem Leitfaden wird davon ausgegangen, dass die Navigation in Ihrer App bereits SDK und dass die Flotte Motor Back-End eingerichtet und verfügbar ist. Der Beispielcode enthält jedoch Navigation SDK einrichten.

    Außerdem müssen Sie das Maps SDK for iOS aktivieren. in Ihrem Google Cloud-Projekt und Get an API Schlüssel:

    Projektkonfiguration

    Swift-Paketmanager

    Das Treiber-SDK kann über installiert werden. Swift Package Manager Damit du das SDK hinzufügen kannst, alle vorhandenen Driver SDK-Abhängigkeiten entfernt wurden.

    So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:

    1. Öffne deinen Xcode project oder workspace und klicke auf Datei > Paketabhängigkeiten hinzufügen.
    2. Geben Sie https://github.com/googlemaps/ios-driver-sdk als URL ein und drücken Sie die Eingabetaste. um das Paket zu laden, und klicke auf „Paket hinzufügen“.
    3. Um eine bestimmte version zu installieren, legen Sie das Feld Abhängigkeitsregel auf eine der folgenden Werte fest: zu den versionsbasierten Optionen. Für neue Projekte empfehlen wir, die neueste Version und mit der Spalte „Exakte Version“ Option. Klicke anschließend auf „Paket hinzufügen“.
    4. Prüfe im Fenster Paketprodukte auswählen, ob GoogleRidesharingDriver hinzugefügt wird Ihr festgelegtes Ziel für main. Klicke anschließend auf „Paket hinzufügen“.
    5. Um die Installation zu überprüfen, navigiere zum Bereich General deines Ziels. Die installierten Pakete sollten nun unter Frameworks, Bibliotheken und eingebettete Inhalte zu sehen sein. Sie können auch die „Paketabhängigkeiten“ von Projektnavigator um das Paket und seine Version zu überprüfen.

    So aktualisieren Sie package für ein vorhandenes Projekt:

    1. Wenn Sie ein Upgrade von einer früheren Version als 9.0.0 durchführen,müssen Sie die folgenden Abhängigkeiten: GoogleMapsBase, GoogleMapsCore und GoogleMapsM4B nach dem Upgrade. Entfernen Sie nicht die Abhängigkeit für GoogleMaps Weitere Informationen finden Sie in der Versionshinweise zu Version 9.0.0

      Gehen Sie in den Konfigurationseinstellungen des Xcode-Projekts zu Frameworks, Libraries, und eingebettete Inhalte. Verwenden Sie das Minuszeichen(-), um das folgende Framework zu entfernen:

      • GoogleMapsBase (nur für Upgrades von Versionen vor 9.0.0)
      • GoogleMapsCore (nur für Upgrades von Versionen vor 9.0.0)
      • GoogleMapsM4B (nur für Upgrades von Versionen vor 9.0.0)
    2. Gehen Sie in Xcode zu „File > Pakete > Auf neueste Paketversionen aktualisieren“.
    3. Um die Installation zu überprüfen, gehen Sie in der Projektnavigation zum Abschnitt Paketabhängigkeiten. um das Paket und seine Version zu überprüfen.
    <ph type="x-smartling-placeholder">

    So entfernen Sie vorhandene Driver SDK-Abhängigkeiten, die mithilfe von CocoaPods, gehen Sie so vor:

    1. Schließen Sie den Xcode-Arbeitsbereich. Öffnen Sie das Terminal und führen Sie den folgenden Befehl aus:
      sudo gem install cocoapods-deintegrate cocoapods-clean 
      pod deintegrate 
      pod cache clean --all
    2. Entfernen Sie Podfile, Podfile.resolved und den Xcode workspace, wenn du sie ausschließlich für CocoaPods verwendest.

    So entfernen Sie das vorhandene Treiber SDK: können Sie diese Schritte manuell ausführen:

    1. Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Bibliotheken und eingebettete Inhalte. Mit dem Minuszeichen(-) entfernen Sie folgendes Framework:

      • GoogleRidesharingDriver.xcframework
    2. Entfernen Sie aus dem Verzeichnis der obersten Ebene Ihres Xcode-Projekts den GoogleRidesharingDriver Bundle.

    CocoaPods

    Wenn Sie das Driver SDK mit CocoaPods konfigurieren möchten, benötigen Sie Folgendes:

    • CocoaPods-Tool: Öffnen Sie zum Installieren des Tools das Terminal und führen Sie den folgenden Befehl.
       sudo gem install cocoapods
    
    1. Erstellen Sie eine Podfile-Datei für das Driver SDK und installieren Sie damit die API und Abhängigkeiten: Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten Ihres Projekts definiert. Bearbeiten Sie die Podfile-Datei und fügen Sie Abhängigkeiten. Hier ein Beispiel mit den Abhängigkeiten:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Hier ist ein Beispiel, das die Alpha- und Beta-Pods für die Treiber-SDK als Abhängigkeiten:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    2. Speichern Sie die Podfile-Datei. Öffnen Sie ein Terminal und wechseln Sie zum Verzeichnis mit den Podfile:

      cd <path-to-project>
      
    3. Führen Sie den Befehl „pod install“ aus. Dadurch werden die APIs installiert, die im Podfile und mögliche Abhängigkeiten.

      pod install
      
    4. Schließen Sie Xcode und öffnen Sie dann per Doppelklick die .xcworkspace-Datei Ihres Projekts. um Xcode zu starten. Ab diesem Zeitpunkt müssen Sie das .xcworkspace zum Öffnen des Projekts.

    Weitere Informationen finden Sie im Artikel Erste Schritte mit CocoaPods für weitere Informationen Details.

    Manuelle Installation

    <ph type="x-smartling-placeholder">

    Ein XCFramework ist ein Binärpaket, mit dem Sie das Treiber-SDK. Sie können dieses Paket auf mehreren einschließlich Computern, die Apple Silicon ein. In diesem Leitfaden erfahren Sie, wie Sie das XCFramework, das die Treiber SDK zu Ihrem Projekt hinzufügen und Ihren Build konfigurieren in Xcode ändern.

    Laden Sie das SDK-Binärprogramm und die Ressourcen herunter:

    1. Extrahieren Sie die Dateien, um auf XCFramework und Ressourcen zuzugreifen.

    2. Starten Sie Xcode und öffnen Sie entweder ein vorhandenes Projekt oder erstellen Sie ein neues Projekt arbeiten. Wenn Sie neu bei iOS sind, erstellen Sie ein neues Projekt und wählen Sie App-Vorlage.

    3. Erstellen Sie eine Frameworks-Gruppe in Ihrer Projektgruppe, falls noch keine vorhanden ist bereits.

    4. Um das Driver SDK zu installieren, ziehen Sie den GoogleRidesharingDriver.xcframework-Datei in Ihr Projekt unter Frameworks, Bibliotheken und eingebettete Inhalte. Wenn Sie dazu aufgefordert werden, wählen Sie Kopieren Sie bei Bedarf Elemente.

    5. Ziehe das heruntergeladene Element (GoogleRidesharingDriver.bundle) in die oberste Ebene Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, wählen Sie Copy items if needed aus.

    6. Wählen Sie im Project Navigator Ihr Projekt und dann Anwendungsziel.

    7. Öffnen Sie den Tab Build Phases (Build-Phasen) und fügen Sie in Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) den Parameter folgenden Frameworks und Bibliotheken, falls diese noch nicht vorhanden sind:

      • Accelerate.framework
      • AudioToolbox.framework
      • AVFoundation.framework
      • CoreData.framework
      • CoreGraphics.framework
      • CoreLocation.framework
      • CoreTelephony.framework
      • CoreText.framework
      • GLKit.framework
      • ImageIO.framework
      • libc++.tbd
      • libxml2.tbd
      • libz.tbd
      • LocalAuthentication.framework
      • OpenGLES.framework
      • QuartzCore.framework
      • SystemConfiguration.framework
      • UIKit.framework
      • WebKit.framework
    8. Wählen Sie Ihr Projekt anstelle eines bestimmten Ziels aus und öffnen Sie die Schaltfläche Build Einstellungen. Fügen Sie im Abschnitt Other Linker Flags (Weitere Verknüpfungs-Flags) -ObjC für Debug und Release. Sind diese Einstellungen nicht sichtbar, ändern Sie die filtern Sie in der Leiste mit den Build-Einstellungen von Einfach nach Alle.

    Apple Privacy Manifest-Datei prüfen

    Apple verlangt, dass für Apps im App Store Details zum App-Datenschutz angegeben werden. Aktuelle Informationen und weitere Informationen finden Sie auf der Seite zu Datenschutzdetails im Apple App Store.

    Die Apple Privacy Manifest-Datei ist im Ressourcenpaket für das SDK enthalten. Wenn Sie prüfen möchten, ob die Privacy Manifest-Datei enthalten ist, und ihren Inhalt prüfen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie aus dem Archiv einen Datenschutzbericht.

    Autorisierung und Authentifizierung implementieren

    Wenn Ihre Treiber-App Updates generiert und an das Fleet Engine-Back-End sendet, Die Anfragen müssen gültige Zugriffstokens enthalten. Autorisierung und Authentifizierung ruft das Driver SDK Ihr Objekt auf, Entspricht dem GMTDAuthorization-Protokoll. Das Objekt ist verantwortlich für durch Angabe des erforderlichen Zugriffstokens.

    Als App-Entwickler entscheiden Sie, wie Tokens generiert werden. Ihre Implementierung sollte Folgendes ermöglichen:

    • Rufen Sie ein Zugriffstoken im JSON-Format von einem HTTPS-Server ab.
    • Parsen Sie das Token und speichern Sie es im Cache.
    • Aktualisieren Sie das Token, wenn es abläuft.

    Einzelheiten zu den vom Fleet Engine-Server erwarteten Tokens finden Sie unter Erstellen eines JSON Web Token (JWT) für Autorisierung.

    Die Anbieter-ID ist mit der Google Cloud-Projekt-ID identisch. Siehe Fleet Engine Kurzanleitung Leitfaden .

    Im folgenden Beispiel wird ein Zugriffstokenanbieter implementiert:

    Swift

    import GoogleRidesharingDriver
    
    private let providerURL = "INSERT_YOUR_TOKEN_PROVIDER_URL"
    
    class SampleAccessTokenProvider: NSObject, GMTDAuthorization {
      private struct AuthToken {
        // The cached vehicle token.
        let token: String
        // Keep track of when the token expires for caching.
        let expiration: TimeInterval
        // Keep track of the vehicle ID the cached token is for.
        let vehicleID: String
      }
    
      enum AccessTokenError: Error {
        case missingAuthorizationContext
        case missingData
      }
    
      private var authToken: AuthToken?
    
      func fetchToken(
        with authorizationContext: GMTDAuthorizationContext?,
        completion: @escaping GMTDAuthTokenFetchCompletionHandler
      ) {
        // Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
        guard let authorizationContext = authorizationContext else {
          completion(nil, AccessTokenError.missingAuthorizationContext)
          return
        }
        let vehicleID = authorizationContext.vehicleID
    
        // If appropriate, use the cached token.
        if let authToken = authToken,
          authToken.expiration > Date.now.timeIntervalSince1970 && authToken.vehicleID == vehicleID
        {
          completion(authToken.token, nil)
          return
        }
    
        // Otherwise, try to fetch a new token from your server.
        let request = URLRequest(url: URL(string: providerURL))
        let task = URLSession.shared.dataTask(with: request) { [weak self] data, _, error in
          guard let strongSelf = self else { return }
          guard error == nil else {
            completion(nil, error)
            return
          }
    
          // Replace the following key values with the appropriate keys based on your
          // server's expected response.
          let vehicleTokenKey = "VEHICLE_TOKEN_KEY"
          let tokenExpirationKey = "TOKEN_EXPIRATION"
          guard let data = data,
            let fetchData = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
            let token = fetchData[vehicleTokenKey] as? String,
            let expiration = fetchData[tokenExpirationKey] as? Double
          else {
            completion(nil, AccessTokenError.missingData)
            return
          }
    
          strongSelf.authToken = AuthToken(
            token: token, expiration: expiration, vehicleID: vehicleID)
          completion(token, nil)
        }
        task.resume()
      }
    }
    

    Objective-C

    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    // SampleAccessTokenProvider.h
    @interface SampleAccessTokenProvider : NSObject<GMTDAuthorization>
    @end
    
    static NSString *const PROVIDER_URL = @"INSERT_YOUR_TOKEN_PROVIDER_URL";
    
    // SampleAccessTokenProvider.m
    @implementation SampleAccessTokenProvider{
      // The cached vehicle token.
      NSString *_cachedVehicleToken;
      // Keep track of the vehicle ID the cached token is for.
      NSString *_lastKnownVehicleID;
      // Keep track of when tokens expire for caching.
      NSTimeInterval _tokenExpiration;
    }
    
    -   (void)fetchTokenWithContext:(nullable GMTDAuthorizationContext *)authorizationContext
                       completion:(nonnull GMTDAuthTokenFetchCompletionHandler)completion {
      // Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
      NSString *vehicleID = authorizationContext.vehicleID;
      if (!vehicleID) {
        NSAssert(NO, @"Vehicle ID is missing from authorizationContext.");
        return;
      }
    
      // Clear cached vehicle token if vehicle ID has changed.
      if (![_lastKnownVehicleID isEqual:vehicleID]) {
        _tokenExpiration = 0.0;
        _cachedVehicleToken = nil;
      }
      _lastKnownVehicleID = vehicleID;
    
      // Clear cached vehicletoken if it has expired.
      if ([[NSDate date] timeIntervalSince1970] > _tokenExpiration) {
        _cachedVehicleToken = nil;
      }
    
      // If appropriate, use the cached token.
      if (_cachedVehicleToken) {
        completion(_cachedVehicleToken, nil);
        return;
      }
      // Otherwise, try to fetch a new token from your server.
      NSURL *requestURL = [NSURL URLWithString:PROVIDER_URL];
      NSMutableURLRequest *request =
          [[NSMutableURLRequest alloc] initWithURL:requestURL];
      request.HTTPMethod = @"GET";
      // Replace the following key values with the appropriate keys based on your
      // server's expected response.
      NSString *vehicleTokenKey = @"VEHICLE_TOKEN_KEY";
      NSString *tokenExpirationKey = @"TOKEN_EXPIRATION";
      __weak typeof(self) weakSelf = self;
      void (^handler)(NSData *_Nullable data, NSURLResponse *_Nullable response,
                      NSError *_Nullable error) =
          ^(NSData *_Nullable data, NSURLResponse *_Nullable response, NSError *_Nullable error) {
            typeof(self) strongSelf = weakSelf;
            if (error) {
              completion(nil, error);
              return;
            }
    
            NSError *JSONError;
            NSMutableDictionary *JSONResponse =
                [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:&JSONError];
    
            if (JSONError) {
              completion(nil, JSONError);
              return;
            } else {
              // Sample code only. No validation logic.
              id expirationData = JSONResponse[tokenExpirationKey];
              if ([expirationData isKindOfClass:[NSNumber class]]) {
                NSTimeInterval expirationTime = ((NSNumber *)expirationData).doubleValue;
                strongSelf->_tokenExpiration = [[NSDate date] timeIntervalSince1970] + expirationTime;
              }
              strongSelf->_cachedVehicleToken = JSONResponse[vehicleTokenKey];
              completion(JSONResponse[vehicleTokenKey], nil);
            }
          };
      NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
      NSURLSession *mainQueueURLSession =
          [NSURLSession sessionWithConfiguration:config delegate:nil
                                   delegateQueue:[NSOperationQueue mainQueue]];
      NSURLSessionDataTask *task = [mainQueueURLSession dataTaskWithRequest:request completionHandler:handler];
      [task resume];
    }
    
    @end
    

    RidesharingDriverAPI-Instanz erstellen

    Zum Abrufen einer GMTDVehicleReporter-Instanz müssen Sie zuerst eine GMTDRidesharingDriverAPI-Instanz mit den Angaben „providerID“, „vehicleID“, driveContext und accessTokenProvider enthalten. Die Anbieter-ID entspricht der von Google. Cloud-Projekt-ID. Auf die Instanz GMTDVehicleReporter können Sie vom Treiber-API direkt an.

    Im folgenden Beispiel wird eine GMTDRidesharingDriverAPI-Instanz erstellt:

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        super.viewDidLoad()
    
        let vehicleID = "INSERT_CREATED_VEHICLE_ID"
        let accessTokenProvider = SampleAccessTokenProvider()
        let driverContext = GMTDDriverContext(
          accessTokenProvider: accessTokenProvider,
          providerID: providerID,
          vehicleID: vehicleID,
          navigator: mapView.navigator)
        let ridesharingDriverAPI = GMTDRidesharingDriverAPI(driverContext: driverContext)
      }
    }
    

    Objective-C

    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      NSString *vehicleID = @"INSERT_CREATED_VEHICLE_ID";
      SampleAccessTokenProvider *accessTokenProvider =
                                    [[SampleAccessTokenProvider alloc] init];
      GMTDDriverContext *driverContext =
        [[GMTDDriverContext alloc] initWithAccessTokenProvider:accessTokenProvider
                                                    providerID:PROVIDER_ID
                                                     vehicleID:vehicleID
                                                     navigator:_mapView.navigator];
    
      GMTDRidesharingDriverAPI *ridesharingDriverAPI = [[GMTDRidesharingDriverAPI alloc] initWithDriverContext:driverContext];
    }
    

    Optional auf VehicleReporter-Ereignisse überwachen

    GMTDVehicleReporter aktualisiert das Fahrzeug regelmäßig, wenn locationTrackingEnabled hat den Wert true. Um auf diese regelmäßigen Updates zu reagieren, GMTDVehicleReporter-Ereignisse abonnieren können, indem das GMTDVehicleReporterListener-Protokoll.

    Sie können die folgenden Ereignisse verarbeiten:

    • vehicleReporter(_:didSucceed:)

      Informiert die Treiber-App, dass die Backend-Dienste den Aktualisierung von Fahrzeugstandort und Fahrzeugstatus.

    • vehicleReporter(_:didFail:withError:)

      Informiert den Listener, dass ein Fahrzeugupdate fehlgeschlagen ist. Solange der Standort Tracking aktiviert ist, sendet GMTDVehicleReporter weiterhin die neuesten Daten zum Fleet Engine-Back-End.

    Im folgenden Beispiel werden diese Ereignisse verarbeitet:

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        ridesharingDriverAPI.vehicleReporter.add(self)
      }
    
      func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
        // Handle update succeeded.
      }
    
      func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
        // Handle update failed.
      }
    }
    

    Objective-C

    /*
    
        *   SampleViewController.h
     */
    @interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
    @end
    
    /*
    
        *   SampleViewController.m
     */
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      [ridesharingDriverAPI.vehicleReporter addListener:self];
    }
    
    -   (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
      // Handle update succeeded.
    }
    
    -   (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
      // Handle update failed.
    }
    
    @end
    

    GMTDVehicleReporter als Listener zu GMSRoadSnappedLocationProvider hinzufügen

    Damit Standortaktualisierungen für das Driver SDK zur Verfügung gestellt werden können, GMTDVehicleReporter muss als Listener für GMSRoadSnappedLocationProvider festgelegt werden.

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
          roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
          roadSnappedLocationProvider.startUpdatingLocation()
        }
      }
    }
    

    Objective-C

    /*
    
        *   SampleViewController.h
     */
    @interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
    @end
    
    /*
    
        *   SampleViewController.m
     */
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      [_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
      [_mapView.roadSnappedLocationProvider startUpdatingLocation];
    }
    
    @end
    

    Standortermittlung aktivieren

    Um das Standort-Tracking zu aktivieren, kann deine App locationTrackingEnabled auf true am GMTDVehicleReporter. GMTDVehicleReporter sendet automatisch Standortaktualisierungen. Nachdem die Services übereinstimmen und das Fahrzeug einer Fahrt zugewiesen wurde, GMTDVehicleReporter sendet automatisch Routenaktualisierungen, wenn die GMSNavigator im Navigationsmodus ist (wenn ein Ziel über setDestinations festgelegt wurde).

    Die bei der Aktualisierung der Fahrt festgelegte Route entspricht der des Fahrers. die während der Navigation navigiert werden können. Damit die User Journey bei der Arbeit muss der über setDestinations festgelegte Wegpunkt mit der im Fleet Engine-Back-End festgelegt.

    Wenn „locationTrackingEnabled“ auf „true“ gesetzt ist, werden Updates zu Fahrten und Fahrzeugen gesendet in regelmäßigen Abständen an das Fleet Engine-Back-End an das Fleet Engine-Back-End gesendet, locationUpdateInterval Wenn locationTrackingEnabled auf false gesetzt ist, gilt Folgendes: werden Updates angehalten und eine letzte Anfrage für ein Fahrzeugupdate wird an die Fleet Engine gesendet. um den Fahrzeugstatus auf GMTDVehicleState.offline festzulegen. Weitere Informationen finden Sie unter updateVehicleState .locationTrackingEnabled ist auf false eingestellt.

    Im folgenden Beispiel wird die Standortermittlung aktiviert:

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = true
      }
    }
    

    Objective-C

    /*
        *   SampleViewController.m
     */
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
    }
    
    @end
    

    Standardmäßig beträgt das Berichtsintervall 10 Sekunden, das Berichtsintervall kann jedoch mit locationUpdateInterval geändert werden. Das unterstützte Mindestaktualisierungsintervall 5 Sekunden beträgt. Das maximal unterstützte Aktualisierungsintervall beträgt 60 Sekunden. Häufigere Aktualisierungen können zu langsameren Anfragen und Fehlern führen.

    Fahrzeugstatus aktualisieren

    Das folgende Beispiel zeigt, wie der Fahrzeugstatus auf ONLINE festgelegt wird. Weitere Informationen finden Sie unter updateVehicleState .

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        ridesharingDriverAPI.vehicleReporter.update(.online)
      }
    }
    

    Objective-C

    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      [ridesharingDriverAPI.vehicleReporter
                                       updateVehicleState:GMTDVehicleStateOnline];
    }
    
    @end
    

    Wenn die Maske leer ist, kann in der Regel ein update_mask-Fehler auftreten. für die erste Aktualisierung nach dem Start. Das folgende Beispiel zeigt, wie Sie diesen Fehler:

    Swift

    import GoogleRidesharingDriver
    
    class VehicleReporterListener: NSObject, GMTDVehicleReporterListener {
      func vehicleReporter(
        _ vehicleReporter: GMTDVehicleReporter,
        didFail vehicleUpdate: GMTDVehicleUpdate,
        withError error: Error
      ) {
        let fullError = error as NSError
        if let innerError = fullError.userInfo[NSUnderlyingErrorKey] as? NSError {
          let innerFullError = innerError as NSError
          if innerFullError.localizedDescription.contains("update_mask cannot be empty") {
            emptyMaskUpdates += 1
            return
          }
        }
        failedUpdates += 1
      }
    
      override init() {
        emptyMaskUpdates = 0
        failedUpdates = 0
      }
    }
    

    Objective-C

    #import "VehicleReporterListener.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    @implementation VehicleReporterListener {
      NSInteger emptyMaskUpdates = 0;
      NSInteger failedUpdates = 0;
    }
    
    -   (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter
       didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate
                  withError:(NSError *)error {
      for (NSError *underlyingError in error.underlyingErrors) {
        if ([underlyingError.localizedDescription containsString:@"update_mask cannot be empty"]) {
          emptyMaskUpdates += 1;
          return;
        }
      }
      failedUpdates += 1
    }
    
    @end
    

    Standortaktualisierungen deaktivieren und Fahrzeug offline stellen

    Deine App kann Updates deaktivieren und das Fahrzeug offline nehmen. Wenn zum Beispiel ein die Schicht des Fahrgasts endet, kann deine App locationTrackingEnabled auf false setzen. Durch das Deaktivieren von Updates wird der Status des Fahrzeugs in Fleet Engine auf OFFLINE gesetzt Back-End.

    Swift

    vehicleReporter.locationTrackingEnabled = false
    

    Objective-C

    _vehicleReporter.locationTrackingEnabled = NO;