Mulai Menggunakan Driver SDK untuk iOS

Anda dapat menggunakan SDK Driver untuk memberikan navigasi dan pelacakan yang ditingkatkan ke Aplikasi Progres Perjalanan dan Pesanan. Driver SDK menyediakan kendaraan pembaruan lokasi dan tugas pada Mesin Fleet Solusi Perjalanan dan Pengiriman On-demand.

SDK Driver membuat layanan Fleet Engine dan layanan khusus Anda mengetahui lokasi dan status kendaraan. Misalnya, kendaraan dapat berupa ONLINE atau OFFLINE, dan lokasi kendaraan berubah seiring berlangsungnya perjalanan.

Persyaratan sistem minimum

  • Perangkat seluler harus menjalankan iOS 14 atau yang lebih baru.
  • Xcode versi 15 atau yang lebih baru.
  • Prasyarat

    Panduan ini mengasumsikan bahwa aplikasi Anda telah mengimplementasikan Navigation SDK dan Armada Mesin backend disiapkan dan tersedia. Akan tetapi, kode contoh menyediakan sampel cara menyiapkan Navigation SDK.

    Anda juga harus mengaktifkan Maps SDK for iOS di Project Google Cloud Anda dan Dapatkan API Kunci.

    Konfigurasi Project

    Swift Package Manager

    Driver SDK dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda memiliki menghapus semua dependensi Driver SDK yang ada.

    Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:

    1. Buka project atau workspace Xcode, lalu buka File > Menambahkan Dependensi Paket.
    2. Masukkan https://github.com/googlemaps/ios-driver-sdk sebagai URL, tekan Enter untuk menarik paket, dan klik "{i>Add Package<i}".
    3. Untuk menginstal version tertentu, setel kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk proyek baru, sebaiknya tentukan versi terbaru dan menggunakan "Versi Persis" sebelumnya. Setelah selesai, klik "Add Package".
    4. Dari jendela Choose Package Products, pastikan GoogleRidesharingDriver akan ditambahkan ke target main yang Anda tetapkan. Setelah selesai, klik "Add Package".
    5. Untuk memverifikasi penginstalan, buka panel General target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat "{i>Package Dependencies<i}" bagian "Navigator Proyek" untuk memverifikasi paket dan versinya.

    Untuk mengupdate package untuk project yang sudah ada, ikuti langkah-langkah berikut:

    1. Jika mengupgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut: GoogleMapsBase, GoogleMapsCore, dan GoogleMapsM4B setelah mengupgrade. Jangan hapus dependensi untuk GoogleMaps. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.

      Dari setelan konfigurasi proyek Xcode Anda, temukan Frameworks, Libraries, dan Konten yang Disematkan. Gunakan tanda minus(-) untuk menghapus framework berikut:

      • GoogleMapsBase (Hanya untuk upgrade dari versi sebelum 9.0.0)
      • GoogleMapsCore (Hanya untuk upgrade dari versi sebelum 9.0.0)
      • GoogleMapsM4B (Hanya untuk upgrade dari versi sebelum 9.0.0)
    2. Dari Xcode, buka "File > Paket > Update Ke Versi Paket Terbaru".
    3. Untuk memverifikasi penginstalan, buka bagian Package Dependencies Project Navigator untuk memverifikasi paket dan versinya.

    Untuk menghapus dependensi Driver SDK yang ada yang ditambahkan menggunakan CocoaPods, ikuti langkah berikut:

    1. Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:
      sudo gem install cocoapods-deintegrate cocoapods-clean 
      pod deintegrate 
      pod cache clean --all
    2. Hapus Podfile, Podfile.resolved, dan Xcode workspace jika Anda tidak menggunakannya untuk hal apa pun selain CocoaPods.

    Untuk menghapus Driver SDK yang sudah diinstal secara manual, ikuti langkah-langkah berikut:

    1. Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Konten Tersemat. Gunakan tanda minus(-) untuk menghapus kerangka kerja berikut ini:

      • GoogleRidesharingDriver.xcframework
    2. Dari direktori level teratas project Xcode Anda, hapus Paket GoogleRidesharingDriver.

    CocoaPods

    Untuk mengonfigurasi Driver SDK menggunakan CocoaPods, Anda memerlukan item berikut:

    • Alat CocoaPods: Untuk menginstal alat ini, buka Terminal dan jalankan perintah berikut.
       sudo gem install cocoapods
    
    1. Buat Podfile untuk Driver SDK dan gunakan untuk menginstal API dan dependensinya: Buat file bernama Podfile di direktori project Anda. File ini mendefinisikan dependensi project Anda. Edit Podfile dan tambahkan dependensi Anda. Berikut adalah contoh yang menyertakan dependensi:

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

      Berikut adalah contoh yang menyertakan pod Alfa dan Beta untuk Driver SDK sebagai dependensi:

      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. Simpan Podfile. Buka terminal dan buka direktori yang berisi Podfile:

      cd <path-to-project>
      
    3. Jalankan perintah pod install. Ini akan menginstal API yang ditetapkan dalam Podfile, beserta dependensi apa pun yang mungkin dimilikinya.

      pod install
      
    4. Tutup Xcode, lalu buka (klik dua kali) .xcworkspace project Anda untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka proyek.

    Lihat CocoaPods Memulai untuk informasi selengkapnya spesifikasi pendukung.

    Penginstalan manual

    XCFramework adalah paket biner yang Anda gunakan untuk menginstal Driver SDK. Anda dapat menggunakan paket ini di beberapa platform ini, termasuk komputer yang menggunakan aplikasi Apple silikon. Panduan ini menunjukkan cara menambahkan secara manual XCFramework yang berisi Driver SDK ke project dan mengonfigurasi build Anda di Xcode.

    Download resource dan biner SDK:

    1. Ekstrak file tersebut untuk mengakses XCFramework dan resource.

    2. Mulai Xcode dan buka project yang ada, atau buat project baru proyek. Jika Anda baru menggunakan iOS, buat project baru dan pilih Template aplikasi.

    3. Buat grup Kerangka Kerja di bawah grup proyek Anda jika belum ada .

    4. Untuk menginstal Driver SDK, tarik GoogleRidesharingDriver.xcframework ke project Anda di bagian Framework, Library, dan Konten Tersemat. Saat diminta, pilih Salin item jika perlu.

    5. Tarik GoogleRidesharingDriver.bundle yang didownload ke level teratas project Xcode Anda. Saat diminta, pilih Copy items if needed.

    6. Pilih proyek Anda dari Navigator Proyek, dan pilih target aplikasi Anda.

    7. Buka tab Build Phases, dan di Link Binary with Libraries, tambahkan framework dan library berikut jika belum ada:

      • 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. Pilih project Anda, bukan target tertentu, dan buka fungsi Build Setelan kami. Di bagian Other Linker Flags, tambahkan -ObjC untuk debug dan rilis. Jika setelan ini tidak terlihat, ubah pada panel Setelan Build dari Dasar ke Semua.

    Memeriksa file Manifes Privasi Apple

    Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store. Kunjungi halaman Detail Privasi Apple App Store untuk pembaruan dan informasi selengkapnya.

    File Manifes Privasi Apple disertakan dalam paket resource untuk SDK. Untuk memverifikasi bahwa File Manifes Privasi telah disertakan, dan untuk memeriksa kontennya, buat arsip aplikasi dan buat laporan privasi dari arsip.

    Menerapkan otorisasi dan autentikasi

    Saat aplikasi Driver Anda membuat dan mengirim update ke backend Fleet Engine, permintaan harus menyertakan token akses yang valid. Untuk memberi otorisasi dan mengautentikasi permintaan ini, Driver SDK akan memanggil objek Anda sesuai dengan protokol GMTDAuthorization. Objek bertanggung jawab untuk yang menyediakan token akses yang diperlukan.

    Sebagai developer aplikasi, Anda memilih bagaimana token dibuat. Implementasi Anda harus memberikan kemampuan untuk melakukan hal berikut:

    • Ambil token akses, kemungkinan dalam format JSON, dari server HTTPS.
    • Uraikan dan simpan token dalam cache.
    • Muat ulang token jika masa berlakunya sudah habis.

    Untuk detail tentang token yang diharapkan oleh server Fleet Engine, lihat Membuat JSON Web Token (JWT) untuk otorisasi.

    ID penyedia sama dengan ID Project Google Cloud. Lihat Fleet Engine Panduan memulai Panduan untuk informasi selengkapnya.

    Contoh berikut menerapkan penyedia token akses:

    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
    

    Membuat instance RidesharingDriverAPI

    Untuk mendapatkan instance GMTDVehicleReporter, Anda harus terlebih dahulu membuat instance GMTDRidesharingDriverAPI menggunakan providerID, VehicleID, driverContext dan accessTokenProvider. providerID sama dengan Google ID Project Cloud. Anda juga dapat mengakses instance GMTDVehicleReporter dari driver API secara langsung.

    Contoh berikut membuat instance GMTDRidesharingDriverAPI:

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

    Mendengarkan peristiwa VehicleReporter (opsional)

    GMTDVehicleReporter mengupdate kendaraan secara berkala saat locationTrackingEnabled adalah true. Untuk menanggapi pembaruan berkala ini, objek dapat berlangganan peristiwa GMTDVehicleReporter dengan mematuhi protokol GMTDVehicleReporterListener.

    Anda dapat menangani peristiwa berikut:

    • vehicleReporter(_:didSucceed:)

      Memberi tahu aplikasi Driver bahwa layanan backend berhasil menerima lokasi kendaraan dan pembaruan negara bagian.

    • vehicleReporter(_:didFail:withError:)

      Memberi tahu pemroses bahwa update kendaraan gagal. Selama lokasi pelacakan diaktifkan, GMTDVehicleReporter akan terus mengirim data terbaru ke backend Fleet Engine.

    Contoh berikut menangani peristiwa ini:

    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
    

    Menambahkan GMTDvehicleReporter sebagai pemroses ke GMSRoadSnappedLocationProvider

    Untuk memberikan pembaruan lokasi ke Driver SDK, GMTDVehicleReporter harus ditetapkan sebagai pemroses untuk GMSRoadSnappedLocationProvider.

    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
    

    Aktifkan pelacakan lokasi

    Untuk mengaktifkan pelacakan lokasi, aplikasi Anda dapat menetapkan locationTrackingEnabled ke true pada GMTDVehicleReporter. GMTDVehicleReporter otomatis mengirim pembaruan lokasi. Setelah layanan cocok dan menetapkan kendaraan untuk perjalanan, GMTDVehicleReporter mengirim pembaruan rute secara otomatis saat GMSNavigator berada dalam mode navigasi (jika tujuan disetel melalui setDestinations).

    Rute yang ditetapkan selama update perjalanan akan sama dengan rute yang dilalui pengemudi bernavigasi selama sesi navigasi. Jadi, untuk {i> user journey<i} ke pekerjaan dengan benar, titik jalan yang ditetapkan melalui setDestinations harus cocok dengan yang ditetapkan di backend Fleet Engine.

    Jika locationTrackingEnabled disetel ke true, info terbaru perjalanan dan kendaraan akan dikirim ke backend Fleet Engine pada interval reguler berdasarkan nilai yang ditetapkan untuk locationUpdateInterval. Jika locationTrackingEnabled disetel ke false, update berhenti dan permintaan update kendaraan terakhir dikirim ke Fleet Engine backend untuk menetapkan status kendaraan ke GMTDVehicleState.offline. Lihat updateVehicleState pertimbangan khusus terkait penanganan kegagalan saat locationTrackingEnabled disetel ke false.

    Contoh berikut mengaktifkan pelacakan lokasi:

    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
    

    Secara default, interval pelaporan adalah 10 detik, tetapi interval pelaporan dapat diubah dengan locationUpdateInterval. Interval update minimum yang didukung adalah 5 detik. Interval update maksimum yang didukung adalah 60 detik. Lebih sering update dapat mengakibatkan error dan permintaan yang lebih lambat.

    Memperbarui status kendaraan

    Contoh berikut menunjukkan cara menetapkan status kendaraan ke ONLINE. Lihat updateVehicleState untuk mengetahui detailnya.

    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
    

    Error update_mask dapat terjadi saat mask kosong, dan biasanya terjadi untuk pembaruan pertama setelah sistem dimulai. Contoh berikut menunjukkan cara menangani pesan error ini:

    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
    

    Nonaktifkan pembaruan lokasi dan buat kendaraan offline

    Aplikasi Anda dapat menonaktifkan update dan membuat kendaraan offline. Misalnya, ketika seorang shift pengemudi berakhir, aplikasi Anda dapat menetapkan locationTrackingEnabled ke false. Menonaktifkan update juga akan menetapkan status kendaraan ke OFFLINE di Fleet Engine backend.

    Swift

    vehicleReporter.locationTrackingEnabled = false
    

    Objective-C

    _vehicleReporter.locationTrackingEnabled = NO;