REST Resource: providers.deliveryVehicles

संसाधन: DeliveryVehicle

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 पुराना है. यह वाहन के किसी पिछले स्टॉप के बारे में बताता है.

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

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

object (LatLng)

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

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

integer

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

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

string (Duration format)

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

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

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

object (VehicleJourneySegment)

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

object (DeliveryVehicleAttribute)

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

enum (DeliveryVehicleType)

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

DeliveryVehicleNavigationStatus

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

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

DeliveryVehicleAttribute

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

जेएसओएन के काेड में दिखाना 
{
  "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 डेटा, Fleet Engine में सेव करता है और Tasks को DeliveryVehicle को असाइन करता है.