शेड्यूल किए गए टास्क के लिए, डिलीवरी व्हीकल बनाएं

इस दस्तावेज़ में बताया गया है कि gRPC या REST का इस्तेमाल करके सर्वर एनवायरमेंट से वाहन कैसे बनाया जाता है. Driver SDK टूल की मदद से वाहन बनाया जा सकता है. इसके लिए, ज़रूरी है कि आपने सही क्रेडेंशियल का इस्तेमाल करके, ऐप्लिकेशन को भरोसेमंद प्लैटफ़ॉर्म के तौर पर सेट अप किया हो.

वाहन बनाने के लिए, ड्राइवर SDK टूल का इस्तेमाल करने का तरीका जानने के लिए, यह लेख पढ़ें:

सर्वर एनवायरमेंट से नई गाड़ी बनाने के लिए, Fleet Engine को CreateDeliveryVehicle का अनुरोध करें. डिलीवरी वाले नए वाहन के एट्रिब्यूट को बताने के लिए, 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>

पीओएसटी का मुख्य हिस्सा, बनाई जाने वाली 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}"

आगे क्या करना है