Method: projects.locations.optimizeToursUri
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Il s'agit d'une variante de la méthode locations.optimizeToursLongRunning
conçue pour les optimisations avec de grandes valeurs de délai avant expiration et de grandes tailles d'entrée/sortie.
Le client spécifie l'URI de l'OptimizeToursRequest
stockée dans Google Cloud Storage, et le serveur écrit l'OptimizeToursResponse
dans un URI Google Cloud Storage spécifié par le client.
Cette méthode est à privilégier par rapport à la méthode locations.optimizeTours
pour les optimisations qui prennent plus de quelques minutes et les tailles d'entrée/sortie supérieures à 8 Mo, mais elle peut également être utilisée pour des optimisations plus courtes et plus petites.
Le long-running operation
(LRO) renvoyé aura un nom au format <parent>/operations/<operation_id>
et pourra être utilisé pour suivre la progression du calcul. Le type de champ metadata
est OptimizeToursLongRunningMetadata
. Le type de champ response
est OptimizeToursUriResponse
si l'opération réussit.
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request.
Requête HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:OptimizeToursUri
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
parent |
string
Obligatoire. Projet ou emplacement cibles pour passer un appel. Format: * projects/{project-id} * projects/{project-id}/locations/{location-id} Si aucun emplacement n'est spécifié, une région est automatiquement sélectionnée.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
{
"input": {
object (Uri )
},
"output": {
object (Uri )
}
} |
Champs |
input |
object (Uri )
Obligatoire. URI de l'objet Cloud Storage contenant le OptimizeToursRequest .
|
output |
object (Uri )
Obligatoire. URI de l'objet Cloud Storage qui contiendra le OptimizeToursResponse .
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Operation
.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/cloud-platform
Autorisations IAM
Nécessite l'autorisation IAM suivante sur la ressource parent
:
routeoptimization.operations.create
Pour en savoir plus, consultez la documentation IAM.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 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)."]]