इस दस्तावेज़ में, gRPC या REST में से किसी एक का इस्तेमाल करके, सर्वर एनवायरमेंट से वाहन बनाने का तरीका बताया गया है. Driver SDK टूल की मदद से वाहन बनाया जा सकता है. इसके लिए, ज़रूरी है कि आपने सही क्रेडेंशियल का इस्तेमाल करके, ऐप्लिकेशन को भरोसेमंद प्लैटफ़ॉर्म के तौर पर सेट अप किया हो.
वाहन बनाने के लिए, Driver SDK टूल का इस्तेमाल करने का तरीका जानने के लिए, ये देखें:
- शेड्यूल किए गए टास्क के लिए Driver SDK
- Fleet Engine की ज़रूरी शर्तें में जाकर, सेवा खाते की भूमिकाएं.
सर्वर एनवायरमेंट से नया वाहन बनाने के लिए, CreateDeliveryVehicle
Fleet Engine से अनुरोध करें. डिलीवरी के लिए इस्तेमाल किए जाने वाले नए वाहन के एट्रिब्यूट तय करने के लिए, CreateDeliveryVehicleRequest
ऑब्जेक्ट का इस्तेमाल करें.
शेड्यूल किए गए टास्क के वाहनों के लिए फ़ील्ड
DeliveryVehicle
बनाते समय, ये वैकल्पिक फ़ील्ड सेट किए जा सकते हैं:
attributes
last_location
type
वाहन की जानकारी सबमिट करते समय, ज़रूरी नहीं होने वाले किसी भी फ़ील्ड को सेट न करें. इसके लिए, CreateDeliveryVehicleRequest
में DeliveryVehicle
फ़ील्ड को सेट न करें.
वाहन का उदाहरण बनाना
वाहन या REST बनाने के लिए, Java gRPC लाइब्रेरी का इस्तेमाल किया जा सकता है.
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
सर्वर एनवायरमेंट से वाहन बनाने के लिए, CreateDeliveryVehicle
पर एचटीटीपी 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 अनुरोध के मुख्य हिस्से को खाली छोड़ दें. इसके बाद, नया वाहन, पीओएसटी यूआरएल में मौजूद 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}"