Method: projects.locations.optimizeToursUri
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
यह locations.optimizeToursLongRunning
तरीके का एक वैरिएंट है. इसे ज़्यादा टाइम आउट वैल्यू और बड़े इनपुट/आउटपुट साइज़ के साथ ऑप्टिमाइज़ेशन के लिए डिज़ाइन किया गया है.
क्लाइंट, Google Cloud Storage में सेव किए गए OptimizeToursRequest
का यूआरआई तय करता है और सर्वर, OptimizeToursResponse
को क्लाइंट के तय किए गए Google Cloud Storage यूआरआई में लिखता है.
कुछ मिनट से ज़्यादा समय लेने वाले और इनपुट/आउटपुट साइज़ 8 एमबी से ज़्यादा वाले ऑप्टिमाइज़ेशन के लिए, locations.optimizeTours
तरीके के बजाय इस तरीके का इस्तेमाल करना चाहिए. हालांकि, इसका इस्तेमाल कम समय और छोटे ऑप्टिमाइज़ेशन के लिए भी किया जा सकता है.
दिखाए गए long-running operation
(LRO) का नाम <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 )
ज़रूरी है. उस Cloud Storage ऑब्जेक्ट का यूआरआई जिसमें OptimizeToursRequest मौजूद है.
|
output |
object (Uri )
ज़रूरी है. उस Cloud Storage ऑब्जेक्ट का यूआरआई जिसमें OptimizeToursResponse शामिल होगा.
|
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation
का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
IAM की अनुमतियां
parent
रिसॉर्स पर, IAM की इस अनुमति की ज़रूरत है:
routeoptimization.operations.create
ज़्यादा जानकारी के लिए, IAM दस्तावेज़ देखें.
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-08-31 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-08-31 (UTC) को अपडेट किया गया."],[],[],null,["# Method: projects.locations.optimizeToursUri\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nThis is a variant of the [locations.optimizeToursLongRunning](/maps/documentation/route-optimization/reference/rest/v1/projects.locations/optimizeToursLongRunning#google.maps.routeoptimization.v1.RouteOptimization.OptimizeToursLongRunning) method designed for optimizations with large timeout values and large input/output sizes.\n\nThe client specifies the URI of the `OptimizeToursRequest` stored in Google Cloud Storage and the server writes the `OptimizeToursResponse` to a client-specified Google Cloud Storage URI.\n\nThis method should be preferred over the `locations.optimizeTours` method for optimizations that take longer than a few minutes and input/output sizes that are larger than 8MB, though it can be used for shorter and smaller optimizations as well.\n\nThe returned [long-running operation](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation) (LRO) will have a name of the format `\u003cparent\u003e/operations/\u003coperation_id\u003e` and can be used to track progress of the computation. The [metadata](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation.FIELDS.metadata) field type is [OptimizeToursLongRunningMetadata](/maps/documentation/route-optimization/reference/rest/v1/OptimizeToursUriMetadata). The [response](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation.FIELDS.response) field type is [OptimizeToursUriResponse](/maps/documentation/route-optimization/reference/rest/v1/OptimizeToursUriResponse), if successful.\n\nExperimental: See \u003chttps://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request\u003e for more details.\n\n### HTTP request\n\n`POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:OptimizeToursUri`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Target project or location to make a call. Format: \\* `projects/{project-id}` \\* `projects/{project-id}/locations/{location-id}` If no location is specified, a region will be chosen automatically. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"input\": { object (/maps/documentation/route-optimization/reference/rest/v1/Uri) }, \"output\": { object (/maps/documentation/route-optimization/reference/rest/v1/Uri) } } ``` |\n\n| Fields ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `input` | `object (`[Uri](/maps/documentation/route-optimization/reference/rest/v1/Uri)`)` Required. The URI of the Cloud Storage object containing the `OptimizeToursRequest`. |\n| `output` | `object (`[Uri](/maps/documentation/route-optimization/reference/rest/v1/Uri)`)` Required. The URI of the Cloud Storage object that will contain the `OptimizeToursResponse`. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `routeoptimization.operations.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]