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

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

إعداد أداة معالجة الحدث

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

يوضّح المثال التالي عملية تنفيذ DriverStatusListener:

class MyStatusListener implements DriverStatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
      StatusLevel statusLevel, StatusCode statusCode, String statusMsg, @Nullable Throwable cause) {
    // Existing implementation

    if (cause != null && cause instanceof StatusRuntimeException) {
      if (Status.NOT_FOUND.getCode().equals(cause.getStatus().getCode())) {
        // NOT_FOUND gRPC exception thrown by Fleet Engine.
      }
    }
  }
}

DriverContextBuilder.setDriverStatusListener(new MyStatusListener());

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

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

Java

RidesharingVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Kotlin

val reporter = ...

reporter.enableLocationTracking()

تحديد الفاصل الزمني للتحديثات

ترسل حزمة تطوير البرامج (SDK) لبرنامج التشغيل تلقائيًا تحديثات الموقع الجغرافي على فترات زمنية تبلغ 10 ثوانٍ. الفاصل الزمني عندما تكون حالة المركبة هي ONLINE. يمكنك تغيير هذا الفاصل الزمني باستخدام reporter.setLocationReportingInterval(long, TimeUnit) الحد الأدنى المتاح الفاصل الزمني للتحديث هو 5 ثوانٍ. قد تؤدي التحديثات المتكررة إلى حدوث بطء الطلبات والأخطاء.

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

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

يمكنك ضبط حالة المركبة مباشرةً في "حزمة تطوير البرامج (SDK) للسائق" أو في Fleet Engine. الخادم. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحديث مركبة.

توضِّح الأمثلة التالية كيفية ضبط حالة المركبة على الإنترنت في السائق. حزمة SDK:

Java

RidesharingVehicleReporter reporter = ...;

reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);

Kotlin

val reporter = ...

reporter.enableLocationTracking()
reporter.setVehicleState(VehicleState.ONLINE)

تُبلِغ "StatusListener" أيضًا عن أي أخطاء تحدث عند تعديل حالة المركبة.

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

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