Method: providers.vehicles.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينشئ مثيلاً لمركبة جديدة مرتبطة بمقدّم خدمة مشاركة الرحلات أو خدمات التسليم عند الطلب. يجب أن يكون لكل Vehicle معرّف مركبة فريد.
يجب ملء حقول Vehicle التالية عند إنشاء Vehicle:
vehicleStatesupportedTripTypesmaximumCapacityvehicleType
يتم تجاهل حقول Vehicle التالية عند إنشاء Vehicle:
namecurrentTripsavailableCapacitycurrentRouteSegmentcurrentRouteSegmentEndPointcurrentRouteSegmentVersioncurrentRouteSegmentTrafficroutewaypointswaypointsVersionremainingDistanceMetersremainingTimeSecondseta_to_next_waypointnavigationStatus
وجميع الحقول الأخرى اختيارية وتُستخدَم في حال توفيرها.
طلب 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 التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
|
نص الطلب
يحتوي نص الطلب على مثال Vehicle.
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Vehicle تم إنشاؤه حديثًا.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
