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