JavaScript Consumer SDK के बारे में खास जानकारी

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: सामान्य गलतियां

  • समस्या: अगर आपने 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 में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.