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

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

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

الاستماع إلى أحداث تحديث المركبة

عندما يفعّل السائق إشعارات تحديد الموقع الجغرافي في تطبيق السائق، ترسل حزمة تطوير البرامج (SDK) الخاصة بالسائق إشعارات منتظمة بشأن المركبة إلى Fleet Engine وخادم الخلفية الخاص بالعميل من خلال الفئة GMTDDeliveryVehicleReporter. يمكنك ضبط بروتوكول GMTDVehicleReporterListener لكي يستجيب التطبيق لأحداث التحديث.

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

• vehicleReporter:didSucceedVehicleUpdate

  تُعلم هذه السمة تطبيق السائق بأنّ الخدمات الخلفية قد تلقّت بنجاح معلومات الموقع الجغرافي للمركبة وحالة التحديث.

• vehicleReporter:didFailVehicleUpdate:withError

  تُعلم هذه الطريقة المستمع بأنّه تعذّر تعديل معلومات المركبة. طالما أنّ السائق فعّل إذن الحصول على آخر المعلومات عن الموقع الجغرافي، سيستمر صف GMTDDeliveryVehicleReporter في إرسال أحدث البيانات إلى 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.
    deliveryDriverAPI.vehicleReporter.add(self)
  }

  func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
    // Handle update succeeded.
  }

  func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, 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 IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
  [delivervehicleReporter addListener:self];
}

- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
  // Handle update succeeded.
}

- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
  // Handle update failed.
}

@end

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

لتفعيل تحديثات الموقع الجغرافي، اضبط locationTrackingEnabled على YES في تطبيق السائق على GMTDDeliveryVehicleReporter. بعد ذلك، يرسل الصف GMTDDeliveryVehicleReporter تلقائيًا تعديلات الموقع الجغرافي إلى Fleet Engine. بالإضافة إلى ذلك، عندما يكون GMSNavigator في وضع التنقّل، أي عندما يتم ضبط وجهة من خلال setDestinations، يرسل صف GMTDDeliveryVehicleReporter تلقائيًا تحديثات بشأن المسار ووقت الوصول المقدَّر.

تضبط حزمة تطوير البرامج للسائقين المسار ليتطابق مع مسار التنقّل الحالي للسائق. لضمان تحديثات دقيقة للموقع، اضبط نقطة المسار في -setDestinations:callback: لتتطابق مع الوجهة في 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.
    deliveryDriverAPI.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.
  deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}

@end

ملاحظة: إذا لم يتحرك الجهاز منذ آخر تحديث للموقع، فلن ترسل فئة GMSRoadSnappedLocationProvider تحديثات الموقع بشكل مستمر. على سبيل المثال، إذا كان السائق ينتظر في السيارة بدون فعل أي شيء. إذا كنت تريد إرسال تحديث جديد للموقع، وقمت بتعيينGMTDDeliveryVehicleReporter كمستمع بعد الاتصالstartUpdatingLocation علىGMSRoadSnappedLocationProvider ، عليك التوقف والبدءGMSRoadSnappedLocationProvider.

(اختياري) ضبط الفاصل الزمني للتحديث

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