JavaScript Consumer SDK की मदद से, वेब पर आधारित उपभोक्ता ऐप्लिकेशन, Fleet Engine में ट्रैक किए गए वाहनों की जगह की जानकारी और दिलचस्पी वाले इलाकों की जानकारी को मैप पर दिखा सकता है. इससे उपभोक्ता, मांग पर की जाने वाली यात्रा या शेड्यूल किए गए शिपमेंट की प्रोग्रेस को ट्रैक कर सकते हैं. यह Maps JavaScript API की journeySharing लाइब्रेरी के तौर पर लोड होता है.
JavaScript Consumer SDK: मुख्य बातें
- प्रॉडक्ट: JavaScript Consumer SDK
- इसे इन नामों से भी जाना जाता है: JavaScript के लिए उपभोक्ता SDK, मांग पर यात्राओं के लिए परिवहन के लिए सेवा JavaScript, JavaScript SDK
- कैटगरी: रास्ते
- प्लैटफ़ॉर्म: JavaScript (ब्राउज़र)
- इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: JavaScript Consumer SDK के बारे में खास जानकारी
JavaScript Consumer SDK: इसका इस्तेमाल कब करना चाहिए
JavaScript Consumer SDK का इस्तेमाल तब करें, जब:
- आपको उपभोक्ताओं को किसी वेब पेज या वेब ऐप्लिकेशन में, Fleet Engine से ट्रैक की जाने वाली ऑन-डिमांड यात्रा के लिए, वाहन की लाइव जगह की जानकारी और रास्ता दिखाना होगा.
- आपको उपभोक्ताओं को ब्राउज़र में, Fleet Engine में ट्रैक किए गए शेड्यूल किए गए शिपमेंट के पिकअप या डिलीवरी की प्रोग्रेस को फ़ॉलो करने की अनुमति देनी होगी.
- आपको वेब पर आधारित मैप व्यू में, यात्रा के लिए ईटीए, बची हुई दूरी, और रास्ते पर लाइव ट्रैफ़िक दिखाना है.
- आपको वेब उपभोक्ता ट्रैकिंग व्यू में, यात्रा के मार्कर, रास्ते की पॉलीलाइन या मैप की स्टाइल को पसंद के मुताबिक बनाना है.
JavaScript Consumer SDK का इस्तेमाल तब न करें, जब:
- आपको नेटिव Android ऐप्लिकेशन में, यात्रा को फ़ॉलो करने वाले उपभोक्ता अनुभव की ज़रूरत है. इसके बजाय, Android के लिए Consumer SDK का इस्तेमाल करें.
- आपको iOS ऐप्लिकेशन में, यात्रा को फ़ॉलो करने की सुविधा चाहिए. इसके लिए, iOS के लिए Consumer SDK का इस्तेमाल करें.
- आपको ड्राइवर के Android ऐप्लिकेशन से Fleet Engine को, ड्राइवर की जगह की जानकारी और यात्रा की प्रोग्रेस की जानकारी देनी होगी. इसके बजाय, Driver SDK for Android का इस्तेमाल करें.
- आपको ड्राइवर के iOS ऐप्लिकेशन से, Fleet Engine को ड्राइवर की जगह की जानकारी और यात्रा की प्रोग्रेस की जानकारी देनी होगी. इसके बजाय, iOS के लिए Driver SDK का इस्तेमाल करें.
- आपको एक सामान्य वेब मैप चाहिए, जो Fleet Engine की यात्राओं या टास्क को ट्रैक न करता हो. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.
JavaScript Consumer SDK: सेटअप
- पुष्टि करना: एपीआई पासकोड, JSON वेब टोकन (JWT)
- इन्हें भी चालू करें: Maps JavaScript API, Fleet Engine Service
- इस्तेमाल का एट्रिब्यूशन: ज़रूरी नहीं (बीटा वर्शन) मोबिलिटी लेन-देन आईडी:
JourneySharingMapViewबनाने से पहले,google.maps.Settings.getInstance().experienceIdsको मोबिलिटी लेन-देन आईडी (या मिलते-जुलते आईडी) के कलेक्शन पर सेट करें.experienceIds, Maps JavaScript API के सिर्फ़v=betaचैनल में उपलब्ध है. - शुरू करें: JavaScript Consumer SDK टूल सेट अप करना
- रेफ़रंस: JavaScript Consumer SDK reference
- रिलीज़ नोट: JavaScript Consumer SDK के रिलीज़ नोट
JavaScript Consumer SDK: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Fleet Engine Service, Maps JavaScript API, Android के लिए Driver SDK, iOS के लिए Driver SDK
JavaScript Consumer SDK: सामान्य गलतियां
- समस्या: अगर आपने
JourneySharingMapViewमैप को शुरुआती व्यूपोर्ट (सेंटर और ज़ूम) नहीं दिया है, तो हो सकता है कि मैप का'ready'इवेंट ट्रिगर न हो. ठीक करने का तरीका: मैप व्यू बनाने के बाद,mapView.map.setCenter(...)औरmapView.map.setZoom(...)को कॉल करें. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey देखें. - समस्या: यात्रा की जानकारी के लिए, एसिंक्रोनस तरीके से किए गए अनुरोधों से जुड़ी गड़बड़ियां नहीं दिखती हैं. ये सिर्फ़ जगह की जानकारी देने वाली सेवा पर
'error'इवेंट के तौर पर आते हैं. इसलिए, जब तक कोई लिसनर नहीं जोड़ा जाता, तब तक इन पर ध्यान नहीं दिया जाता. समस्या ठीक करने का तरीका:locationProvider.addListener('error', ...)जोड़ें और लाइब्रेरी कॉल कोtry...catchब्लॉक में रैप करें. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey देखें. - समस्या:
google.maps.journeySharingक्लास तब तक उपलब्ध नहीं होतीं, जब तकjourneySharingलाइब्रेरी लोड नहीं की जाती. ठीक करने का तरीका: Maps JavaScript API स्क्रिप्ट के यूआरएल मेंlibraries=journeySharingजोड़ें याawait google.maps.importLibrary("journeySharing")का इस्तेमाल करके क्लास लोड करें. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey देखें. - समस्या: ब्राउज़र (कम भरोसेमंद प्लैटफ़ॉर्म) से Fleet Engine को किए जाने वाले कॉल के लिए, JWT की ज़रूरत होती है. ये JWT, आपके बैकएंड सर्वर से जारी किए जाते हैं. सिर्फ़ एपीआई पासकोड से, यात्रा के डेटा को ऐक्सेस करने की अनुमति नहीं मिलती. ठीक करने का तरीका: अपने बैकएंड से जेडब्ल्यूटी जारी करें और एक ऐसा
authTokenFetcherउपलब्ध कराएं जो टोकन औरexpiresInSecondsदिखाता हो. /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup देखें.
JavaScript Consumer SDK: लेगसी और अब काम न करने वाली सुविधाएं
JourneySharingMapViewऔरJourneySharingMapViewOptionsमार्कर और पॉलीलाइन सेटअप के विकल्प (vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetup, और अन्य): अब काम नहीं करते. बदलाव: जगह की जानकारी देने वाली सेवा (उदाहरण के लिए,vehicleMarkerCustomization) परMarkerCustomizationFunctionऔरPolylineCustomizationFunctionविकल्प. असर: आने वाले समय में रिलीज़ होने वाले वर्शन से हटा दिया जाएगा. माइग्रेट करने से जुड़ी गाइड देखें.JourneySharingMapView.locationProviderऔरJourneySharingMapViewOptions.locationProvider: अब काम नहीं करते. बदलाव:JourneySharingMapView.locationProvidersऔरJourneySharingMapViewOptions.locationProviders.JourneySharingMapViewमार्कर और पॉलीलाइन की सूची वाली प्रॉपर्टी (vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylines, और टास्क मार्कर वाली प्रॉपर्टी): अब सेवा में नहीं है. बदलाव: जगह की जानकारी देने वाली सेवा परMarkerCustomizationFunctionऔरPolylineCustomizationFunctionकॉलबैक. माइग्रेट करने से जुड़ी गाइड देखें.
JavaScript Consumer SDK की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- किसी वेब पेज या मोबाइल ऐप्लिकेशन पर मौजूद मैप पर, 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 से किसी यात्रा की प्रोग्रेस को ट्रैक करने वाले मैप पर, रास्ते की पॉलीलाइन को पसंद के मुताबिक बनाएं.