إعداد Driver SDK

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

   DeliveryDriverApi driverApi = DeliveryDriverApi.createInstance(driverContext);
   

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

   DeliveryVehicleReporter vehicleReporter = driverApi.getDeliveryVehicleReporter();
   

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

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

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

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