Method: projects.locations.optimizeToursUri
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Esta es una variante del método locations.optimizeToursLongRunning
diseñada para optimizaciones con valores de tiempo de espera grandes y tamaños de entrada y salida grandes.
El cliente especifica el URI del OptimizeToursRequest
almacenado en Google Cloud Storage y el servidor escribe el OptimizeToursResponse
en un URI de Google Cloud Storage especificado por el cliente.
Se debe preferir este método en lugar del método locations.optimizeTours
para las optimizaciones que tardan más de unos minutos y los tamaños de entrada y salida que son mayores que 8 MB, aunque también se puede usar para optimizaciones más cortas y más pequeñas.
El long-running operation
(LRO) que se muestra tendrá un nombre con el formato <parent>/operations/<operation_id>
y se puede usar para hacer un seguimiento del progreso del procesamiento. El tipo de campo metadata
es OptimizeToursLongRunningMetadata
. El tipo de campo response
es OptimizeToursUriResponse
si se realiza correctamente.
Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request para obtener más detalles.
Solicitud HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:OptimizeToursUri
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
parent |
string
Obligatorio. Proyecto o ubicación de destino para realizar una llamada. Formato: * projects/{project-id} * projects/{project-id}/locations/{location-id} Si no se especifica una ubicación, se elegirá una región automáticamente.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
{
"input": {
object (Uri )
},
"output": {
object (Uri )
}
} |
Campos |
input |
object (Uri )
Obligatorio. Es el URI del objeto de Cloud Storage que contiene el OptimizeToursRequest .
|
output |
object (Uri )
Obligatorio. Es el URI del objeto de Cloud Storage que contendrá el OptimizeToursResponse .
|
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation
.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
Permisos de IAM
Se requiere el siguiente permiso de IAM en el recurso parent
:
routeoptimization.operations.create
Para obtener más información, consulta la documentación de IAM.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 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)."]]