|
इस दस्तावेज़ में, वाहन के उन अहम फ़ील्ड के बारे में बताया गया है जिन्हें वाहन बनाते और मैनेज करते समय अपडेट किया जा सकता है.
|
वाहन के फ़ील्ड की पूरी सूची देखने के लिए, यहां देखें: |
वाहन के एट्रिब्यूट का फ़ील्ड
वाहन attributes फ़ील्ड का इस्तेमाल करके, अपनी ज़रूरत के मुताबिक शर्तें बनाएं. इससे आपके ग्राहक या फ़्लीट ऑपरेटर, खोज के लिए कई तरह की शर्तों के हिसाब से आपके फ़्लीट में मौजूद वाहन ढूंढ पाएंगे. इससे आपके ऐप्लिकेशन की क्षमताएं बेहतर हो जाती हैं, ताकि वाहन के अन्य फ़ील्ड के आधार पर खोज की शर्तों का इस्तेमाल करने के बजाय, वाहन के बेहतर मैच उपलब्ध कराए जा सकें. हर वाहन के लिए ज़्यादा से ज़्यादा 100 एट्रिब्यूट हो सकते हैं. साथ ही, हर एट्रिब्यूट के लिए एक यूनीक कुंजी होनी चाहिए. वैल्यू, स्ट्रिंग, बूलियन या संख्याएं हो सकती हैं.
उदाहरण के लिए, ज़ोन नाम का कस्टम एट्रिब्यूट तय करके, यह बताया जा सकता है कि आपके डिलीवरी वाहन, शहर के किस ज़ोन में ऑपरेट करते हैं. अलग-अलग ज़ोन दिखाने के लिए, स्ट्रिंग वैल्यू का इस्तेमाल किया जाता है. जैसे: 1B,
2C, और 3A. इसके बाद, फ़्लीट ट्रैकिंग में फ़िल्टर का इस्तेमाल करके, किसी खास ज़ोन में काम करने वाले वाहन सिर्फ़ उस ज़ोन के ऑपरेटर को दिखाए जा सकते हैं.
हालांकि, कस्टम एट्रिब्यूट की वैल्यू एक-दूसरे से अलग होनी ज़रूरी नहीं है. available-at-night और has-refrigeration जैसी शर्तों का इस्तेमाल किया जा सकता है. इनमें से हर एक, बूलियन वैल्यू का इस्तेमाल करने वाला अलग कस्टम एट्रिब्यूट हो सकता है. किसी वाहन को, इन तीनों कस्टम एट्रिब्यूट के साथ-साथ ज़ोन कस्टम एट्रिब्यूट असाइन किया जा सकता है. इसके लिए, ज़ोन कस्टम एट्रिब्यूट की वैल्यू के तौर पर सही स्ट्रिंग सेट करें.
वाहन के एट्रिब्यूट अपडेट करना
हर वाहन के लिए, हर 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;
}
REST
# 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