Fleet Engine सेवा के बारे में खास जानकारी

Fleet Engine एक बैकएंड सेवा है, जो आपके वाहनों के बेड़े को मॉडल करती है. साथ ही, यह मांग पर यात्राओं और शेड्यूल किए गए टास्क के लिए, रास्ते, ईटीए, ट्रैफ़िक, और स्टेटस के अपडेट उपलब्ध कराती है. यह ड्राइवर एसडीके से जगह की जानकारी और रास्ते का डेटा इस्तेमाल करता है. साथ ही, यह उपभोक्ता एसडीके और Google Maps Platform के अन्य एपीआई के साथ काम करता है.

Fleet Engine सेवा: अहम जानकारी

  • प्रॉडक्ट: Fleet Engine सेवा
  • इसे इन नामों से भी जाना जाता है: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • कैटगरी: रास्ते
  • प्लैटफ़ॉर्म: वेब सेवा (REST)
  • इस पर चलता है: सर्वर (बैकएंड कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Fleet Engine सेवा के बारे में खास जानकारी

Fleet Engine सेवा: इसका इस्तेमाल कब करना चाहिए

Fleet Engine सेवा का इस्तेमाल तब करें, जब:

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

Fleet Engine की सेवा का इस्तेमाल तब न करें, जब:

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

Fleet Engine सेवा: सेटअप

  • चालू की जाने वाली सेवा: fleetengine.googleapis.com
  • पुष्टि करने का तरीका: सेवा खाता, JSON वेब टोकन (JWT), OAuth 2.0
  • इस्तेमाल का एट्रिब्यूशन: बीटा वर्शन में उपलब्ध यह सुविधा ज़रूरी नहीं है: मोबिलिटी पैकेज की सेवाओं को किए जाने वाले कॉल पर, X-Goog-Maps-Experience-ID एचटीटीपी हेडर को मोबिलिटी लेन-देन आईडी (या इससे जुड़े किसी आईडी, जैसे कि सेशन आईडी) पर सेट करें. एक से ज़्यादा आईडी को कॉमा लगाकर अलग करें. लेन-देन की जानकारी देते समय, related_ids में उससे जुड़े आईडी पास करें.
  • शुरू करें: Fleet Engine सेवा सेट अप करना
  • रेफ़रंस: Fleet Engine की सेवा का रेफ़रंस
  • नीतियां: Fleet Engine की सेवा से जुड़ी नीतियां
  • रिलीज़ नोट: Fleet Engine Service के रिलीज़ नोट

Fleet Engine सेवा के आधिकारिक पैकेज:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Fleet Engine सेवा: आम तौर पर होने वाली गलतियां

  • समस्या: Fleet Engine को किए गए अनुरोध कभी-कभी फ़ेल हो सकते हैं. ऐसा होने पर, हो सकता है कि वाहन जैसी इकाइयां अब मौजूद न हों (NOT_FOUND अपडेट करने पर). ठीक करने का तरीका: बैकऑफ़ के साथ फिर से कोशिश करें (क्लाइंट लाइब्रेरी डिफ़ॉल्ट रूप से फिर से कोशिश करती हैं). साथ ही, मौजूद न होने वाले वाहनों या टास्क को उनकी मौजूदा स्थिति में फिर से बनाएं. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot देखें.
  • समस्या: DEADLINE_EXCEEDED गड़बड़ियां तब होती हैं, जब किसी अनुरोध को पूरा होने में क्लाइंट लाइब्रेरी के डिफ़ॉल्ट टाइम आउट से ज़्यादा समय लगता है. ठीक करने का तरीका: आरपीसी को फिर से कोशिश करने की सेटिंग में बदलाव करें. उदाहरण के लिए, Java क्लाइंट में VehicleServiceSettings पर setTotalTimeout. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot देखें.
  • समस्या: PERMISSION_DENIED (एचटीटीपी 403) तब दिखता है, जब JWT में सही दावे मौजूद न हों या साइनिंग सेवा खाते के पास Fleet Engine IAM की ज़रूरी भूमिका न हो. उदाहरण के लिए, "JWT में, अनुरोध की गई यात्रा के लिए मैच होने वाला स्कोप मौजूद नहीं है". ठीक करने का तरीका: सेवा खाते की भूमिकाएं देखें. साथ ही, पक्का करें कि JWT के दावों में, ऐक्सेस किए जा रहे वाहन, यात्रा या टास्क के स्कोप शामिल हों. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot देखें.
  • समस्या: On-Demand Rides and Deliveries से किसी भी मोबिलिटी पैकेज पर या Last Mile Fleet Solution से Mobility Activate या Optimize पर माइग्रेट करते समय, मोबिलिटी बिलिंग एपीआई के अनुरोधों के जवाब में एचटीटीपी 202 मिलता है. ऐसा तब तक होता है, जब तक माइग्रेशन पूरा नहीं हो जाता. साथ ही, बिलिंग नहीं होती. समाधान: माइग्रेशन से कुछ दिन पहले से लेकर माइग्रेशन के कुछ दिन बाद तक, Fleet Engine ReportBillableTrip और Mobility Billing API, दोनों को कॉल करें. इसके बाद, Cloud Logging में अनुरोधों की संख्या की तुलना करें और फिर ReportBillableTrip कॉल हटाएं. /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration देखें.

Fleet Engine Service: लेगसी और अब काम न करने वाली सुविधाएं

  • UpdateVehicleLocation तरीका: यह तरीका 1 मई, 2024 से बंद कर दिया गया है. बदलाव: VehicleService में UpdateVehicle. Symptom: इसे 1 फ़रवरी, 2024 को बंद कर दिया गया है. मई 2024 में इसे पूरी तरह से हटा दिया जाएगा.
  • SearchFuzzedVehicles तरीका: यह तरीका 1 मई, 2024 से बंद कर दिया गया है. बदलाव: VehicleService में SearchVehicles. Symptom: इसे 1 फ़रवरी, 2024 को बंद कर दिया गया है. मई 2024 में इसे पूरी तरह से हटा दिया जाएगा.
  • SearchTasks तरीका: यह तरीका 1 मई, 2024 से बंद कर दिया गया है. बदलाव: DeliveryService में GetTaskTrackingInfo. Symptom: इसे 1 फ़रवरी, 2024 को बंद कर दिया गया है. मई 2024 में इसे पूरी तरह से हटा दिया जाएगा.
  • मोबिलिटी पैकेज (ऑन-डिमांड राइड और डिलीवरी से किसी भी पैकेज पर या लास्ट माइल फ़्लीट सलूशन से ऐक्टिवेट या ऑप्टिमाइज़ पर) पर माइग्रेट करने के बाद ReportBillableTrip: लेगसी. इसकी जगह इस्तेमाल करें: Mobility Billing API reportBillableEvent. लक्षण: यह समस्या, एपीआई के बंद होने की वजह से नहीं, बल्कि कॉन्ट्रैक्ट की वजह से होती है. माइग्रेशन के बाद, कॉल करने पर यह गड़बड़ी दिख सकती है: "अनुबंध अमान्य है: इस प्रोजेक्ट [...] को FleetEngine का इस्तेमाल करने की अनुमति नहीं है.". माइग्रेट करने से जुड़ी गाइड देखें.

Fleet Engine सेवा की मदद से क्या-क्या किया जा सकता है

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