iOS के लिए Driver SDK टूल का क्विक रेफ़रंस

iOS के लिए Driver SDK, एक मोबाइल ऐप्लिकेशन टूलकिट है. यह Fleet Engine का एक कॉम्पोनेंट है. यह ड्राइवर ऐप्लिकेशन से वाहन की जगह की जानकारी, रास्ता, वेपॉइंट, बची हुई दूरी, और ईटीए को Navigation SDK से Fleet Engine को भेजता है. ऐसा, मांग पर की जाने वाली यात्राओं और शेड्यूल किए गए टास्क के लिए किया जाता है.

iOS के लिए Driver SDK: मुख्य बातें

  • प्रॉडक्ट: iOS के लिए Driver SDK
  • इसे इस नाम से भी जाना जाता है: ड्राइवर एसडीके, मांग पर यात्राओं के लिए ड्राइवर एसडीके, शेड्यूल किए गए टास्क के लिए ड्राइवर एसडीके
  • कैटगरी: रास्ते
  • प्लैटफ़ॉर्म: iOS
  • इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: iOS के लिए Driver SDK के बारे में खास जानकारी

iOS के लिए Driver SDK: इसका इस्तेमाल कब करना चाहिए

iOS के लिए Driver SDK का इस्तेमाल तब करें, जब:

  • Fleet Engine को वाहन की जगह की जानकारी के रीयल-टाइम अपडेट भेजने के लिए, आपको iOS ड्राइवर ऐप्लिकेशन की ज़रूरत होगी.
  • आपको नेविगेशन SDK से Fleet Engine को रास्ते, वेपॉइंट, बची हुई दूरी, और ईटीए की जानकारी देनी होगी.
  • आपको ड्राइवर की ज़रूरत है, ताकि वे असाइन की गई मांग पर यात्राओं को मैनेज कर सकें और एक ही ऐप्लिकेशन में नेविगेट कर सकें.
  • आपको iOS पर, Fleet Engine के शेड्यूल किए गए टास्क के लिए ड्राइवर ऐप्लिकेशन बनाना है.

iOS के लिए Driver SDK का इस्तेमाल तब न करें, जब:

  • आपको अपने iOS ऐप्लिकेशन में सिर्फ़ रास्ते के दिशा-निर्देशों की सुविधा चाहिए, न कि Fleet Engine ट्रैकिंग की सुविधा. इसके बजाय, iOS के लिए Navigation SDK का इस्तेमाल करें.
  • आपको उपभोक्ता ऐप्लिकेशन में, राइडर या ग्राहक को यात्रा या डिलीवरी की प्रोग्रेस दिखानी है. इसके बजाय, iOS के लिए Consumer SDK का इस्तेमाल करें.
  • आपको जगह की जानकारी और रास्ते के अलावा, वाहन के डेटा से जुड़े अपडेट भेजने होंगे. ये अपडेट, आपके बैकएंड से Fleet Engine को भेजे जाते हैं. इसके बजाय, Fleet Engine Service का इस्तेमाल करें.
  • ड्राइवर ऐप्लिकेशन, Android पर काम करता है. इसके बजाय, Driver SDK for Android का इस्तेमाल करें.

iOS के लिए Driver SDK: सेटअप

iOS पैकेज के लिए आधिकारिक Driver SDK टूल:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

iOS के लिए Driver SDK: सामान्य गलतियां

  • समस्या: स्टार्टअप के बाद, वाहन की जानकारी पहली बार अपडेट करने पर, 'update_mask खाली नहीं हो सकता' गड़बड़ी का मैसेज मिल सकता है. ऐसा तब होता है, जब updateMask पैरामीटर खाली हो. ठीक करने का तरीका: updateMask में हमेशा कम से कम एक फ़ील्ड का नाम दें. साथ ही, इस गड़बड़ी को GMTDVehicleReporterListener didFailVehicleUpdate में ठीक करें. /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot देखें.
  • समस्या: GMSRoadSnappedLocationProvider, जगह की जानकारी के अपडेट भेजना बंद कर देता है. ऐसा तब होता है, जब पिछली बार अपडेट मिलने के बाद से डिवाइस की जगह में कोई बदलाव न हुआ हो. उदाहरण के लिए, जब ड्राइवर इंतज़ार कर रहा हो. ठीक करने का तरीका: डिवाइस के एक ही जगह पर होने के दौरान, जगह की जानकारी का नया अपडेट भेजने के लिए, GMSRoadSnappedLocationProvider को रोकें और फिर से चालू करें. साथ ही, GMTDVehicleReporter को पहले से ही इसके लिसनर के तौर पर जोड़ें. /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready देखें.
  • समस्या: अगर setDestinations() को पास किए गए निर्देशांक, यात्रा के वेपॉइंट से मैच नहीं होते हैं, तो उपभोक्ता ऐप्लिकेशन, यात्रा को सही तरीके से रेंडर नहीं करता है. ठीक करने का तरीका: पक्का करें कि setDestinations() को पास किया गया अक्षांश/देशांतर, Fleet Engine में यात्रा के वेपॉइंट के निर्देशांकों से मेल खाता हो. /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details देखें.
  • समस्या: ऑप्टिमिस्टिक वर्शन ऑपरेटर (~>) का इस्तेमाल करने से, ऐसे बिल्ड बन सकते हैं जिनके बारे में अनुमान नहीं लगाया जा सकता और जिन्हें दोहराया नहीं जा सकता. साथ ही, वर्शन को शामिल न करने से सबसे नया एसडीके लोड होता है. इसमें नुकसान पहुंचा सकने वाले बदलाव शामिल हो सकते हैं या iOS का ज़रूरी वर्शन बढ़ सकता है. Carthage का इस्तेमाल नहीं किया जा सकता. समाधान: CocoaPods या Swift Package Manager में, Driver SDK का कोई सटीक वर्शन पिन करें. साथ ही, अपग्रेड करने से पहले रिलीज़ नोट देखें. /maps/documentation/mobility/driver-sdk/on-demand/ios/versions देखें.

iOS के लिए Driver SDK: लेगसी और अब काम नहीं करने वाली सुविधाएं

  • GMTSVehicleMatch क्लास: अब काम नहीं करता. बदलाव: ड्राइवर SDK टूल में कोई बदलाव करने की ज़रूरत नहीं है. वाहन की मैचिंग, Fleet Engine में मैनेज की जाती है. लक्षण: इसे Driver SDK for iOS के 2.2.0 वर्शन में बंद कर दिया गया है. साथ ही, इसे मौजूदा Driver SDK के रेफ़रंस से हटा दिया गया है. माइग्रेट करने से जुड़ी गाइड देखें.
  • GMTSServiceType और fetchAuthTokenForServiceType:authorizationContext:completion:: 29-11-2021 से इस्तेमाल नहीं किए जा सकते. बदलाव: GMTDAuthorization fetchTokenWithContext:completion: को GMTDAuthorizationContext से बदलें (सिर्फ़ वाहन के आईडी के लिए दावे). माइग्रेट करने से जुड़ी गाइड देखें.

iOS के लिए Driver SDK की मदद से क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.