הפעלה של ה-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.

    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. המאמר גם מכיל דוגמאות קוד לתיקון ספק האבטחה.

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

הכנת הרכב