Method: projects.locations.batchOptimizeTours

बैच के तौर पर एक या उससे ज़्यादा OptimizeToursRequest मैसेज के लिए, वाहन के टूर को ऑप्टिमाइज़ करता है.

यह तरीका, लंबे समय तक चलने वाला ऑपरेशन (एलआरओ) है. ऑप्टिमाइज़ेशन (OptimizeToursRequest मैसेज) और आउटपुट (OptimizeToursResponse मैसेज) के इनपुट, उपयोगकर्ता के तय किए गए फ़ॉर्मैट में Cloud Storage से पढ़े और उसमें लिखे जाते हैं. locations.optimizeTours वाले तरीके की तरह, हर OptimizeToursRequest में एक ShipmentModel होता है और वह OptimizeToursResponse दिखाता है जिसमें ShipmentRoute फ़ील्ड होते हैं. ये फ़ील्ड, रास्तों का वह सेट होता है जिस पर जाने वाले वाहनों की मदद से, कुल लागत को कम से कम किया जाता है.

उपयोगकर्ता, एलआरओ का स्टेटस देखने के लिए operations.get को पोल कर सकता है:

अगर एलआरओ done फ़ील्ड गलत है, तो इसका मतलब है कि कम से कम एक अनुरोध अब भी प्रोसेस किया जा रहा है. ऐसा हो सकता है कि अन्य अनुरोध पूरे हो गए हों और उनके नतीजे Cloud Storage में उपलब्ध हों.

अगर एलआरओ का done फ़ील्ड 'सही' है, तो इसका मतलब है कि सभी अनुरोध प्रोसेस हो गए हैं. प्रोसेस हो चुके हर अनुरोध के नतीजे, Cloud Storage में उपलब्ध होंगे. पूरे न हो पाने वाले किसी भी अनुरोध के नतीजे, Cloud Storage में उपलब्ध नहीं होंगे. अगर एलआरओ का error फ़ील्ड सेट है, तो इसमें फ़ेल हो चुके अनुरोधों में से किसी एक की गड़बड़ी शामिल होती है.

एचटीटीपी अनुरोध

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:batchOptimizeTours

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. कॉल करने के लिए, टारगेट किया गया प्रोजेक्ट और जगह.

फ़ॉर्मैट: * projects/{project-id} * projects/{project-id}/locations/{location-id}

अगर किसी जगह की जानकारी नहीं दी गई है, तो कोई इलाका अपने-आप चुन लिया जाएगा.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "modelConfigs": [
    {
      object (AsyncModelConfig)
    }
  ]
}
फ़ील्ड
modelConfigs[]

object (AsyncModelConfig)

ज़रूरी है. हर खरीदारी मॉडल के इनपुट/आउटपुट की जानकारी, जैसे कि फ़ाइल पाथ और डेटा फ़ॉर्मैट.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

IAM अनुमतियां

parent संसाधन पर, इस IAM अनुमति की ज़रूरत होती है:

  • routeoptimization.operations.create

ज़्यादा जानकारी के लिए, IAM दस्तावेज़ देखें.