Method: projects.optimizeToursUri
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
HTTP-запрос
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:OptimizeToursUri
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
parent | string Необходимый. Целевой проект или место для звонка. Формат: * projects/{project-id} * projects/{project-id}/locations/{location-id} Если местоположение не указано, регион будет выбран автоматически. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"input": {
object (Uri )
},
"output": {
object (Uri )
}
} |
Поля |
---|
input | object ( Uri ) Необходимый. URI объекта Cloud Storage, содержащего OptimizeToursRequest . |
output | object ( Uri ) Необходимый. URI объекта Cloud Storage, который будет содержать OptimizeToursResponse . |
Тело ответа
В случае успеха тело ответа содержит экземпляр Operation
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/cloud-platform
IAM-разрешения
Требуется следующее разрешение IAM для parent
ресурса:
-
routeoptimization.operations.create
Дополнительную информацию см. в документации IAM .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[],[],null,["# Method: projects.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 [projects.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 `projects.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/*}: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)."]]