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: सेटअप
- पुष्टि करना: JSON वेब टोकन (JWT)
- इसे भी चालू करें: Fleet Engine Service
- शुरू करें: iOS के लिए Consumer SDK टूल सेट अप करना
- रेफ़रंस: iOS के लिए Consumer SDK टूल का रेफ़रंस
- नीतियां: iOS के लिए Consumer SDK की नीतियां
- रिलीज़ नोट: iOS के लिए Consumer SDK के रिलीज़ नोट
iOS पैकेज के लिए आधिकारिक Consumer SDK टूल:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
iOS के लिए Consumer SDK: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Fleet Engine Service, iOS के लिए Driver SDK, Android के लिए Driver SDK, iOS के लिए Maps 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}फ़ॉर्मैट का इस्तेमाल नहीं किया जाता है, तो यात्रा की निगरानी करने की सुविधा काम नहीं करती और 400INVALID_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 में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- अपनी पसंद के मुताबिक बनाया जा सकने वाला इंटरैक्टिव मैप जोड़ें. यह मैप, Fleet Engine से मोबाइल ऐप्लिकेशन तक की यात्रा की प्रोग्रेस को ट्रैक करता है.
- किसी वेब पेज या मोबाइल ऐप्लिकेशन पर मौजूद मैप पर, Fleet Engine से यात्रा को ट्रैक करने वाली रूट पॉलीलाइन जोड़ें.
- Fleet Engine की मदद से बुक की गई यात्रा के लिए, वेब पेज या मोबाइल ऐप्लिकेशन पर मैप में किसी रास्ते पर यात्रा की प्रोग्रेस अपडेट करना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, सड़कों, पॉलीलाइन, और पॉलीगॉन की स्टाइल बदलना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, मैप की सुविधाएं दिखाएं या छिपाएं.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, आइकॉन और टेक्स्ट लेबल की स्टाइल बदलना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, ज़ूम करने के अलग-अलग लेवल के लिए अलग-अलग मैप स्टाइल लागू करना.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, जगहों की डेंसिटी बदलना. एक्सपेरिमेंटल ध्यान दें: Consumer SDK में, क्लाउड पर आधारित मैप स्टाइलिंग की सुविधा GA है. वहीं, लोकप्रिय जगहों की डेंसिटी कंट्रोल करने की सुविधा, क्लाउड पर आधारित मैप स्टाइलिंग की एक्सपेरिमेंटल सुविधा है. यह सुविधा सिर्फ़ लाइट मैप स्टाइल पर काम करती है.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, बिल्डिंग की स्टाइल बदलें. एक्सपेरिमेंटल ध्यान दें: Consumer SDK में, क्लाउड पर मैप की स्टाइलिंग की सुविधा, सामान्य तौर पर उपलब्ध है. हालांकि, 3D और फ़ुटप्रिंट बिल्डिंग स्टाइल को पसंद के मुताबिक बनाने की सुविधा, क्लाउड पर मैप की स्टाइलिंग की एक एक्सपेरिमेंटल सुविधा है. यह सुविधा सिर्फ़ लाइट मैप स्टाइल पर काम करती है.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, लैंडमार्क की स्टाइल बदलना. एक्सपेरिमेंटल ध्यान दें: Consumer SDK में, क्लाउड पर मैप की स्टाइलिंग की सुविधा GA है. वहीं, लैंडमार्क आइकॉन को पसंद के मुताबिक बनाने की सुविधा, क्लाउड पर मैप की स्टाइलिंग की एक्सपेरिमेंटल सुविधा है. यह सुविधा सिर्फ़ लाइट मैप स्टाइल पर काम करती है.
- मैप पर मार्कर को पसंद के मुताबिक बनाएं. इससे Fleet Engine से यात्रा की प्रोग्रेस को ट्रैक किया जा सकता है.
- Fleet Engine से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, रास्ते की पॉलीलाइन को पसंद के मुताबिक बनाएं.