تجهيز المركبة

يوضّح هذا القسم كيفية تجهيز المركبة للرحلات. يجب إكمال كلّ خطوة من الخطوات التالية قبل أن تتمكّن واجهة الخلفية من مطابقة مركبة مع رحلة.

إعداد المستمعين

بعد بدء حزمة تطوير برامج Driver SDK وإنشاء GMTDRidesharingDriverAPI مثيل، يمكنك إعداد مستمعي الأحداث لتتبُّع نجاح أو تعذُّر تعديلات المركبات المُرسَلة إلى Fleet Engine ونظامك الأساسي. يمكن لهذه المستمعِين تنفيذ إجراءات داخل تطبيق السائق، مثل إرسال إشعار إلى السائق في حال تعطُّل الاتصال بواجهة الخلفية.

رصد أحداث تحديثات المركبات

عندما يفعّل السائق تحديثات الموقع الجغرافي في تطبيق السائق، تُرسِل حزمة تطوير برامج السائق تحديثات المركبات العادية إلى Fleet Engine وإلى العميل في الخلفية من خلال فئة GMTDVehicleReporter. يمكنك جعل التطبيق يستجيب لتعديل الأحداث من خلال إعداد بروتوكول GMTDVehicleReporterListener.

باستخدام GMTDVehicleReporterListener، يمكنك معالجة الأحداث التالية:

• vehicleReporter:didSucceedVehicleUpdate

  إبلاغ تطبيق "سائق Uber" بأنّ خدمات الخلفية تلقّت بنجاح تعديل الموقع الجغرافي للمركبة وحالتها

• vehicleReporter:didFailVehicleUpdate:withError

  إبلاغ المستمع بأنّه تعذّر تعديل بيانات المركبة ما دام السائق قد فعّل تحديثات الموقع الجغرافي، سيواصل فئة GMTDVehicleReporter إرسال أحدث البيانات إلى Fleet Engine.

توضِّح الأمثلة التالية كيفية إعداد GMTDVehicleReporterListener لمعالجة هذه الأحداث:

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

الاستماع إلى آخر المعلومات عن الموقع الجغرافي للمركبة

توفّر حزمة تطوير البرامج (SDK) للتنقّل إشعارات بشأن رصد الموقع الجغرافي إلى حزمة تطوير البرامج (SDK) للسائق من خلال فئة GMSRoadSnappedLocationProvider. لتلقّي هذه التعديلات، عليك إعداد GMTDVehicleReporter كمستمع.

ملاحظة: إذا لم يتم نقل الجهاز منذ آخر تحديث للموقع الجغرافي، لا تُرسِل فئة GMSRoadSnappedLocationProvider تحديثات الموقع الجغرافي باستمرار لتحسين الأداء. على سبيل المثال، إذا كان السائق في انتظار ازدحام بينما هو في السيارة إذا كنت تريد إرسال آخر المعلومات عن موقعك الجغرافي، وكنت قد ضبط GMTDVehicleReporter كمستمع بعد الاتصال startUpdatingLocation على GMSRoadSnappedLocationProvider، عليك إيقاف 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

تفعيل تعديلات الموقع الجغرافي

لتفعيل تعديلات الموقع الجغرافي، اضبط locationTrackingEnabled على true في GMTDVehicleReporter في تطبيق "سائق Fleet". بعد ذلك، تُرسِل فئة GMTDVehicleReporter تعديلات الموقع الجغرافي تلقائيًا إلى Fleet Engine. بعد أن تتطابق خدمات Fleet Engine و customer backend services وتخصّص المركبة لرحلة، تُرسِل فئة GMTDVehicleReporter تعديلات المسار تلقائيًا عندما يكون GMSNavigator في وضع التنقّل، أي عند ضبط وجهة من خلال setDestinations.

تضبط حزمة Driver SDK المسار ليطابق مسار التنقّل الحالي للسائق. لضمان دقة تعديلات الموقع الجغرافي، اضبط نقطة التوقف في setDestinations لتطابق الوجهة في Fleet Engine.

يوضّح المثال التالي كيفية تفعيل تعديلات الموقع الجغرافي:

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

ضبط الفاصل الزمني للتعديل

بشكلٍ تلقائي، عند ضبط locationTrackingEnabled على true، تُرسِل حزمة تطوير برامج (SDK) للسائقين تعديلات الرحلات والمركبات إلى Fleet Engine بفواصل زمنية تبلغ 10 ثوانٍ. يمكنك تغيير الفاصل الزمني للتعديل باستخدام locationUpdateInterval إلى فاصل زمني أدنى للتعديل يبلغ 5 ثوانٍ أو 60 ثانية كحد أقصى. وقد يؤدي إجراء المزيد من التعديلات بشكلٍ متكرّر إلى ظهور أخطاء وبطء في معالجة الطلبات.

ضبط حالة المركبة على "متصل"

بعد تفعيل تعديلات الموقع الجغرافي، اضبط حالة المركبة على ONLINE لإتاحة المركبة لطلبات البحث في Fleet Engine.

توضِّح الأمثلة التالية كيفية ضبط حالة المركبة على ONLINE. للاطّلاع على التفاصيل، يُرجى الاطّلاع على updateVehicleState.

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    ridesharingDriverAPI.vehicleReporter.update(.online)
  }
}

Objective-C

#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
  GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // Assumes you have implemented the sample code up to this step.
  [ridesharingDriverAPI.vehicleReporter
                                   updateVehicleState:GMTDVehicleStateOnline];
}

@end

الخطوات التالية

ضبط تفاصيل الرحلة