הפעלה של ה-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 מאובייקט ה-API. (*VehicleReporter extends NavigationVehicleReporter.)

   Java

   RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
   

   Kotlin

   val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
   

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

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

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

הכנת הרכב