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)
  },
  "pastLocations": [
    {
      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)

डिलीवरी वाहन की पिछली बार रिपोर्ट की गई जगह की जानकारी.
pastLocations[]

object (DeliveryVehicleLocation)

सिर्फ़ इनपुट के लिए. ऐसी जगहें जहां यह डिलीवरी वाहन पहले गया था, लेकिन अब तक Fleet Engine को इसकी जानकारी नहीं दी गई है. इसका इस्तेमाल UpdateDeliveryVehicleRequest में, उन जगहों को रिकॉर्ड करने के लिए किया जाता है जिन्हें पहले सर्वर पर नहीं भेजा जा सका था. आम तौर पर, ऐसा तब होता है, जब डिलीवरी वाहन में इंटरनेट कनेक्शन न हो.
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 पुरानी है और वाहन के पिछले स्टॉप की जानकारी देती है.

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

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

object (LatLng)

वह जगह जहां currentRouteSegment खत्म होता है. फ़िलहाल, ड्राइवर ऐप्लिकेशन से यह जानकारी अपने-आप नहीं भरती. हालांकि, deliveryVehicles.patch कॉल पर यह जानकारी दी जा सकती है. यह आने वाले वाहन के स्टॉप का LatLng या currentRouteSegment का आखिरी LatLng होता है. इसके बाद, Fleet Engine असल 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 फ़ील्ड खाली है, तो Fleet Engine 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 मोड़-दर-मोड़ निर्देश उपलब्ध हैं और Driver ऐप्लिकेशन का नेविगेशन 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 बनाता है और उसे दिखाता है.

delete

 Fleet Engine से DeliveryVehicle मिटाता है.

get

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

list

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

patch

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