İsteğe bağlı Yolculuk ve Teslimat Çözümü şu anda yalnızca belirli iş ortakları tarafından kullanılabilmektedir.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Seyahat ve Sipariş İlerlemesi uygulamanızda gelişmiş navigasyon ve izleme sağlamak için Driver SDK'sını kullanabilirsiniz. Driver SDK'sı, İsteğe Bağlı Oyuncaklar ve Teslimat Çözümü Fleet Engine'e araç konumu ve görev güncellemeleri sunar.

Sürücü SDK'sı, Fleet Engine hizmetlerinin ve özel hizmetlerinizin aracın konumu ve durumundan haberdar olmasını sağlar. Örneğin, araç ONLINE veya OFFLINE olabilir ve gezi ilerledikçe araç konumu değişir.

Minimum sistem gereksinimleri

Mobil cihazda iOS 13 veya daha yeni bir sürüm yüklü olmalıdır.

Xcode 14 sürümü veya sonraki sürümler.

Ön koşullar

Bu kılavuzda, uygulamanızın Gezinme SDK'sını halihazırda kullandığı ve Fleet Engine arka ucunun ayarlandığı ve kullanılabilir olduğu varsayılır. Ancak örnek kod, Gezinme SDK'sı'nın nasıl ayarlanacağına dair bir örnek sağlar.

Ayrıca Google Cloud Projenizde iOS için Haritalar SDK'sını etkinleştirmeniz ve API Anahtarı Almanız gerekir.

Proje Yapılandırması

Sürücü SDK'sını CocoaPods'u kullanarak yapılandırabilirsiniz.

CocoaPods kullanma

Sürücü SDK'sını CocoaPods'u kullanarak 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çıp aşağıdaki komutu çalıştırın. shell sudo gem install cocoapods Daha fazla bilgi için CocoaPods Başlangıç Kılavuzuna bakın.

Sürücü SDK'sı için bir Podfile oluşturun ve API ile bağımlılıklarını yüklemek için bunu kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örnek verelim:
```
source "https://github.com/CocoaPods/Specs.git"

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleRidesharingDriver'
end
```
Aşağıda, Driver SDK'sının Alfa ve Beta kapsüllerini bağımlılık olarak içeren bir örneği görebilirsiniz:
```
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
```
Not: SDK'nın daha yeni bir sürümünün olduğunu tespit etmek için düzenli aralıklarla pod outdated çalıştırdığınızdan emin olun. Daha fazla bilgi için iOS Sürümleri için Sürücü SDK'sı bölümünü inceleyin.
Not: Projenizde çerçevelerin kullanılmasını gerektiren bağımlılıklar varsa gRPC kapsül bağımlılığı için statik bağlantı belirtmeniz gerekir. Bu, use_frameworks yapılandırması aracılığıyla hedef düzeyde veya gRPC kapsülüne tek tek statik bağlantı uygulayarak yapılabilir. Aksi takdirde, çalışma zamanında missing roots.pem gRPC hatası oluşabilir.
Podfile'ı kaydedin. Bir terminal penceresi açın ve Podfile dosyasını içeren dizine gidin:
```
cd <path-to-project>
```
Kapsül yükleme komutunu çalıştırın. Bu işlem, Podfile dosyasında belirtilen API'leri ve sahip olabilecekleri bağımlılıkları yükler.
```
pod install
```
Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren, projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

XCFramework'ü yükleyin

XCFramework, Driver SDK'sını yüklemek için kullandığınız bir ikili pakettir. Bu paketi, Apple silikon kullanan makineler de dahil olmak üzere çeşitli platformlarda kullanabilirsiniz. Bu kılavuzda, Sürücü SDK'sını içeren XCFramework'ü projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir.

