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

अगर currentRouteSegment फ़ील्ड खाली होता है, तो फ़्लीट इंजन 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 ड्राइवर ऐप्लिकेशन का नेविगेशन 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

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