এই দস্তাবেজটি বর্ণনা করে যে কীভাবে একটি সার্ভার পরিবেশ থেকে জিআরপিসি বা REST ব্যবহার করে একটি গাড়ি তৈরি করা যায়। আপনি ড্রাইভার SDK থেকে একটি গাড়ি তৈরি করতে পারেন, যদি আপনি উপযুক্ত শংসাপত্র ব্যবহার করে অ্যাপটিকে একটি বিশ্বস্ত পরিবেশ হিসাবে সরবরাহ করেছেন।
যানবাহন তৈরি করতে ড্রাইভার SDK কীভাবে ব্যবহার করবেন তা বোঝার জন্য, নিম্নলিখিতগুলি দেখুন:
- নির্ধারিত কাজের জন্য ড্রাইভার SDK
- ফ্লিট ইঞ্জিনের প্রয়োজনীয়তার অধীনে পরিষেবা অ্যাকাউন্টের ভূমিকা ।
একটি সার্ভার পরিবেশ থেকে একটি নতুন যান তৈরি করতে, ফ্লিট ইঞ্জিনে একটি CreateDeliveryVehicle
অনুরোধ করুন৷ নতুন ডেলিভারি গাড়ির বৈশিষ্ট্যগুলি সংজ্ঞায়িত করতে CreateDeliveryVehicleRequest
অবজেক্টটি ব্যবহার করুন।
নির্ধারিত কাজ যানবাহন জন্য ক্ষেত্র
একটি DeliveryVehicle
তৈরি করার সময়, আপনি নিম্নলিখিত ঐচ্ছিক ক্ষেত্রগুলি সেট করেন:
-
attributes
-
last_location
-
type
কোনো ঐচ্ছিক ক্ষেত্র সেট না করেই একটি গাড়ি তৈরি করতে, আপনি CreateDeliveryVehicleRequest
এ DeliveryVehicle
ক্ষেত্রটিকে সেট না করে ছেড়ে দিতে পারেন।
গাড়ির উদাহরণ তৈরি করুন
আপনি একটি যান তৈরি করতে Java gRPC লাইব্রেরি ব্যবহার করতে পারেন, বা REST।
জাভা
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;
}
বিশ্রাম
একটি সার্ভার পরিবেশ থেকে একটি যান তৈরি করতে, CreateDeliveryVehicle
এ একটি HTTP REST কল করুন:
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 অনুরোধের মূল অংশটি খালি রাখুন। নতুন তৈরি গাড়িটি তারপর POST URL-এ deliveryVehicleId
প্যারামিটার থেকে একটি গাড়ির আইডি বের করে।
উদাহরণ:
# 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}"