دليل نقل بيانات Android Driver SDK 4.0

يتطلّب إصدار Driver SDK لنظام التشغيل Android 4.0 تعديل الرمز البرمجي لإجراء عمليات معيّنة. يوضّح هذا الدليل التغييرات والإجراءات التي عليك اتّخاذها لنقل الرمز.

تغيير اسم الحزمة

تم تغيير اسم الحزمة من com.google.android.libraries.ridesharing.driver إلى com.google.android.libraries.mapsplatform.transportation.driver. يُرجى تعديل المراجع في الرمز البرمجي.

إعداد حزمة تطوير البرامج (SDK)

في الإصدارات السابقة، كان عليك إعداد حزمة تطوير البرامج (SDK) لنظام التنقّل ثم الحصول على إشارة إلى فئة FleetEngine. في الإصدار 4 من حزمة تطوير برامج (SDK) لسائقي المركبات، يمكنك إعداد حزمة SDK على النحو التالي:

1. الحصول على عنصر Navigator من NavigationApi

   NavigationApi.getNavigator(
       this, // Activity
       new NavigationApi.NavigatorListener() {
         @Override
         public void onNavigatorReady(Navigator navigator) {
           // Keep a reference to the Navigator (used to configure and start nav)
           this.navigator = navigator;
         }
       }
   );
   

2. أنشئ عنصر DriverContext واملأ الحقول المطلوبة.

   DriverContext driverContext = DriverContext.builder(application)
       .setProviderId(providerId)
       .setVehicleId(vehicleId)
       .setAuthTokenFactory(authTokenFactory)
       .setNavigator(navigator)
       .setRoadSnappedLocationProvider(
           NavigationApi.getRoadSnappedLocationProvider(application))
       .build();
   

3. استخدِم عنصر DriverContext لإعداد *DriverApi.

4. الحصول على NavigationVehicleReporter من عنصر واجهة برمجة التطبيقات *VehicleReporter يمتد إلى NavigationVehicleReporter.

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

في الإصدارات السابقة، كان عليك تفعيل تعديلات الموقع الجغرافي بعد الحصول على مرجع FleetEngine. في الإصدار 4 من حزمة Driver SDK، فعِّل تعديلات الموقع الجغرافي على النحو التالي:

عند انتهاء وردية السائق، أوقِف تحديثات الموقع الجغرافي وصنِّف السيارة على أنّها غير متصلة بالإنترنت من خلال الاتصال بالرقم NavigationVehicleReporter.disableLocationTracking().

الإبلاغ عن الأخطاء باستخدام StatusListener

تمت إزالة السمة ErrorListener ودمجها مع السمة StatusListener، التي يمكن تعريفها على النحو التالي:

class MyStatusListener implements StatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
      StatusLevel statusLevel, StatusCode statusCode, String statusMsg) {
    // Status handling stuff goes here.
    // StatusLevel may be DEBUG, INFO, WARNING, or ERROR.
    // StatusCode may be DEFAULT, UNKNOWN_ERROR, VEHICLE_NOT_FOUND,
    // BACKEND_CONNECTIVITY_ERROR, or PERMISSION_DENIED.
  }
}