Google'dan aldığınız kaynak dosyaları paketinden çıkarın.
Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS kullanmaya yeni başladıysanız yeni bir proje oluşturun ve iOS uygulama şablonunu seçin.
Henüz yoksa proje grubunuzun altında bir Çerçeveler grubu oluşturun.
XCFramework'ü içeren zip dosyasının Resources dizininde yer alan gRPCCertificates.bundle dosyasını, Xcode projenizin üst düzey dizinine sürükleyin. Sorulduğunda, gerekirse Öğeleri kopyala'yı seçin.
Sürücü SDK'sını yüklemek için GoogleRidesharingDriver.xcframework dosyasını Frameworks, Libraries, and Embedded Content altındaki projenize sürükleyin. Sorulduğunda, gerekirse Öğeleri kopyala'yı seçin.
Projenizde GoogleRidesharingDriver.xcframework öğesini sağ tıklayın ve Show In Finder öğesini seçin.
GoogleRidesharingDriver.bundle öğesini ios-arm64_x86_64-simulator/GoogleRidesharingDriver.framework/Resources klasöründen Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde Copy items if needed öğesinin seçilmediğinden emin olun.
Project Navigator'dan projenizi seçin ve uygulamanızın hedefini belirleyin.
Derleme Aşamaları sekmesini açın ve Aşağıdaki çerçeveleri ve kitaplıkları, henüz yoksa, Kitaplıklarla Bağla İkili Program'a ekleyin:
- 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
Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümüne hem hata ayıklama hem de sürüm için ‑ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel'den Tümü'ne değiştirin.

Alfa/Beta SDK sürümleri

iOS için Sürücü SDK'sının Alfa veya Beta sürümlerini 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çıp aşağıdaki komutu çalıştırın.
```
sudo gem install cocoapods
```
Daha fazla bilgi için CocoaPods Başlangıç Kılavuzuna bakın.
Google erişim listesindeki geliştirme hesabınız. SDK'nın Alfa ve Beta sürümlerinin kapsül deposu, herkese açık kaynak değildir. Bu sürümlere erişmek için Google Müşteri Mühendisi ile iletişime geçin. Mühendis, geliştirme hesabınızı erişim listesine ekler ve ardından kimlik doğrulama için bir çerez ayarlar.

Projeniz erişim listesine girdikten sonra kapsüle erişebilirsiniz.

iOS için Delivery SDK'ya yönelik bir Podfile oluşturun ve API ile bağımlılıklarını yüklemek için bunu kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örnek verelim:
```
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
```
Podfile'ı kaydedin. Bir terminal penceresi açın ve Podfile dosyasını içeren dizine gidin:
```
cd <path-to-project>
```
Kapsül yükleme komutunu çalıştırın. Bu komut, Podfile dosyasında belirtilen API'leri ve sahip olabileceği tüm bağımlılıkları yükler.
```
pod install
```
Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren, projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

Yetkilendirme ve kimlik doğrulama uygulayın

Sürücü uygulamanız Fleet Engine arka ucuna güncelleme oluşturup gönderdiğinde, istekler geçerli erişim jetonları içermelidir. Driver SDK'sı, bu istekleri yetkilendirmek ve kimliklerini doğrulamak için GMTDAuthorization protokolüne uygun şekilde nesnenizi çağırır. Nesne, gerekli erişim jetonunu sağlamaktan sorumludur.

Uygulama geliştirici olarak jetonların nasıl oluşturulacağını siz seçersiniz. Uygulamanız, aşağıdakileri yapabilmelidir:

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

Fleet Engine sunucusunun beklediği jetonlarla ilgili ayrıntılar için Yetkilendirme için JSON Web Jetonu (JWT) oluşturma bölümüne bakın.

Sağlayıcı kimliği, Google Cloud proje kimliği ile aynıdır. Daha fazla bilgi için Fleet Engine Hızlı Başlangıç Kılavuzu'na göz atın.

Aşağıdaki örnekte bir erişim jetonu sağlayıcı uygulanı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

RidesharingDriverAPI örneği oluşturma

Bir GMTDVehicleReporter örneği almak için önce providerID, vehicleID, driveContext ve accessTokenProvider kullanarak bir GMTDRidesharingDriverAPI örneği oluşturmanız gerekir. providerID bu Google Cloud proje kimliği ile aynıdır. Ayrıca, GMTDVehicleReporter örneğine doğrudan sürücü API'sinden erişebilirsiniz.

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 VehicleReporter etkinliklerini dinleyin

