iOS के लिए Consumer SDK टूल की खास जानकारी

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

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

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

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

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

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

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

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

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

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

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

iOS के लिए Consumer SDK: आम गलतियां

  • समस्या: अगर JWT पर यात्रा आईडी के बिना हस्ताक्षर किया गया है या उसकी समयसीमा खत्म हो गई है, तो यात्रा की निगरानी करने की सुविधा काम नहीं करती. साथ ही, 401 UNAUTHENTICATED गड़बड़ी का मैसेज दिखता है. ठीक करने का तरीका: टोकन देने वाली कंपनी (GMTCAuthorization) से कहें कि वह अनुमति देने के कॉन्टेक्स्ट में, यात्रा के आईडी के लिए जारी किया गया JWT दिखाए. साथ ही, हर यात्रा के लिए उसे कैश मेमोरी में सेव करे और समयसीमा खत्म होने पर उसे रीफ़्रेश करे. /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk देखें.
  • समस्या: अगर यात्रा के नाम में providers/{provider_id}/trips/{trip_id} फ़ॉर्मैट का इस्तेमाल नहीं किया जाता है, तो यात्रा की निगरानी करने की सुविधा काम नहीं करती और 400 INVALID_ARGUMENT गड़बड़ी का कोड दिखता है. ठीक करने का तरीका: Google Cloud प्रोजेक्ट आईडी को provider_id के तौर पर इस्तेमाल करें. साथ ही, एसडीके को शुरू करते समय, उसी प्रोजेक्ट आईडी को providerID के तौर पर पास करें. /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk देखें.
  • समस्या: यात्रा पूरी होने या रद्द होने के बाद भी, ऐप्लिकेशन अपडेट के लिए इंतज़ार करता रहता है. ठीक करने का तरीका: यात्रा पूरी होने या रद्द होने पर, यात्रा के मॉडल में unregisterSubscriber को कॉल करें. /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey देखें.
  • समस्या: XCFramework को मैन्युअल तरीके से इंस्टॉल करने पर, ज़रूरी रिसॉर्स बंडल और बिल्ड सेटिंग शामिल नहीं होती हैं. ऐसा तब तक होता है, जब तक उन्हें Xcode में नहीं जोड़ा जाता. समस्या हल करने का तरीका: जहां हो सके वहां CocoaPods का इस्तेमाल करें. मैन्युअल तरीके से इंस्टॉल करने के लिए, प्रोजेक्ट में gRPCCertificates.bundle और GoogleRidesharingConsumer.bundle जोड़ें. साथ ही, सूची में दिए गए फ़्रेमवर्क को लिंक करें. इसके बाद, डीबग और रिलीज़ के लिए, Other Linker Flags में -ObjC जोड़ें. /maps/documentation/mobility/journey-sharing/on-demand/ios/setup देखें.

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

  • GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute: initializer: Deprecated since 2025-06-01. बदलाव: GMTSVehicleLocation -initWithOptions: को GMTSVehicleLocationOptions से बदलें.
  • [GMTCMapView initWithCoder]: 1 दिसंबर, 2023 से इस्तेमाल नहीं किया जा सकता. बदलाव: GMTCMapView -initWithOptions:.

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

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