iOS için Sürücü SDK'sını Kullanmaya Başlama

Sürücüsü SDK'sını kullanarak müşterilerinize gelişmiş gezinme ve izleme Yolculuk ve Sipariş İlerlemesi uygulaması. Sürücü SDK'sı, araç İsteğe Bağlı Yolculuklar ve Teslimatlar Çözümü Filo Motoru için konum ve görev güncellemeleri.

Sürücü SDK'sı, Fleet Engine hizmetlerini ve özel hizmetlerinizi konumunu ve durumunu görebilirsiniz. Örneğin, araç ONLINE veya OFFLINE ve gezi ilerledikçe aracın konumu değişir.

Minimum sistem gereksinimleri

  • Mobil cihazda iOS 14 veya sonraki bir sürüm yüklü olmalıdır.
  • Xcode sürüm 15 veya sonraki bir sürüme sahip olmanız gerekir.
  • Ön koşullar

    Bu kılavuzda, uygulamanızda Gezinme SDK'nın ve Fileet'in Arama motoru arka ucun ayarlandı ve kullanılabilir durumda olduğundan emin olun. Ancak, bu örnek kod Gezinme SDK'sının nasıl kurulacağını öğreneceksiniz.

    iOS için Haritalar SDK'sını da etkinleştirmeniz gerekir. Google Cloud projenize bağlayın ve bir API alın Anahtar.

    Proje yapılandırması

    Swift Paket Yöneticisi

    Sürücü SDK'sı aracılığıyla yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için mevcut Driver SDK bağımlılıklarını kaldırın.

    SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

    1. Xcode project veya workspace dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin.
    2. URL olarak https://github.com/googlemaps/ios-driver-sdk adresini girin ve Enter'a basın paketi çekin ve "Paket Ekle"yi tıklayın.
    3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm temelli seçeneklerdir. Yeni projeler için en son sürümü ve "Tam Sürüm"ü kullanarak seçeneğini belirleyin. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
    4. Paket Ürünlerini Seçin penceresinde, GoogleRidesharingDriver öğesinin şuraya ekleneceğini doğrulayın: belirlediğiniz main hedefidir. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
    5. Yüklemenizi doğrulamak için hedefinizin General bölmesine gidin. Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümünde yüklü paketleri göreceksiniz. "Paket Bağımlılıkları"nı da görüntüleyebilirsiniz "Project Navigator"ın bölümü .

    Mevcut bir projenin package öğesini güncellemek için şu adımları izleyin:

    1. 9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şunları kaldırmanız gerekir: şu bağımlılıklar: GoogleMapsBase, GoogleMapsCore ve Yükseltme işleminden sonra GoogleMapsM4B. Bağımlılığı kaldırmayın: GoogleMaps Daha fazla bilgi için Sürüm 9.0.0 Sürüm Notları.

      Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar, ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:

      • GoogleMapsBase (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
      • GoogleMapsCore (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
      • GoogleMapsM4B (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
    2. Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
    3. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
    ziyaret edin.

    CocoaPods, aşağıdaki adımları uygulayın:

    1. Xcode çalışma alanınızı kapatın. Terminali açın ve aşağıdaki komutu yürütün:
      sudo gem install cocoapods-deintegrate cocoapods-clean 
      pod deintegrate 
      pod cache clean --all
    2. Podfile, Podfile.resolved ve CocoaPods dışında bir şey için kullanmıyorsanız Xcode workspace.

    Yüklü mevcut Driver SDK'sını kaldırmak için manuel olarak yüklemek istemiyorsanız aşağıdaki adımları uygulayın:

    1. Xcode proje yapılandırma ayarlarınızdan Frameworks, Kitaplıklar ve Yerleştirilmiş İçerikler. Kaldırmak için eksi işaretini(-) kullanın. şu çerçeveyi kullanabilirsiniz:

      • GoogleRidesharingDriver.xcframework
    2. Xcode projenizin üst düzey dizininden şunu kaldırın: GoogleRidesharingDriver paketi.

    CocoaPods

    CocoaPods'u kullanarak Sürücü SDK'sını yapılandırmak için aşağıdaki öğelere ihtiyacınız vardır:

    • CocoaPods aracı: Bu aracı yüklemek için Terminal'i açın ve aşağıdaki komuttan yararlanabilirsiniz.
       sudo gem install cocoapods
    
    1. Driver SDK için bir Podfile oluşturun ve bunu kullanarak API'yi ve bağımlılıkları: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve ve bildirmeyi konuştuk. Bağımlılıkları içeren bir örnek aşağıda verilmiştir:

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

      Bağımlılık olarak Driver SDK'sı:

      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. Podfile'ı kaydedin. Bir terminal penceresi açın ve şunu içeren dizine gidin: Podfile:

      cd <path-to-project>
      
    3. Kapsül yükleme komutunu çalıştırın. Bu işlem, ve sahip oldukları bağımlılıkları gösterir.

      pod install
      
    4. Xcode'u kapatın ve ardından projenizin .xcworkspace dosyasını açın (çift tıklayın) dosyasını seçin. Bu noktadan itibaren .xcworkspace uzantılı dosyayı açın.

    ziyaret edin.

    Daha fazla bilgi için CocoaPods rehberini inceleyin. bolca fırsat sunuyor.

    Manuel yükleme

    XCFramework, Sürücü SDK'sı. Bu paketi birden fazla Apple'ı kullanan makineleri de dahil olmak üzere silicon. Bu kılavuzda, öğesini içeren XCFramework'ü manuel olarak Projenize sürücü SDK'sı ekleyin ve derlemenizi yapılandırın Xcode'daki ayarları değiştirebilirsiniz.

    SDK ikili programını ve kaynaklarını indirin:

    1. XCFramework'e ve kaynaklara erişmek için dosyaları çıkarın.

    2. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun belirler. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS'i seçin Uygulama şablonu.

    3. Proje grubunuz yoksa bir Çerçeveler grubu oluşturun zaten.

    4. Sürücü SDK'sını yüklemek için GoogleRidesharingDriver.xcframework dosyasını Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler. İstendiğinde, Gerekirse öğeleri kopyalayın.

    5. İndirilen GoogleRidesharingDriver.bundle öğesini üst düzeye sürükleyin Xcode projenizin dizinini oluşturur. İstendiğinde Copy items if needed cihazını seçin.

    6. Project Navigator'dan projenizi seçin ve hedefi belirleyebilirsiniz.

    7. Derleme Aşamaları sekmesini açın ve İkili Program'ı Kitaplıklarla Bağla bölümünde mevcut değilse aşağıdaki çerçeveleri ve kitaplıkları kullanın:

      • 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. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarlar sekmesi. Diğer Bağlayıcı İşaretleri bölümünde şunun için -ObjC ekleyin: hata ayıklamak ve yayınlamaktır. Bu ayarlar görünmüyorsa filtreleyerek Temel'i Tümü olarak değiştirin.

    Apple Gizlilik Manifest dosyasını inceleyin

    Apple, App Store'daki uygulamalar için uygulama gizlilik ayrıntılarını zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.

    Apple Gizlilik Manifest dosyası, SDK'nın kaynak paketinde yer almaktadır. Gizlilik Manifest Dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın arşivini oluşturup arşivden bir gizlilik raporu oluşturun.

    Yetkilendirme ve kimlik doğrulamayı uygulama

    Driver uygulamanız güncellemeleri oluşturup Fleet Engine arka ucuna gönderdiğinde, bu istekler geçerli erişim jetonları içermelidir. Yetkilendirme ve kimlik doğrulama işlemleri Sürücü SDK'sı nesnenizi çağırır. GMTDAuthorization protokolüne uygun. Nesne, yürütülürken sağlamalısınız.

    Uygulama geliştirici olarak jetonların nasıl oluşturulacağını siz seçersiniz. Uygulamanız şunları yapmasına imkan tanımalıdır:

    • Bir HTTPS sunucusundan JSON biçiminde erişim jetonu alın.
    • Jetonu ayrıştırıp önbelleğe alın.
    • Jetonu süresi dolduğunda yenileyin.

    Fleet Engine sunucusunun beklediği jetonlarla ilgili ayrıntılar için JSON Web Token (JWT) yetkilendirme başlıklı makaleyi inceleyin.

    Sağlayıcı kimliği, Google Cloud proje kimliği ile aynıdır. Bkz. Fleet Engine Hızlı başlangıç kılavuzu Rehber konulu videomuzu izleyin.

    Aşağıdaki örnekte bir erişim jetonu sağlayıcı uygulanmaktadır:

    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
    

    RideshareDriverAPI örneği oluşturma

    Bir GMTDVehicleReporter örneği almak için öncelikle bir GMTDRidesharingDriverAPI sağlayıcı kimliği, araç kimliği, araç kimliği, driveContext ve accessTokenProvider. providerID, Google ile aynı Cloud Projesi Kimliği. Ayrıca GMTDVehicleReporter örneğine şuradan erişebilirsiniz: Drive API'sine doğrudan bağlanabilirsiniz.

    Aşağıdaki örnek bir GMTDRidesharingDriverAPI örneği oluşturur:

    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];
    }
    

    İsteğe bağlı olarak Vehicle Reporter etkinliklerini dinleme

    GMTDVehicleReporter, aşağıdaki durumlarda aracı düzenli olarak günceller: locationTrackingEnabled true. Bu düzenli güncellemelere yanıt vermek için nesne,GMTDVehicleReporter GMTDVehicleReporterListener protokolü.

    Aşağıdaki etkinlikleri yönetebilirsiniz:

    • vehicleReporter(_:didSucceed:)

      Sürücü uygulamasına, arka uç hizmetlerinin araç konumu ve durumu güncellemesi.

    • vehicleReporter(_:didFail:withError:)

      Dinleyiciyi bir araç güncellemesinin başarısız olduğu konusunda bilgilendirir. Konum kadar İzleme etkinleştirildiğinde, GMTDVehicleReporter en son verileri göndermeye devam eder Fleet Engine arka ucuna bağlanır.

    Aşağıdaki örnekte bu etkinlikler ele alınmaktadır:

    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'ı GMSRoadSnappedLocationProvider dinleyicisi olarak ekleme

    Sürücü SDK'sına konum güncellemeleri sağlamak için GMTDVehicleReporter GMSRoadSnappedLocationProvider dinleyicisi olarak ayarlanmalıdır.

    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
    

    Konum izlemeyi etkinleştirin

    Konum izlemeyi etkinleştirmek için uygulamanız locationTrackingEnabled adlı yeri şu şekilde ayarlayabilir: GMTDVehicleReporter tarihinde true. GMTDVehicleReporter otomatik olarak gönderiyor Konum güncellemeleri. Hizmetler eşleştirilip araç bir geziye atandıktan sonra GMTDVehicleReporter, GMSNavigator aşağıdaki işlemleri gerçekleştirdiğinde rota güncellemelerini otomatik olarak gönderir. gezinme modunda (setDestinations aracılığıyla hedef ayarlandığında).

    Yolculuk güncellemesi sırasında ayarlanan rota, sürücünün bulunduğu rotayla aynı olur gezinme oturumunda ne olduğuna karar vermelisiniz. Bu nedenle, yolculuk paylaşımının setDestinations üzerinden ayarlanan ara noktanın, Fleet Engine arka ucunda ayarlanan hedeftir.

    locationTrackingEnabled, true olarak ayarlanırsa gezi ve araç güncellemeleri gönderilir için ayarlanan değere göre düzenli aralıklarla Fleet Engine arka ucuna locationUpdateInterval. locationTrackingEnabled, false olarak ayarlanırsa güncellemeler durdurulur ve Fleet Engine'e son bir araç güncelleme isteği gönderilir. arka ucu kullanarak araç durumunu GMTDVehicleState.offline olarak ayarlayın. Görüntüleyin updateVehicleState şu durumlarda hata işleme konusunda özel olarak dikkate alınması gereken noktalar için: locationTrackingEnabled false olarak ayarlandı.

    Aşağıdaki örnek konum izlemeyi etkinleştirir:

    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
    

    Varsayılan olarak raporlama aralığı 10 saniyedir, ancak raporlama aralığı locationUpdateInterval ile değiştirilir. Desteklenen minimum güncelleme aralığı 5 saniyedir. Desteklenen maksimum güncelleme aralığı 60 saniyedir. Daha sık güncellemeler daha yavaş isteklere ve hatalara neden olabilir.

    Aracın durumunu güncelleyin

    Aşağıdaki örnekte, araç durumunun ONLINE olarak nasıl ayarlanacağı gösterilmektedir. Görüntüleyin updateVehicleState inceleyebilirsiniz.

    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
    

    Maske boşken update_mask hatası oluşabilir ve genellikle bu hata oluşur ve başlatmadan sonraki ilk güncelleme için. Aşağıdaki örnekte, şu hata mesajını verir:

    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
    

    Konum güncellemelerini devre dışı bırakın ve aracı çevrimdışı yapın

    Uygulamanız güncellemeleri devre dışı bırakıp aracı çevrimdışına alabilir. Örneğin, sürücünün vardiyası sona erdiğinde, uygulamanız locationTrackingEnabled ayarını false olarak ayarlayabilir. Güncellemeler devre dışı bırakıldığında Fleet Engine'de aracın durumu da OFFLINE olarak ayarlanır arka uçta olması gerekir.

    Swift

    vehicleReporter.locationTrackingEnabled = false
    

    Objective-C

    _vehicleReporter.locationTrackingEnabled = NO;