Method: providers.vehicles.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает экземпляр нового транспортного средства, связанного с поставщиком услуг совместного использования поездок или доставки по требованию. Каждое Vehicle должно иметь уникальный идентификатор транспортного средства.
При создании Vehicle Vehicle обязательны следующие поля:
-
vehicleState -
supportedTripTypes -
maximumCapacity -
vehicleType
Следующие поля Vehicle игнорируются при создании Vehicle :
-
name -
currentTrips -
availableCapacity -
currentRouteSegment -
currentRouteSegmentEndPoint -
currentRouteSegmentVersion -
currentRouteSegmentTraffic -
route -
waypoints -
waypointsVersion -
remainingDistanceMeters -
remainingTimeSeconds -
eta_to_next_waypoint -
navigationStatus
Все остальные поля являются необязательными и используются, если они предусмотрены.
HTTP-запрос
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Должно быть в формате providers/{provider} . Поставщиком должен быть идентификатор проекта (например, sample-cloud-project ) проекта Google Cloud, участником которого является сервисный аккаунт, выполняющий этот вызов. |
Параметры запроса
| Параметры |
|---|
header | object ( RequestHeader ) Стандартный заголовок запроса Fleet Engine. |
vehicleId | string Необходимый. Уникальный идентификатор автомобиля. С учетом следующих ограничений: - Должна быть допустимой строкой Unicode.
- Ограничено максимальной длиной в 64 символа.
- Нормализовано в соответствии с формой нормализации Unicode C.
- Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».
|
Тело запроса
Тело запроса содержит экземпляр Vehicle .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Vehicle .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eInstantiates a new vehicle associated with an on-demand rideshare or deliveries provider, requiring a unique vehicle ID for each vehicle.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating a \u003ccode\u003eVehicle\u003c/code\u003e, \u003ccode\u003evehicleState\u003c/code\u003e, \u003ccode\u003esupportedTripTypes\u003c/code\u003e, \u003ccode\u003emaximumCapacity\u003c/code\u003e, and \u003ccode\u003evehicleType\u003c/code\u003e fields are required; while fields like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003ecurrentTrips\u003c/code\u003e, \u003ccode\u003eavailableCapacity\u003c/code\u003e, and route-related fields are ignored.\u003c/p\u003e\n"],["\u003cp\u003eSends a POST request to \u003ccode\u003ehttps://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles\u003c/code\u003e to create a vehicle, with the provider specified in the path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires a \u003ccode\u003eheader\u003c/code\u003e for the Fleet Engine request and a unique \u003ccode\u003evehicleId\u003c/code\u003e in the query parameters, adhering to specified restrictions for the \u003ccode\u003evehicleId\u003c/code\u003e format.\u003c/p\u003e\n"],["\u003cp\u003eIncludes the \u003ccode\u003eVehicle\u003c/code\u003e object details in the request body and returns the newly created \u003ccode\u003eVehicle\u003c/code\u003e object in the response body upon successful creation.\u003c/p\u003e\n"]]],[],null,["# Method: providers.vehicles.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nInstantiates a new vehicle associated with an on-demand rideshare or deliveries provider. Each `Vehicle` must have a unique vehicle ID.\n\nThe following `Vehicle` fields are required when creating a `Vehicle`:\n\n- `vehicleState`\n- `supportedTripTypes`\n- `maximumCapacity`\n- `vehicleType`\n\nThe following `Vehicle` fields are ignored when creating a `Vehicle`:\n\n- `name`\n- `currentTrips`\n- `availableCapacity`\n- `currentRouteSegment`\n- `currentRouteSegmentEndPoint`\n- `currentRouteSegmentVersion`\n- `currentRouteSegmentTraffic`\n- `route`\n- `waypoints`\n- `waypointsVersion`\n- `remainingDistanceMeters`\n- `remainingTimeSeconds`\n- `eta_to_next_waypoint`\n- `navigationStatus`\n\nAll other fields are optional and used if provided.\n\n### HTTP request\n\n`POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Must be in the format `providers/{provider}`. The provider must be the Project ID (for example, `sample-cloud-project`) of the Google Cloud Project of which the service account making this call is a member. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[RequestHeader](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/RequestHeader)`)` The standard Fleet Engine request header. |\n| `vehicleId` | `string` Required. Unique Vehicle ID. Subject to the following restrictions: - Must be a valid Unicode string. - Limited to a maximum length of 64 characters. - Normalized according to [Unicode Normalization Form C](http://www.unicode.org/reports/tr15/). - May not contain any of the following ASCII characters: '/', ':', '?', ',', or '#'. |\n\n### Request body\n\nThe request body contains an instance of [Vehicle](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.vehicles#Vehicle).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Vehicle](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.vehicles#Vehicle)."]]
