במסמך הזה מוסבר איך ליצור רכב מסביבת שרת באמצעות gRPC או REST. אפשר ליצור רכב מ-Driver SDK, בתנאי שהגדרתם את האפליקציה כסביבה מהימנה באמצעות פרטי הכניסה המתאימים.
כדי להבין איך משתמשים ב-Driver SDK כדי ליצור כלי רכב, אפשר לעיין במאמרים הבאים:
- Driver 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;
}
REST
כדי ליצור רכב מסביבת שרת, שולחים קריאה ל-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}"