Method: projects.locations.optimizeToursUri

यह locations.optimizeToursLongRunning तरीके का एक वैरिएंट है. इसे टाइम आउट की बड़ी वैल्यू और बड़े इनपुट/आउटपुट साइज़ के साथ ऑप्टिमाइज़ेशन के लिए डिज़ाइन किया गया है.

क्लाइंट, Google Cloud Storage में सेव किए गए OptimizeToursRequest का यूआरआई तय करता है. इसके बाद, सर्वर, क्लाइंट की ओर से तय किए गए Google Cloud Storage यूआरआई में OptimizeToursResponse लिखता है.

अगर ऑप्टिमाइज़ेशन में कुछ मिनटों से ज़्यादा समय लगता है और इनपुट/आउटपुट का साइज़ 8 एमबी से ज़्यादा है, तो locations.optimizeTours तरीके के बजाय इस तरीके का इस्तेमाल करना चाहिए. हालांकि, इसका इस्तेमाल कम समय में होने वाले और छोटे ऑप्टिमाइज़ेशन के लिए भी किया जा सकता है.

जवाब में मिले long-running operation (एलआरओ) का नाम <parent>/operations/<operation_id> फ़ॉर्मैट में होगा. इसका इस्तेमाल, कंप्यूटेशन की प्रोग्रेस को ट्रैक करने के लिए किया जा सकता है. metadata फ़ील्ड टाइप OptimizeToursLongRunningMetadata है. अगर अनुरोध पूरा हो जाता है, तो response फ़ील्ड का टाइप OptimizeToursUriResponse होता है.

एक्सपेरिमेंट के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request पर जाएं.

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

फ़ॉर्मैट:

  • projects/{project-id}
  • projects/{project-id}/locations/{location-id}

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

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "input": {
    object (Uri)
  },
  "output": {
    object (Uri)
  }
}
फ़ील्ड
input

object (Uri)

ज़रूरी है. OptimizeToursRequest वाले Cloud Storage ऑब्जेक्ट का यूआरआई.
output

object (Uri)

ज़रूरी है. Cloud Storage ऑब्जेक्ट का यूआरआई, जिसमें OptimizeToursResponse शामिल होगा.

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

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

अनुमति पाने के लिंक

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

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

IAM अनुमतियां

parent रिसॉर्स पर, IAM से जुड़ी यह अनुमति ज़रूरी है:

  • routeoptimization.operations.create

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