إعداد Driver SDK

قبل استخدام Driver SDK، يجب أولاً تهيئة Navigation SDK وDriver 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;
      }
    }
);

    Kotlin

    NavigationApi.getNavigator(
  this, // Activity
  object : NavigatorListener() {
    override fun onNavigatorReady(navigator: Navigator) {
      // Keep a reference to the Navigator (used to configure and start nav)
      this@myActivity.navigator = navigator
    }
  },
)

  2. أنشئ عنصر DriverContext واملأ الحقول المطلوبة. لتهيئة عنصر DriverContext، يجب إدخال رقم تعريف المشروع لمشروعك على Google Cloud كـ providerId. للحصول على معلومات حول إعداد مشروع Google Cloud، يُرجى الاطّلاع على مقالة إنشاء مشروع Fleet Engine.

    جافا

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

    Kotlin

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

  3. استخدِم عنصر DriverContext لتهيئة *DriverApi.

    جافا

    RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);

    Kotlin

    val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)

  4. احصل على RidesharingVehicleReporter من عنصر واجهة برمجة التطبيقات. (يرث *VehicleReporter من NavigationVehicleReporter.)

    جافا

    RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();

    Kotlin

    val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()

ملاحظات حول طبقة المقابس الآمنة/طبقة النقل الآمنة

داخليًا، يستخدم تنفيذ Driver SDK طبقة المقابس الآمنة/طبقة النقل الآمنة للتواصل بأمان مع خدمة Fleet Engine. قد تتطلّب إصدارات Android API 23 أو الإصدارات الأقدم تصحيح SecurityProvider للتواصل مع الخادم. لمزيد من المعلومات حول استخدام طبقة المقابس الآمنة في Android، يُرجى الاطّلاع على مقالة Security GMS Provider. تحتوي المقالة أيضًا على نماذج للتعليمات البرمجية لتصحيح موفّر الأمان.

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

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