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

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

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

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

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

पिछले वर्शन में, Navigation SDK को शुरू किया जाता था. इसके बाद, FleetEngine क्लास का रेफ़रंस मिलता था. Driver SDK v3 में, 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 v3 में, जगह की जानकारी के अपडेट को इस तरह चालू करें:

रिपोर्टिंग इंटरवल को अपडेट करने के लिए, RidesharingVehicleReporter.setLocationReportingInterval(long, TimeUnit) या DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit) का इस्तेमाल करें.

ड्राइवर की ड्यूटी खत्म होने पर, जगह की जानकारी के अपडेट बंद करें और 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.
  }
}