Method: providers.vehicles.create
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
オンデマンドのライドシェアまたは配達のプロバイダに関連付けられた新しい車両をインスタンス化します。各 Vehicle には一意の車両 ID が必要です。
Vehicle を作成する場合は、次の Vehicle フィールドが必要です。
vehicleStatesupportedTripTypesmaximumCapacityvehicleType
Vehicle の作成時に、次の Vehicle フィールドは無視されます。
namecurrentTripsavailableCapacitycurrentRouteSegmentcurrentRouteSegmentEndPointcurrentRouteSegmentVersioncurrentRouteSegmentTrafficroutewaypointswaypointsVersionremainingDistanceMetersremainingTimeSecondseta_to_next_waypointnavigationStatus
その他のフィールドはすべて省略可能で、指定した場合に使用されます。
HTTP リクエスト
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
parent |
string
必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
|
クエリ パラメータ
| パラメータ |
header |
object (RequestHeader)
標準の Fleet Engine リクエスト ヘッダー。
|
vehicleId |
string
必須。一意の車両 ID。以下の制限が適用されます。
- 有効な Unicode 文字列を指定する必要があります。
- 最大文字数は 64 文字です。
- Unicode 正規化フォーム C に従って正規化されます。
- ASCII 文字「/」、「:」、「?」、「」、「#」を含めることはできません。
|
リクエスト本文
リクエストの本文には Vehicle のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Vehicle のインスタンスが含まれます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-31 UTC。
[null,null,["最終更新日 2025-08-31 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)."]]
