הפעלה של ה-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)
         [e-mail] = 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 מהאובייקט של ה-API. (DeliveryVehicleReporter נמשך NavigationVehicleReporter.)

   DeliveryVehicleReporter vehicleReporter = driverApi.getDeliveryVehicleReporter();
   

הערות לגבי SSL/TLS

באופן פנימי, בהטמעה של Driver SDK נעשה שימוש SSL או TLS לתקשורת מאובטחת עם שירות Fleet Engine. ממשק API של Android גרסה 23 או מוקדם יותר ייתכן שיהיה צורך בתיקון של SecurityProvider כדי לתקשר עם השרת. למידע נוסף על עבודה עם SSL ב-Android, ראו Security GMS Provider. המאמר גם מכיל דוגמאות קוד לתיקון ספק האבטחה.

המאמרים הבאים

הכנת הרכב