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 Service: रिलेटेड प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Driver SDK for Android, Driver SDK for iOS, Consumer SDK for Android, Consumer SDK for iOS, JavaScript Consumer SDK, Route Optimization API
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 APIreportBillableEvent. लक्षण: यह समस्या, एपीआई के बंद होने की वजह से नहीं, बल्कि कॉन्ट्रैक्ट की वजह से होती है. माइग्रेशन के बाद, कॉल करने पर यह गड़बड़ी दिख सकती है: "अनुबंध अमान्य है: इस प्रोजेक्ट [...] को FleetEngine का इस्तेमाल करने की अनुमति नहीं है.". माइग्रेट करने से जुड़ी गाइड देखें.
Fleet Engine सेवा की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- Fleet Engine की मदद से की गई यात्राओं के इस्तेमाल की रिपोर्ट करना, जिनके लिए शुल्क लिया जा सकता है.
- Fleet Engine में नई यात्रा बनाएं और उसे वापस करें.
- Fleet Engine की किसी यात्रा की जानकारी दिखाएं.
- किसी वाहन के लिए, Fleet Engine की सभी यात्राओं की सूची दिखाएं.
- Fleet Engine की किसी यात्रा के लिए, यात्रा का डेटा अपडेट करना.
- Fleet Engine में, मांग पर राइड शेयर करने या डिलीवरी की सेवा देने वाली कंपनी से जुड़े नए वाहन को इंस्टैंशिएट करना.
- Fleet Engine सेवा से वाहन की जानकारी पाना.
- Fleet Engine में मौजूद वाहनों की सूची को पेजों में बांटकर दिखाता है. इस सूची में, सेवा देने वाली कंपनी से जुड़े ऐसे वाहन शामिल होते हैं जो तय की गई शर्तों को पूरा करते हैं.
- Fleet Engine में मौजूद उन वाहनों की सूची दिखाता है जो तय की गई शर्तों के मुताबिक हैं.
- Fleet Engine में किसी वाहन का डेटा अपडेट करना.
- Fleet Engine में किसी वाहन के एट्रिब्यूट अपडेट करना.
- Fleet Engine सेवा से, किसी वाहन की वापसी यात्रा की जानकारी पाना.