डिलीवरी करने वाले वाहन के फ़ील्ड अपडेट करें

इस दस्तावेज़ में, वाहन के उन अहम फ़ील्ड के बारे में बताया गया है जिन्हें वाहन बनाते और मैनेज करते समय अपडेट किया जा सकता है.

  • type: डिलीवरी के लिए इस्तेमाल होने वाली गाड़ी का टाइप. इससे, इस वाहन के लिए जनरेट किए गए रास्तों पर असर पड़ता है.
  • attributes[]: DeliveryVehicleAttribute टाइप का विकल्पों का कलेक्शन. इस्तेमाल की जाने वाली चीज़ें ताकि वे आपकी सेवा में मौजूद वाहनों के लिए कस्टम मानदंड तय कर सकें. वाहनों को खोजने या उनकी सूची बनाने के दौरान फ़िल्टर करने का तरीका.
 

वाहन के फ़ील्ड की पूरी सूची देखने के लिए, यह देखें:

वाहन के एट्रिब्यूट का फ़ील्ड

वाहन attributes फ़ील्ड का इस्तेमाल करके, अपनी ज़रूरत के मुताबिक शर्तें बनाएं. इससे आपके ग्राहक या फ़्लीट ऑपरेटर, खोज के लिए कई तरह की शर्तों के हिसाब से आपके फ़्लीट में मौजूद वाहन ढूंढ पाएंगे. इससे आपके ऐप्लिकेशन की सुविधाएं बेहतर हो जाती हैं, ताकि वाहन के अन्य फ़ील्ड के आधार पर खोज की शर्तों का इस्तेमाल करने के बजाय, वाहन के बेहतर मैच उपलब्ध कराए जा सकें. हर वाहन के लिए ज़्यादा से ज़्यादा 100 एट्रिब्यूट हो सकते हैं. साथ ही, हर एट्रिब्यूट के लिए एक यूनीक कुंजी होनी चाहिए. वैल्यू, स्ट्रिंग, बूलियन या संख्याएं हो सकती हैं.

उदाहरण के लिए, आपके पास zone नाम के कस्टम एट्रिब्यूट का एलान करने की सुविधा होती है. यह पता लगाना कि आपके डिलीवरी वाहन शहर के किस ज़ोन में चलाए जाते हैं. आपको अलग-अलग ज़ोन को दिखाने के लिए, नीचे दी गई स्ट्रिंग वैल्यू का इस्तेमाल करें: 1B, 2C और 3A. इसके बाद, सिर्फ़ यूआरएल दिखाने के लिए, फ़्लीट ट्रैकिंग में फ़िल्टर का इस्तेमाल किया जा सकता है किसी ज़ोन में काम करने वाले वाहन के लिए, उस ज़ोन के ऑपरेटर की जानकारी.

हालांकि, कस्टम एट्रिब्यूट की वैल्यू अलग-अलग नहीं होनी चाहिए. आप रात में उपलब्ध और फ़्रिज-फ़्रिज है जैसी शर्तों का इस्तेमाल करते हैं. इनमें से सभी बूलियन वैल्यू का इस्तेमाल करने वाला एक अलग कस्टम एट्रिब्यूट हो सकता है. दिया गया वाहन को zone के साथ ये तीनों कस्टम एट्रिब्यूट असाइन किए जा सकते हैं कस्टम एट्रिब्यूट को स्ट्रिंग की सही वैल्यू पर सेट किया गया है.

वाहन की विशेषताएं अपडेट करें

हर वाहन के लिए, हर attributes कुंजी में सिर्फ़ एक वैल्यू हो सकती है. आपने एलान किया वाहन के कस्टम एट्रिब्यूट, फ़ील्ड मास्क में attributes का इस्तेमाल करते हैं. इसके बाद नीचे दिए गए तरीके के आधार पर वैल्यू देकर.

इस UpdateDeliveryVehicle एपीआई की मदद से, सिर्फ़ एक एट्रिब्यूट को अपडेट नहीं किया जा सकता. इस तरीके का इस्तेमाल करते समय, फ़ील्ड मास्क में attributes फ़ील्ड का इस्तेमाल करने पर, वाहन के लिए वाहन एट्रिब्यूट के पूरे सेट को फिर से एलान किया जाता है. इससे, पहले से मौजूद किसी भी एट्रिब्यूट की वैल्यू ओवरराइट हो जाती है, जिसे फ़ील्ड मास्क में साफ़ तौर पर शामिल नहीं किया गया है. अगर आप नया एलान करने के लिए इस तरीके का इस्तेमाल करते हैं, तो कस्टम एट्रिब्यूट है, तो आपको हर उस कस्टम एट्रिब्यूट का एलान करना होगा जिसे बनाए रखने के लिए. अगर फ़ील्ड मास्क में attributes को शामिल नहीं किया जाता है, तो इस तरीक़े से वाहन के लिए पहले से तय किए गए मौजूदा कस्टम एट्रिब्यूट में कोई बदलाव नहीं होता. अगर फ़ील्ड मास्क में attributes का इस्तेमाल किया जाता है, लेकिन वैल्यू सेट नहीं की जाती है, तो वाहन से सभी कस्टम एट्रिब्यूट हटाने के बराबर है.

वाहन के फ़ील्ड अपडेट करने का उदाहरण

इस सेक्शन में, UpdateDeliveryVehicleRequest का इस्तेमाल करके वाहन के फ़ील्ड अपडेट करने का तरीका बताया गया है. इसमें update_mask शामिल है, जिससे यह पता चलता है कि किन फ़ील्ड को अपडेट करना है. ज़्यादा जानकारी के लिए, प्रोटोकॉल बफ़र के दस्तावेज़ में फ़ील्ड मास्क देखें.

last_location के अलावा अन्य फ़ील्ड को अपडेट करने के लिए, Fleet Engine डिलीवरी एडमिन के लेवल का ऐक्सेस होना ज़रूरी है.

उदाहरण: कस्टम एट्रिब्यूट सेट करना

इस उदाहरण में एक नए एट्रिब्यूट के बारे में बताया गया है: zone. जैसा कि इसमें बताया गया है पहले ही वाहन के एट्रिब्यूट अपडेट करें और इसका इस्तेमाल करके attributes फ़ील्ड को अपडेट करें इस तरीके का इस्तेमाल करने पर, आपको उन सभी कस्टम एट्रिब्यूट की जानकारी देनी होगी जिन्हें आपको बनाए रखना है. इसलिए, इस उदाहरण में available-at-night वैल्यू को सुरक्षित रखने के लिए लिखा गया है अपडेट कार्रवाई के दौरान ओवरराइट होने से बचा जाता है, जो attributes फ़ील्ड.

providers.deliveryVehicles.patch रेफ़रंस देखें.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
      .addAllAttributes(ImmutableList.of(
          DeliveryVehicleAttribute.newBuilder().setKey("zone").setValue("1B").build(),
          DeliveryVehicleAttribute.newBuilder().setKey("available-at-night").setValue("true").build()))
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(myDeliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("attributes"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

आराम

  # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
  # environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=attributes" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
      "attributes": [
        {"key": "zone", "value": "1B"},
        {"key": "available-at-night", "value": "true"}
      ]
  }
  EOM

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