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