GMTDVehicleReporter, locationTrackingEnabled true olduğunda aracı düzenli olarak günceller. Bu periyodik güncellemelere yanıt vermek için tüm nesneler, GMTDVehicleReporterListener protokolüne uyarak GMTDVehicleReporter etkinliklerine abone olabilir.

Aşağıdaki etkinlikleri yönetebilirsiniz:

vehicleReporter(_:didSucceed:)

Sürücü uygulamasına, arka uç hizmetlerinin araç konumu ve durum güncellemesini başarıyla aldığını bildirir.
vehicleReporter(_:didFail:withError:)

Dinleyiciyi araç güncellemesinin başarısız olduğu konusunda bilgilendirir. GMTDVehicleReporter, konum izleme etkin olduğu sürece en son verileri Fleet Engine arka ucuna göndermeye devam eder.

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'a işleyici olarak ekleme

Sürücü SDK'sına konum güncellemeleri sağlamak için GMTDVehicleReporter, GMSRoadSnappedLocationProvider işleyicisi 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ştir

Konum izlemeyi etkinleştirmek için uygulamanız, GMTDVehicleReporter sitesinde locationTrackingEnabled özelliğini true olarak ayarlayabilir. GMTDVehicleReporter, konum güncellemelerini otomatik olarak gönderir. Hizmetler eşleşip aracı bir geziye atadıktan sonra GMTDVehicleReporter, GMSNavigator navigasyon modundayken (setDestinations üzerinden bir hedef ayarlandığında) rota güncellemelerini otomatik olarak gönderir.

Yolculuk güncellemesi sırasında ayarlanan rota, sürücünün navigasyon oturumu sırasında gitmek istediği rotayla aynı olacaktır. Dolayısıyla, yolculuk paylaşımının düzgün çalışması için setDestinations boyunca ayarlanan referans noktası, Fleet Engine arka ucunda ayarlanan hedefle eşleşmelidir.

locationTrackingEnabled, true olarak ayarlanırsa yolculuk ve araç güncellemeleri, locationUpdateInterval için ayarlanan değere göre düzenli aralıklarla Fleet Engine arka ucuna gönderilir. locationTrackingEnabled, false olarak ayarlanırsa güncellemeler durur ve araç durumunu GMTDVehicleState.offline olarak ayarlamak için Fleet Engine arka ucuna son bir araç güncelleme isteği gönderilir. locationTrackingEnabled false olarak ayarlandığında oluşan hataları ele alma ile ilgili dikkat edilmesi gereken özel noktalar için updateVehicleState bölümüne bakın.

Aşağıdaki örnekte konum izleme etkinleştirilmektedir:

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ştirilebilir. Desteklenen minimum güncelleme aralığı 5 saniyedir. Desteklenen maksimum güncelleme aralığı 60 saniyedir. Güncellemelerin daha sık yapılması isteklerin daha yavaş olmasına ve hatalara neden olabilir.

Aracın durumunu güncelleme

Aşağıdaki örnekte, araç durumunun nasıl ONLINE olarak ayarlanacağı gösterilmektedir. Ayrıntılar için updateVehicleState sayfasını inceleyin.

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ş olduğunda update_mask hatası oluşabilir ve genellikle başlatmadan sonraki ilk güncellemede ortaya çıkar. Aşağıdaki örnekte bu hatanın nasıl ele alınacağı gösterilmektedir:

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 ve aracı çevrimdışı yap

Uygulamanız güncellemeleri devre dışı bırakabilir ve aracı çevrimdışı hale getirebilir. Örneğin, sürücü mesaisi sona erdiğinde uygulamanız locationTrackingEnabled özelliğini false olarak ayarlayabilir. Güncellemelerin devre dışı bırakılması, Fleet Engine arka ucunda aracın durumunu da OFFLINE olarak ayarlar.

Swift

vehicleReporter.locationTrackingEnabled = false

Objective-C

_vehicleReporter.locationTrackingEnabled = NO;