इस दस्तावेज़ में वाहन के ज़रूरी फ़ील्ड के बारे में बताया गया है वाहनों को बनाने और मैनेज करने के दौरान इन्हें अपडेट करें.
|
वाहन के फ़ील्ड की पूरी सूची देखने के लिए, ये देखें: |
वाहन के एट्रिब्यूट का फ़ील्ड
वाहन के attributes
फ़ील्ड का इस्तेमाल करके, ज़रूरत के हिसाब से शर्तें बनाएं
उपभोक्ता या फ़्लीट ऑपरेटर आपके सभी इलाकों में वाहनों को ढूंढने के लिए
खोज के लिए शर्तें तय करती हैं. इससे आपका ऐप्लिकेशन बेहतर तरीके से काम कर पाएगा
खोज की शर्तों का इस्तेमाल करने पर मिलने वाली नतीजों की तुलना में, वाहन के बेहतर मैच दिखाना
जो वाहन के अन्य फ़ील्ड के हिसाब से सही होते हैं. हर वाहन में ज़्यादा से ज़्यादा 100 वाहन हो सकते हैं
विशेषता दी गई है और हर एक की कुंजी यूनीक होनी चाहिए. वैल्यू, स्ट्रिंग हो सकती हैं.
बूलियन्स, या संख्याओं का इस्तेमाल करते हैं.
उदाहरण के लिए, आपके पास zone नाम के कस्टम एट्रिब्यूट का एलान करने की सुविधा होती है.
यह पता लगाना कि आपके डिलीवरी वाहन शहर के किस ज़ोन में चलाए जाते हैं. आपको
अलग-अलग ज़ोन को दिखाने के लिए, नीचे दी गई स्ट्रिंग वैल्यू का इस्तेमाल करें: 1B
,
2C
और 3A
. इसके बाद, सिर्फ़ यूआरएल को देखने के लिए, फ़्लीट ट्रैकिंग में फ़िल्टर का इस्तेमाल किया जा सकता है
किसी ज़ोन में काम करने वाले वाहन के लिए, उस ज़ोन के ऑपरेटर की जानकारी.
हालांकि, कस्टम एट्रिब्यूट की वैल्यू अलग-अलग नहीं होनी चाहिए. आप रात में उपलब्ध और फ़्रिज-फ़्रिज है जैसी शर्तों का इस्तेमाल करते हैं. इनमें से सभी बूलियन वैल्यू का इस्तेमाल करने वाला एक अलग कस्टम एट्रिब्यूट हो सकता है. दिया गया वाहन को zone के साथ ये तीनों कस्टम एट्रिब्यूट असाइन किए जा सकते हैं कस्टम एट्रिब्यूट को स्ट्रिंग की सही वैल्यू पर सेट किया गया है.
वाहन की विशेषताएं अपडेट करें
हर वाहन के लिए, हर attributes
कुंजी की सिर्फ़ एक वैल्यू दी जा सकती है. आपने एलान किया
वाहन के कस्टम एट्रिब्यूट, फ़ील्ड मास्क में attributes
का इस्तेमाल करते हैं. इसके बाद
नीचे दिए गए तरीके के आधार पर वैल्यू देकर.
यह UpdateDeliveryVehicle
एपीआई, सिर्फ़ एक बार अपडेट करने की अनुमति नहीं देता
एट्रिब्यूट की वैल्यू सबमिट करें. इस तरीके का इस्तेमाल करते समय, attributes
फ़ील्ड मास्क की वजह से, वाहन के एट्रिब्यूट के पूरे सेट के बारे में फिर से एलान किया जाता है
ट्रैक करने में मदद मिलती है. इससे कोई भी पहले से मौजूद एट्रिब्यूट ओवरराइट हो जाता है, जो
साफ़ तौर पर फ़ील्ड मास्क में शामिल किया जाता है. अगर आप नया एलान करने के लिए इस तरीके का इस्तेमाल करते हैं, तो
कस्टम एट्रिब्यूट है, तो आपको हर उस कस्टम एट्रिब्यूट का एलान करना होगा जिसे
बनाए रखने के लिए. अगर फ़ील्ड मास्क में attributes
को बाहर रखा जाता है, तो यह
तरीका, वाहन के लिए पहले से तय किए गए कस्टम एट्रिब्यूट को ही छोड़ देता है.
अगर फ़ील्ड मास्क में attributes
का इस्तेमाल किया जाता है, लेकिन वैल्यू सेट नहीं की जाती है, तो
वाहन से सभी कस्टम एट्रिब्यूट हटाने के बराबर है.
वाहन के फ़ील्ड अपडेट करने का उदाहरण
इस सेक्शन में, वाहन के फ़ील्ड अपडेट करने का तरीका बताया गया है
UpdateDeliveryVehicleRequest
, जिसमें यह बताने के लिए update_mask
शामिल है
किन फ़ील्ड को अपडेट करना है. प्रोटोकॉल बफ़र दस्तावेज़ को यहां देखें
फ़ील्ड मास्क का इस्तेमाल करें.
last_location
के अलावा अन्य फ़ील्ड के अपडेट के लिए, फ़्लीट इंजन डिलीवरी की ज़रूरत है
एडमिन के खास अधिकार.
उदाहरण: कस्टम एट्रिब्यूट सेट करना
इस उदाहरण में एक नए एट्रिब्यूट के बारे में बताया गया है: 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