REST Resource: providers.deliveryVehicles

रिसॉर्स: DeliveryVehicle

DeliveryVehicle मैसेज. डिलीवरी वाहन, शिपमेंट को डिपो से डिलीवरी की जगह और पिकअप की जगह से डिपो तक ले जाता है. कुछ मामलों में, डिलीवरी वाहन सीधे तौर पर पिकअप की जगह से डिलीवरी की जगह तक शिपमेंट पहुंचाते हैं.

ध्यान दें: gRPC और REST API, फ़ील्ड के नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. उदाहरण के लिए, gRPC API में DeliveryVehicle.current_route_segment फ़ील्ड और REST API में DeliveryVehicle.currentRouteSegment फ़ील्ड एक ही फ़ील्ड को दिखाते हैं.

JSON के काेड में दिखाना 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}
फ़ील्ड
name

string

डिलीवरी वाहन का यूनीक नाम. फ़ॉर्मैट providers/{provider}/deliveryVehicles/{vehicle} है.
lastLocation

object (DeliveryVehicleLocation)

डिलीवरी वाहन की आखिरी बार रिपोर्ट की गई जगह.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

डिलीवरी वाहन के नेविगेशन की स्थिति.
currentRouteSegment

string (bytes format)

कोड में बदली गई पॉलीलाइन, जो उस रास्ते की जानकारी देती है जिसका सुझाव नेविगेशन, अगले वेपॉइंट पर जाने के लिए देता है. आपका ड्राइवर ऐप्लिकेशन इसे तब अपडेट करता है, जब कोई स्टॉप पहुंच जाता है या निकल जाता है. साथ ही, नेविगेशन जब नेविगेशन का रास्ता बदल देता है. वाहन को असाइन किए गए सभी चालू टास्क के लिए, ये LatLng Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) या Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) में दिखाए जाते हैं.

कुछ मामलों में, इस फ़ील्ड का इस्तेमाल Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) या Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) को पॉप्युलेट करने के लिए नहीं किया जा सकता:

  • currentRouteSegment का एंडपॉइंट, DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) या DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) से मेल नहीं खाता.

  • ड्राइवर ऐप्लिकेशन ने हाल ही में अपनी जगह अपडेट नहीं की है. इसलिए, हो सकता है कि इस फ़ील्ड के लिए आखिरी बार अपडेट की गई वैल्यू पुरानी हो.

  • ड्राइवर ऐप्लिकेशन ने हाल ही में अपनी जगह की जानकारी अपडेट की है. हालांकि, currentRouteSegment पुराना है और यह वाहन को पिछले स्टॉप पर ले जाता है.

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

base64 कोड में बदली गई स्ट्रिंग.
currentRouteSegmentEndPoint

object (LatLng)

वह जगह जहां currentRouteSegment खत्म होता है. फ़िलहाल, इस जानकारी को ड्राइवर ऐप्लिकेशन से जनरेट नहीं किया जाता. हालांकि, deliveryVehicles.patch कॉल पर यह जानकारी अपने-आप भर सकती है. यह या तो आने वाले वाहन के स्टॉप से LatLng की दूरी पर है या currentRouteSegment का आखिरी LatLng है. इसके बाद, फ़्लीट इंजन असल VehicleStop से इंटरपोलेट करने की पूरी कोशिश करेगा.

अगर currentRouteSegment फ़ील्ड खाली है, तो deliveryVehicles.patch कॉल में इस फ़ील्ड को अनदेखा कर दिया जाता है.
remainingDistanceMeters

integer

currentRouteSegment तक की ड्राइविंग की बची हुई दूरी. आम तौर पर, Driver ऐप्लिकेशन यह फ़ील्ड उपलब्ध कराता है. हालांकि, कुछ मामलों में Fleet Engine, ऐप्लिकेशन से भेजी गई वैल्यू को बदल देगा. ज़्यादा जानकारी के लिए, DeliveryVehicle.current_route_segment देखें. यह फ़ील्ड, डिलीवरी वाहन को असाइन किए गए सभी चालू Task के लिए, Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) या Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) में दिखाया जाता है.

अगर currentRouteSegment फ़ील्ड खाली है, तो Fleet Engine UpdateDeliveryVehicleRequest में इस फ़ील्ड को अनदेखा कर देता है.
remainingDuration

string (Duration format)

currentRouteSegment तक ड्राइव करके जाने में बचे हुए समय की जानकारी. आम तौर पर, Driver ऐप्लिकेशन यह फ़ील्ड उपलब्ध कराता है. हालांकि, कुछ मामलों में Fleet Engine, ऐप्लिकेशन से भेजी गई वैल्यू को बदल देगा. ज़्यादा जानकारी के लिए, DeliveryVehicle.current_route_segment देखें. डिलीवरी वाहन को असाइन किए गए सभी चालू टास्क के लिए, यह फ़ील्ड Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) या Task.remainingVehicleJourneySegments[0].drivingDuration (REST) में दिखाया जाता है.

