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 पुराना है और यह पिछले वाहन स्टॉप की जानकारी देता है.

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

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

object (LatLng)

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

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

integer

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

get

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

list

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

patch

 यह फ़्लीट इंजन में, DeliveryVehicle का अपडेट किया गया डेटा लिखता है और DeliveryVehicle को Tasks असाइन करता है.