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 حرفًا.
- تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
- يجب ألّا تحتوي على أي من أحرف ASCII التالية: / أو : أو ? أو , أو #.
|
نص الطلب
يحتوي نص الطلب على مثال Vehicle.
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Vehicle تم إنشاؤه حديثًا.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Instantiates a new vehicle associated with an on-demand rideshare or deliveries provider, requiring a unique vehicle ID for each vehicle."],["When creating a `Vehicle`, `vehicleState`, `supportedTripTypes`, `maximumCapacity`, and `vehicleType` fields are required; while fields like `name`, `currentTrips`, `availableCapacity`, and route-related fields are ignored."],["Sends a POST request to `https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles` to create a vehicle, with the provider specified in the path parameter."],["Requires a `header` for the Fleet Engine request and a unique `vehicleId` in the query parameters, adhering to specified restrictions for the `vehicleId` format."],["Includes the `Vehicle` object details in the request body and returns the newly created `Vehicle` object in the response body upon successful creation."]]],[]]
