يشرح هذا المستند كيفية إنشاء مركبة من بيئة خادم باستخدام إما gRPC أو REST. يمكنك إنشاء مركبة من "حزمة تطوير البرامج (SDK) لبرنامج التشغيل"، شريطة أن إدارة التطبيق كبيئة موثوق بها باستخدام بيانات الاعتماد.
لفهم كيفية استخدام "حزمة تطوير البرامج (SDK) للسائق" لإنشاء المركبات، يُرجى الاطّلاع على المراجع التالية:
- حزمة تطوير البرامج (SDK) لبرنامج التشغيل للمهام المُجدوَلة
- أدوار حساب الخدمة ضِمن أساسيات Fleet Engine.
لإنشاء مركبة جديدة من بيئة خادم، أنشِئ
هناك طلب "CreateDeliveryVehicle
" تم إرساله إلى Fleet Engine. يمكنك استخدام
CreateDeliveryVehicleRequest
لتحديد سمات العنصر الجديد
مركبة توصيل.
حقول المركبات المُجدوَلة للمهام
عند إنشاء DeliveryVehicle
، يمكنك ضبط الحقول الاختيارية التالية:
attributes
last_location
type
لإنشاء مركبة بدون ضبط أي حقول اختيارية، يمكنك مغادرة
تم إلغاء ضبط الحقل DeliveryVehicle
في CreateDeliveryVehicleRequest
.
مثال على إنشاء مركبة
يمكنك استخدام مكتبة Java gRPC لإنشاء مركبة أو REST.
Java
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890"; // Avoid auto-incrementing IDs.
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String parent = "providers/" + PROJECT_ID;
DeliveryVehicle vehicle = DeliveryVehicle.newBuilder()
.addAttributes(DeliveryVehicleAttribute.newBuilder()
.setKey("route_number").setValue("1")) // Opaque to the Fleet Engine
.build();
// Vehicle request
CreateDeliveryVehicleRequest createVehicleRequest =
CreateDeliveryVehicleRequest.newBuilder() // No need for the header
.setParent(parent)
.setDeliveryVehicleId(VEHICLE_ID) // Vehicle ID assigned by the Provider
.setDeliveryVehicle(vehicle)
.build();
// Error handling
// If Fleet Engine does not have vehicle with that ID and the credentials of the
// requestor pass, the service creates the vehicle successfully.
try {
DeliveryVehicle createdVehicle =
deliveryService.createDeliveryVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
راحة
لإنشاء مركبة من بيئة خادم، عليك إجراء طلب HTTP REST.
إلى CreateDeliveryVehicle
:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles?deliveryVehicleId=<id>
يمثل نص POST كيان DeliveryVehicle
المطلوب إنشاؤه. يمكنك
تحديد الحقول الاختيارية التالية:
attributes
lastLocation
type
# Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"attributes": [{"key": "model", "value": "sedan"}],
"lastLocation": {"location": {"latitude": 12.1, "longitude": 14.5}}
}
EOM
لإنشاء مركبة بدون ضبط أي حقول، اترك نص طلب POST.
الطلب فارغ. وبعد ذلك تستخرج المركبة المنشأة حديثًا معرف مركبة من
المعلمة deliveryVehicleId
في عنوان URL الخاص بعملية POST.
مثال:
# Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}"