إعداد Driver SDK

قبل استخدام Driver SDK، يجب أولاً إعداد Navigation SDK وDriver SDK باتّباع الخطوات التالية:

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

   Java

   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.

   Java

   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.

   Java

   RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);
   

   Kotlin

   val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)
   

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

   Java

   RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
   

   Kotlin

   val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
   

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

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

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

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