इस दस्तावेज़ में, gRPC या REST का इस्तेमाल करके, सर्वर एनवायरमेंट से वाहन बनाने का तरीका बताया गया है. ड्राइवर एसडीके की मदद से वाहन की जानकारी जोड़ी जा सकती है. इसके लिए, आपको सही क्रेडेंशियल का इस्तेमाल करके, ऐप्लिकेशन को भरोसेमंद प्लैटफ़ॉर्म के तौर पर सेट अप करना होगा.
वाहन बनाने के लिए, ड्राइवर एसडीके इस्तेमाल करने का तरीका जानने के लिए, यहां दी गई जानकारी देखें:
- शेड्यूल किए गए टास्क के लिए Driver SDK
- फ़्लीट इंजन से जुड़ी ज़रूरी जानकारी में जाकर, सेवा खाते की भूमिकाएं.
सर्वर एनवायरमेंट से नया वाहन बनाने के लिए, Fleet Engine को CreateDeliveryVehicle अनुरोध भेजें. डिलीवरी के लिए इस्तेमाल होने वाले नए वाहन के एट्रिब्यूट तय करने के लिए, CreateDeliveryVehicleRequest ऑब्जेक्ट का इस्तेमाल करें.
शेड्यूल किए गए टास्क के लिए वाहनों की जानकारी वाले फ़ील्ड
DeliveryVehicle बनाते समय, ये वैकल्पिक फ़ील्ड सेट किए जाते हैं:
attributeslast_locationtype
अगर आपको कोई वैकल्पिक फ़ील्ड सेट किए बिना वाहन की प्रोफ़ाइल बनानी है, तो CreateDeliveryVehicleRequest में DeliveryVehicle फ़ील्ड को सेट किए बिना छोड़ दें.
वाहन का उदाहरण बनाएं
वाहन बनाने के लिए, 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;
}
आराम का समय
सर्वर एनवायरमेंट से वाहन बनाने के लिए, CreateDeliveryVehicle पर एचटीटीपी REST कॉल करें:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles?deliveryVehicleId=<id>
POST बॉडी, बनाई जाने वाली DeliveryVehicle इकाई को दिखाती है. इन वैकल्पिक फ़ील्ड की जानकारी दी जा सकती है:
attributeslastLocationtype
# 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 यूआरएल में मौजूद 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}"