Route Optimization API, वाहनों के बेड़े को टास्क और रास्ते असाइन करता है. यह आपके तय किए गए लक्ष्यों और सीमाओं के हिसाब से ऑप्टिमाइज़ करता है. जैसे, समयसीमा, वाहन की क्षमता, ड्राइवर के काम करने के घंटे, और लागत. इसे REST, gRPC या क्लाइंट लाइब्रेरी के ज़रिए कॉल किया जाता है. इसके बाद, यह विज़िट के क्रम, शिपमेंट असाइनमेंट, अनुमानित समय, और रूट मेट्रिक दिखाता है.
Route Optimization API: मुख्य बातें
- प्रॉडक्ट: Route Optimization API
- इसे इस नाम से भी जाना जाता है: GMPRO
- कैटगरी: रास्ते
- प्लैटफ़ॉर्म: वेब सेवा (REST)
- इस पर चलता है: सर्वर (बैकएंड कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: Route Optimization API के बारे में खास जानकारी
Route Optimization API: इसका इस्तेमाल कब करना चाहिए
Route Optimization API का इस्तेमाल तब करें, जब:
- आपको कई वाहनों को शिपमेंट या टास्क असाइन करने होंगे. साथ ही, समयसीमा, वाहन की क्षमता, ड्राइवर के काम करने के घंटे, और लागत का ध्यान रखना होगा.
- आपको एक वाहन के लिए, कई पिकअप, डिलीवरी या अपॉइंटमेंट के लिए स्टॉप का सबसे सही क्रम चाहिए.
- आपको
injectedFirstSolutionRoutesयाinjectedSolutionConstraintका इस्तेमाल करके, नए ऑर्डर (जैसे, मांग पर डिस्पैच करना) के लिए, चालू रूट को फिर से ऑप्टिमाइज़ करना होगा. - ऑप्टिमाइज़ किए गए प्लान के हर चरण के लिए, आपको रूट टोकन की ज़रूरत होती है, ताकि उन्हें Navigation SDK को पास किया जा सके.
Route Optimization API का इस्तेमाल तब न करें, जब:
- आपको इस बात की लाइव ट्रैकिंग करनी है कि ड्राइवर, प्लान को कैसे लागू करते हैं. हालांकि, एपीआई, प्लान की गई पॉलीलाइन दिखाता है, न कि वाहन के रीयल-टाइम रास्ते. इसके बजाय, Fleet Engine Service का इस्तेमाल करें.
- आपको ऑप्टिमाइज़ किए गए रास्ते पर, ड्राइवर को मोड़-दर-मोड़ दिशा-निर्देश देने के लिए, इन-ऐप्लिकेशन गाइडेंस की ज़रूरत है. इसके बजाय, Android के लिए Navigation SDK का इस्तेमाल करें.
- आपको iOS पर ड्राइवर के लिए, ऑप्टिमाइज़ किए गए रास्ते के साथ-साथ ऐप्लिकेशन में मोड़-दर-मोड़ दिशा-निर्देश देने की सुविधा चाहिए. इसके बजाय, iOS के लिए Navigation SDK का इस्तेमाल करें.
Route Optimization API: सेटअप
- चालू की जाने वाली सेवा:
routeoptimization.googleapis.com - पुष्टि करने का तरीका: OAuth 2.0, सेवा खाता
- शुरू करें: Route Optimization API सेट अप करना
- रेफ़रंस: Route Optimization API का रेफ़रंस
- कीमत: Route Optimization API का इस्तेमाल और बिलिंग
- नीतियां: Route Optimization API की नीतियां
- रिलीज़ नोट: Route Optimization API के रिलीज़ नोट
Route Optimization API के आधिकारिक पैकेज:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: मिलते-जुलते प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Android के लिए Navigation SDK, iOS के लिए Navigation SDK, Fleet Engine Service, Maps JavaScript API
Route Optimization API: सामान्य गलतियां
- समस्या: ब्लॉक करने वाले
OptimizeToursएंडपॉइंट पर REST कॉल के लिए, 60 सेकंड की डिफ़ॉल्ट समयसीमा, अनुरोध के मुख्य हिस्सेtimeoutमें मौजूद 60 सेकंड से ज़्यादा की समयसीमा को बदल देती है. ठीक करने का तरीका: समयसीमा बढ़ाने के लिए,X-Server-Timeoutहेडर (सेकंड, सफ़िक्स के तौर पर "s" नहीं) सेट करें. क्लाइंट लाइब्रेरी और gRPC के लिए, डिफ़ॉल्ट रूप से 3,600 सेकंड सेट होते हैं. /maps/documentation/route-optimization/timeouts देखें. - समस्या:
timeoutऔर समयसीमा की वैल्यू, 1,800 सेकंड पर सेट हैं. ठीक करने का तरीका:allowLargeDeadlineDespiteInterruptionRiskकोtrueपर सेट करें, ताकि 3,600 सेकंड तक की अनुमति दी जा सके. हालांकि, ऐसा करने पर रुकावट आने की गड़बड़ियों का जोखिम बढ़ जाता है. /maps/documentation/route-optimization/timeouts देखें. - समस्या: लागत पैरामीटर (उदाहरण के लिए,
costPerHourयाcostPerKilometer) के बिना, ऑप्टिमाइज़र सभी समाधानों को एक जैसा मानता है. ठीक करने का तरीका: वाहनों के लिए, लागत के ऐसे पैरामीटर तय करें जो आपके कारोबार की लागत को दिखाते हों. /maps/documentation/route-optimization/make-first-request देखें. - समस्या: एपीआई पासकोड से पुष्टि किए गए अनुरोध पूरे नहीं हो पाते. हर अनुरोध के लिए, OAuth टोकन की ज़रूरत होती है. ठीक करने का तरीका:
https://www.googleapis.com/auth/cloud-platformस्कोप वाले OAuth टोकन का इस्तेमाल करें. उदाहरण के लिए, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल या सेवा खाते का इस्तेमाल करें. /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token देखें.
Route Optimization API की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- कई स्टॉप वाले डिलीवरी प्लान को ऑप्टिमाइज़ करें. इसके लिए, रास्ते, लागत, शिपमेंट, और वाहन से जुड़ी पाबंदियों को ध्यान में रखें.
- ऑप्टिमाइज़ किए गए डिलीवरी प्लान में, हर स्टॉप पर पहुंचने और वहां से निकलने का समय दिखाता है.
- ऑप्टिमाइज़ किए गए डिलीवरी प्लान में, हर स्टॉप के बीच यात्रा, देरी, ब्रेक, और इंतज़ार की अवधि की जानकारी पाना.
- ऑप्टिमाइज़ किए गए डिलीवरी प्लान में, हर स्टॉप पर वाहन के लोड की जानकारी दिखाएं.
- ऑप्टिमाइज़ किए गए डिलीवरी प्लान में, हर शिपमेंट के लिए रिटर्न की लागत की जानकारी.
- ऑप्टिमाइज़ किए गए डिलीवरी प्लान में, हर स्टॉप के बीच के रास्ते के लिए एन्कोड की गई पॉलीलाइन दिखाएं.
- ऑप्टिमाइज़ किए गए डिलीवरी प्लान में, हर स्टॉप के बीच के रास्ते के लिए नेविगेशन रूट टोकन दिखाएं.
- डिलीवरी के ऑप्टिमाइज़ किए गए प्लान के लिए, शिपमेंट, वाहन, और लागत की कुल मेट्रिक दिखाएं.
- एक से ज़्यादा जगहों पर डिलीवरी करने के प्लान के लिए, शुरू और खत्म होने की समयावधि तय करना.
- एक से ज़्यादा जगहों पर डिलीवरी करने के प्लान में, हर वाहन के लिए डिलीवरी शुरू और खत्म होने का समय और जगहों की जानकारी दें.
- एक से ज़्यादा स्टॉप वाले डिलीवरी प्लान में, हर वाहन के लिए समय के हिसाब से लगने वाले शुल्क की जानकारी दें.
- एक से ज़्यादा स्टॉप वाले डिलीवरी प्लान के लिए, कॉस्ट मॉडल के पैरामीटर तय करें.
- एक से ज़्यादा जगहों पर डिलीवरी करने के प्लान में, हर शिपमेंट के लिए पिकअप और डिलीवरी के समय की पाबंदियां तय करें.
- एक से ज़्यादा स्टॉप वाले डिलीवरी प्लान के लिए, वाहन असाइन करें.
- एक से ज़्यादा स्टॉप वाले डिलीवरी प्लान में, हर वाहन के लिए लोड की सीमाएं तय करें.
- यह तय करें कि एक से ज़्यादा स्टॉप वाले डिलीवरी प्लान के लिए, लाइव ट्रैफ़िक की जानकारी को ध्यान में रखना है या नहीं.
- एक से ज़्यादा स्टॉप वाले डिलीवरी प्लान को ऑप्टिमाइज़ करने के अनुरोध को बैच में प्रोसेस करना और जवाब को Google Cloud Storage में सेव करना.
- डिलीवरी करने से पहले, पार्किंग के लिए समय तय करें.
- आस-पास की जगहों पर एक के बाद एक विज़िट करने को प्राथमिकता दें.
- कई स्टॉप वाले रास्ते पर यू-टर्न लेने से बचें. एक्सपेरिमेंटल ध्यान दें: यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इस पर, pre-GA की शर्तें और सीमाएं लागू होती हैं.
- पहले से तय किए गए लक्ष्यों के लिए ऑप्टिमाइज़ करें. एक्सपेरिमेंटल ध्यान दें: यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इस पर, pre-GA की शर्तें और सीमाएं लागू होती हैं.
- ज़्यादा वज़न वाले शिपमेंट को पहले डिलीवर करें. एक्सपेरिमेंटल ध्यान दें: यह एक्सपेरिमेंटल सुविधा है. इस पर, pre-GA की शर्तें और सीमाएं लागू होती हैं.