Method: projects.locations.batchOptimizeTours

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

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

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

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

अगर एलआरओ का done फ़ील्ड 'सही' है, तो इसका मतलब है कि सभी अनुरोध प्रोसेस हो गए हैं. जिन अनुरोधों को प्रोसेस कर लिया गया है उनके नतीजे GCS में उपलब्ध होंगे. जिन अनुरोधों को पूरा नहीं किया जा सका उनके नतीजे GCS में उपलब्ध नहीं होंगे. अगर एलआरओ का 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 दस्तावेज़ देखें.