إعداد 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()

ملاحظات حول بروتوكول أمان طبقة النقل (TLS) / طبقة المقابس الآمنة (SSL)

تستخدم عملية تنفيذ Driver SDK داخليًا بروتوكول SSL/TLS للتواصل بشكل آمن مع خدمة Fleet Engine. قد تتطلّب إصدارات واجهة برمجة التطبيقات (API) لنظام التشغيل Android 23 أو الإصدارات الأقدم SecurityProvider لتتمكّن من التواصل مع الخادم. لمزيد من المعلومات حول استخدام طبقة المقابس الآمنة في Android، يُرجى الاطّلاع على موفّر خدمات Google للأجهزة الجوّالة (GMS) للأمان. تحتوي المقالة أيضًا على عيّنات من الرموز البرمجية لتصحيح موفّر الأمان.

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

تحضير المركبة