Method: providers.vehicles.create
Stay organized with collections
Save and categorize content based on your preferences.
Instantiates a new vehicle associated with an on-demand rideshare or deliveries provider. Each Vehicle must have a unique vehicle ID.
The following Vehicle fields are required when creating a Vehicle:
vehicleStatesupportedTripTypesmaximumCapacityvehicleType
The following Vehicle fields are ignored when creating a Vehicle:
namecurrentTripsavailableCapacitycurrentRouteSegmentcurrentRouteSegmentEndPointcurrentRouteSegmentVersioncurrentRouteSegmentTrafficroutewaypointswaypointsVersionremainingDistanceMetersremainingTimeSecondseta_to_next_waypointnavigationStatus
All other fields are optional and used if provided.
HTTP request
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
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.
|
Query parameters
| Parameters |
header |
object (RequestHeader)
The standard Fleet Engine request header.
|
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.
- May not contain any of the following ASCII characters: '/', ':', '?', ',', or '#'.
|
Request body
The request body contains an instance of Vehicle.
Response body
If successful, the response body contains a newly created instance of Vehicle.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 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)."]]
