Method: projects.batchOptimizeTours

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

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

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

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

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

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

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}: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 दस्तावेज़ देखें.