إعداد Driver SDK

قبل استخدام حزمة تطوير البرامج (SDK) للسائق، عليك أولاً إعداد حزمة تطوير البرامج (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;
      }
    }
);

    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()

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

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

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

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