अगर currentRouteSegment फ़ील्ड खाली होता है, तो फ़्लीट इंजन UpdateDeliveryVehicleRequest में इस फ़ील्ड को अनदेखा कर देता है.

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

इस डिलीवरी वाहन को असाइन किए गए सफ़र के सेगमेंट. ये सेगमेंट, वाहन की हाल ही में रिपोर्ट की गई जगह से शुरू होते हैं. deliveryVehicles.list के जवाब में इस फ़ील्ड में अपने-आप जानकारी नहीं भरेगी.
attributes[]

object (DeliveryVehicleAttribute)

डिलीवरी में लगने वाले कस्टम वाहन के एट्रिब्यूट की सूची. डिलीवरी वाहन के लिए ज़्यादा से ज़्यादा 100 एट्रिब्यूट सबमिट किए जा सकते हैं. साथ ही, हर एट्रिब्यूट के लिए एक यूनीक कुंजी होनी चाहिए.
type

enum (DeliveryVehicleType)

डिलीवरी करने वाला यह वाहन किस तरह का है. अगर इसे सेट नहीं किया जाता है, तो यह डिफ़ॉल्ट रूप से AUTO पर सेट हो जाएगा.

DeliveryVehicleNavigationStatus

वाहन के नेविगेशन की स्थिति.

Enums
UNKNOWN_NAVIGATION_STATUS नेविगेशन की स्थिति की जानकारी नहीं है.
NO_GUIDANCE Driver ऐप्लिकेशन का नेविगेशन FREE_NAV मोड में है.
ENROUTE_TO_DESTINATION मोड़-दर-मोड़ नेविगेशन की सुविधा उपलब्ध है और ड्राइवर ऐप्लिकेशन नेविगेशन GUIDED_NAV मोड में चला गया है.
OFF_ROUTE वाहन, सुझाए गए रास्ते से हट गया है.
ARRIVED_AT_DESTINATION वाहन, मंज़िल से करीब 50 मीटर के दायरे में है.

DeliveryVehicleAttribute

वाहन के एट्रिब्यूट की जानकारी, की-वैल्यू पेयर के तौर पर देता है. "key:value" स्ट्रिंग की लंबाई 256 से ज़्यादा वर्ण नहीं हो सकती.

JSON के काेड में दिखाना 
{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}
फ़ील्ड
key

string

एट्रिब्यूट की कुंजी.
value

string

एट्रिब्यूट की वैल्यू.
यूनियन फ़ील्ड delivery_vehicle_attribute_value. एट्रिब्यूट की वैल्यू, स्ट्रिंग, बूल या डबल टाइप में हो सकती है. delivery_vehicle_attribute_value इनमें से सिर्फ़ एक हो सकता है:
stringValue

string

स्ट्रिंग टाइप किया गया एट्रिब्यूट का मान.

ध्यान दें: यह value फ़ील्ड के जैसा है, जिसे बाद में बंद कर दिया जाएगा. बनाने या अपडेट करने के तरीकों के लिए, किसी भी फ़ील्ड का इस्तेमाल किया जा सकता है, लेकिन हमारा सुझाव है कि आप stringValue का इस्तेमाल करें. अगर stringValue और value, दोनों को सेट किया गया है, तो दोनों एक जैसे होने चाहिए. ऐसा न करने पर, गड़बड़ी दिखेगी. जवाबों में, दोनों फ़ील्ड अपने-आप पॉप्युलेट हो जाते हैं.
boolValue

boolean

बूलियन टाइप किया गया विशेषता मान.
numberValue

number

दो बार टाइप किया गया एट्रिब्यूट का मान.

DeliveryVehicleType

डिलीवरी के लिए इस्तेमाल होने वाले वाहन का टाइप.

Enums
DELIVERY_VEHICLE_TYPE_UNSPECIFIED वैल्यू का इस्तेमाल नहीं किया गया है.
AUTO कोई वाहन.
TWO_WHEELER मोटरसाइकल, मोपेड या दोपहिया वाहन वाला अन्य वाहन
BICYCLE मानव-शक्ति से चलने वाली गाड़ियां.
PEDESTRIAN पैदल चलने या दौड़ने वाला कोई व्यक्ति, जो आम तौर पर पैदल चलने के रास्तों पर यात्रा कर रहा हो.

तरीके

create

 नया DeliveryVehicle बनाता है और दिखाता है.

get

 तय किया गया DeliveryVehicle इंस्टेंस दिखाता है.

list

 फ़िल्टर करने के लिए तय की गई शर्तों को पूरा करने वाले सभी DeliveryVehicle दिखाता है.

patch

 Fleet Engine में अपडेट किया गया DeliveryVehicle डेटा लिखता है और DeliveryVehicle को Tasks असाइन करता है.