Android ड्राइवर SDK 4.0 माइग्रेशन गाइड

Android 4.0 के लिए Driver SDK टूल के रिलीज़ होने के बाद, आपको कुछ कार्रवाइयों के लिए अपना कोड अपडेट करना होगा. इस गाइड में, कोड माइग्रेट करने के लिए किए जाने वाले बदलावों और ज़रूरी कार्रवाइयों के बारे में बताया गया है.

पैकेज का नाम बदलना

पैकेज का नाम com.google.android.libraries.ridesharing.driver से बदलकर com.google.android.libraries.mapsplatform.transportation.driver कर दिया गया है. कृपया अपने कोड में मौजूद रेफ़रंस अपडेट करें.

एसडीके टूल को शुरू करना

पिछले वर्शन में, आपको Navigation SDK टूल को शुरू करना होता था. इसके बाद, FleetEngine क्लास का रेफ़रंस पाना होता था. Driver SDK टूल के चौथे वर्शन में, एसडीके टूल को इस तरह शुरू करें:

1. NavigationApi से Navigator ऑब्जेक्ट पाएं.

   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;
         }
       }
   );
   

2. DriverContext ऑब्जेक्ट बनाएं और ज़रूरी फ़ील्ड में जानकारी भरें.

   DriverContext driverContext = DriverContext.builder(application)
       .setProviderId(providerId)
       .setVehicleId(vehicleId)
       .setAuthTokenFactory(authTokenFactory)
       .setNavigator(navigator)
       .setRoadSnappedLocationProvider(
           NavigationApi.getRoadSnappedLocationProvider(application))
       .build();
   

3. *DriverApi को शुरू करने के लिए, DriverContext ऑब्जेक्ट का इस्तेमाल करें.

4. एपीआई ऑब्जेक्ट से NavigationVehicleReporter पाएं. *VehicleReporter, NavigationVehicleReporter का एक्सटेंशन है.

जगह की जानकारी के अपडेट चालू और बंद करना

पिछले वर्शन में, FleetEngine का रेफ़रंस पाने के बाद, जगह की जानकारी के अपडेट चालू किए जाते थे. Driver SDK टूल के चौथे वर्शन में, जगह की जानकारी के अपडेट इस तरह चालू करें:

ड्राइवर की शिफ़्ट खत्म होने पर, जगह की जानकारी के अपडेट बंद करें. साथ ही, NavigationVehicleReporter.disableLocationTracking() को कॉल करके, वाहन को ऑफ़लाइन के तौर पर मार्क करें.

StatusListener की मदद से गड़बड़ी की रिपोर्ट करना

ErrorListener को हटा दिया गया है. इसे StatusListener के साथ जोड़ दिया गया है. इसे इस तरह से तय किया जा सकता है:

class MyStatusListener implements StatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
      StatusLevel statusLevel, StatusCode statusCode, String statusMsg) {
    // Status handling stuff goes here.
    // StatusLevel may be DEBUG, INFO, WARNING, or ERROR.
    // StatusCode may be DEFAULT, UNKNOWN_ERROR, VEHICLE_NOT_FOUND,
    // BACKEND_CONNECTIVITY_ERROR, or PERMISSION_DENIED.
  }
}