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

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

إعداد أداة الاستماع

بما أنّ حزمة تطوير البرامج (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());

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

بعد الحصول على مثيل *VehicleReporter، فعِّل تعديلات الموقع الجغرافي على النحو التالي:

(اختياري) ضبط فترة التعديل

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