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

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

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

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

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

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

• vehicleReporter:didSucceedVehicleUpdate

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

• 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

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

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

تضبط حزمة Driver SDK المسار ليطابق مسار التنقّل الحالي للسائق. ل ضمان دقة تعديلات الموقع الجغرافي، اضبط نقطة التوقف في -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، تُرسِل حزمة Driver SDK تعديلات الموقع الجغرافي إلى Fleet Engine بفواصل زمنية تبلغ 10 ثوانٍ. يمكنك تغيير فترة التحديث باستخدام locationUpdateInterval إلى 5 ثوانٍ كحد أدنى أو 60 ثانية كحد أقصى. وقد يؤدي إجراء التحديثات بشكلٍ متكرّر إلى بطء الطلبات وظهور أخطاء.