Solusi Perjalanan dan Pengiriman On-demand saat ini hanya tersedia untuk partner tertentu.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mulai Menggunakan Driver SDK untuk iOS

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

Driver SDK membuat layanan Fleet Engine dan layanan kustom Anda mengetahui lokasi dan status kendaraan. Misalnya, kendaraan dapat berupa ONLINE atau OFFLINE, dan lokasi kendaraan berubah seiring berjalannya 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 sudah mengimplementasikan Navigation SDK dan backend Fleet Engine telah disiapkan dan tersedia. Namun, kode contoh memberikan contoh cara menyiapkan Navigation SDK.

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

Konfigurasi Project

Swift Package Manager

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

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

Buka Xcode project atau workspace, lalu buka File > Add Package Dependencies.
Masukkan https://github.com/googlemaps/ios-driver-sdk sebagai URL, tekan Enter untuk menarik paket, lalu klik "Tambahkan Paket".
Untuk menginstal version tertentu, tetapkan kolom Aturan Dependensi ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Versi Persis". Setelah selesai, klik "Add Package".
Dari jendela Choose Package Products, pastikan GoogleRidesharingDriver akan ditambahkan ke target main yang ditetapkan. Setelah selesai, klik "Add Package".
Untuk memverifikasi penginstalan, buka panel General target Anda. Di bagian Framework, Library, dan Konten Tersemat, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian "Dependensi Paket" pada "Project Navigator" untuk memverifikasi paket dan versinya.

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

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

Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
- GoogleMapsBase (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
- GoogleMapsCore (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
- GoogleMapsM4B (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
Dari Xcode, buka "File > Packages > Update To Recent Package Versions".
Untuk memverifikasi penginstalan, buka bagian Package Dependencies pada Project Navigator untuk memverifikasi paket dan versinya.

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

Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:

sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all

Hapus Podfile, Podfile.resolved, dan Xcode workspace jika Anda tidak menggunakannya untuk hal lain selain CocoaPods.

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

Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
- GoogleRidesharingDriver.xcframework
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

Buat Podfile untuk Driver SDK dan gunakan untuk menginstal API serta dependensinya: Buat file bernama Podfile di direktori project Anda. File ini mendefinisikan dependensi proyek 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
```
Simpan Podfile. Buka terminal dan buka direktori yang berisi Podfile:
```
cd <path-to-project>
```
Jalankan perintah pod install. Tindakan ini akan menginstal API yang ditentukan di Podfile, beserta dependensi yang mungkin dimiliki.
```
pod install
```
Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Baca Panduan Memulai CocoaPods untuk mengetahui detail selengkapnya.

Penginstalan manual

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

Download biner dan resource SDK:

Ekstrak file untuk mengakses XCFramework dan resource.
Mulai Xcode dan buka project yang sudah ada, atau buat project baru. Jika Anda baru menggunakan iOS, buat project baru dan pilih template App iOS.
Buat grup Framework di grup project jika belum ada.
Untuk menginstal Driver SDK, tarik file GoogleRidesharingDriver.xcframework ke project Anda di bagian Frameworks, Libraries, dan Embedded Content. Saat diminta, pilih Copy items if needed.
Tarik GoogleRidesharingDriver.bundle yang didownload ke direktori level teratas project Xcode Anda. Saat diminta, pilih Copy items if needed.
Pilih project dari Project Navigator, lalu pilih target aplikasi Anda.
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
Pilih project Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Other Linker Flags, tambahkan -ObjC untuk debug dan rilis. Jika setelan ini tidak terlihat, ubah filter di panel Setelan Build dari Dasar ke Semua.

Menambahkan File Manifes Privasi Apple

Apple memerlukan detail privasi aplikasi untuk aplikasi di App Store. Kunjungi halaman Detail Privasi Apple App Store untuk mendapatkan info terbaru dan informasi selengkapnya.

Download paket Manifes Privasi untuk Driver SDK untuk iOS: GoogleRidesharingDriverPrivacy.
Ekstrak file untuk mengakses GoogleRidesharingDriverPrivacy.bundle.
Tambahkan GoogleRidesharingDriverPrivacy.bundle ke navigator Project Xcode menggunakan salah satu metode ini. Pastikan kotak "Tambahkan ke target" dicentang untuk target aplikasi Anda. Setelah ditambahkan, file PrivacyInfo akan muncul di navigator Project dan Anda dapat memeriksa nilainya.

Verifikasi bahwa manifes privasi telah ditambahkan dengan membuat arsip aplikasi dan membuat laporan privasi dari arsip tersebut.

Mengimplementasikan otorisasi dan autentikasi

Saat aplikasi Driver membuat dan mengirimkan update ke backend Fleet Engine, permintaan tersebut harus menyertakan token akses yang valid. Untuk mengizinkan dan mengautentikasi permintaan ini, Driver SDK memanggil objek Anda yang sesuai dengan protokol GMTDAuthorization. Objek ini bertanggung jawab untuk memberikan token akses yang diperlukan.

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

Ambil token akses, yang mungkin dalam format JSON, dari server HTTPS.
Mengurai dan meng-cache token.
Muat ulang token saat masa berlakunya habis.

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

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

Contoh berikut mengimplementasikan 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 membuat instance GMTDRidesharingDriverAPI terlebih dahulu menggunakan providerID, kendaraanID, driverContext, dan accessTokenProvider. providerID sama dengan Project ID Google 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];
}

Jika perlu, memproses peristiwa VehicleReporter

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

Anda dapat menangani peristiwa berikut:

vehicleReporter(_:didSucceed:)

Memberi tahu aplikasi Pengemudi bahwa layanan backend berhasil menerima pembaruan lokasi dan status kendaraan.
vehicleReporter(_:didFail:withError:)

Memberi tahu pemroses bahwa update kendaraan gagal. Selama pelacakan lokasi 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 GMTDKendaraanReporter sebagai pemroses ke GMSRoadSnappedLocationProvider

Untuk memberikan pembaruan lokasi ke Driver SDK, GMTDVehicleReporter harus ditetapkan sebagai pemroses ke 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 mengirim pembaruan lokasi secara otomatis. Setelah layanan cocok dan menetapkan kendaraan ke sebuah perjalanan, GMTDVehicleReporter mengirim pembaruan rute secara otomatis saat GMSNavigator dalam mode navigasi (saat tujuan ditetapkan melalui setDestinations).

Rute yang ditetapkan selama pembaruan perjalanan akan menjadi rute yang sama dengan yang dilalui pengemudi selama sesi navigasi. Dengan demikian, agar berbagi perjalanan berfungsi dengan benar, titik jalan yang ditetapkan melalui setDestinations harus cocok dengan tujuan yang ditetapkan di backend Fleet Engine.

Jika locationTrackingEnabled ditetapkan ke true, info terbaru perjalanan dan kendaraan akan dikirim ke backend Fleet Engine pada interval reguler berdasarkan nilai yang ditetapkan untuk locationUpdateInterval. Jika locationTrackingEnabled ditetapkan ke false, update berhenti dan permintaan update kendaraan terakhir akan dikirim ke backend Fleet Engine untuk menetapkan status kendaraan ke GMTDVehicleState.offline. Lihat updateVehicleState untuk pertimbangan khusus tentang penanganan kegagalan saat locationTrackingEnabled ditetapkan 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. Update yang lebih sering dapat menyebabkan permintaan dan error 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 update pertama setelah startup. Contoh berikut menunjukkan cara menangani 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 update lokasi dan buat kendaraan offline

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

Swift

vehicleReporter.locationTrackingEnabled = false

Objective-C

_vehicleReporter.locationTrackingEnabled = NO;