Package maps.fleetengine.delivery.v1

इंडेक्स

DeliveryService

आखिरी मील डिलीवरी सेवा.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

यह नए Task ऑब्जेक्ट का बैच बनाता है और दिखाता है.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

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

rpc CreateTask(CreateTaskRequest) returns (Task)

नया Task ऑब्जेक्ट बनाता है और दिखाता है.
GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

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

rpc GetTask(GetTaskRequest) returns (Task)

किसी Task के बारे में जानकारी मिलती है.
GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

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

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

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

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

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

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Fleet Engine में अपडेट किया गया DeliveryVehicle डेटा लिखता है और DeliveryVehicle को Tasks असाइन करता है. आप DeliveryVehicle का नाम अपडेट नहीं कर सकते. remaining_vehicle_journey_segments को अपडेट किया जा सकता है. हालांकि, इसमें वे सभी VehicleJourneySegment होने चाहिए जिन्हें DeliveryVehicle में सेव करना है. task_id को remaining_vehicle_journey_segments से वापस पाया जाता है. साथ ही, अगर Tasks को अब तक असाइन नहीं किया गया है, तो उन्हें DeliveryVehicle को असाइन किया जाता है.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Task का डेटा अपडेट करता है.

BatchCreateTasksRequest

BatchCreateTask के अनुरोध का मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर. ध्यान दें: अगर आपने यह फ़ील्ड सेट किया है, तो CreateTaskRequest मैसेज में हेडर फ़ील्ड खाली होना चाहिए या यह इस फ़ील्ड से मेल खाना चाहिए.
parent

string

ज़रूरी है. सभी टास्क के साथ शेयर किया गया पैरंट रिसॉर्स. यह वैल्यू providers/{provider} फ़ॉर्मैट में होनी चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project. CreateTaskRequest मैसेज में पैरंट फ़ील्ड खाली होना चाहिए या यह इस फ़ील्ड से मेल खाना चाहिए.
requests[]

CreateTaskRequest

ज़रूरी है. अनुरोध मैसेज, जिसमें बनाने के लिए संसाधनों के बारे में बताया गया हो. ध्यान दें: एक बार में ज़्यादा से ज़्यादा 500 टास्क बनाए जा सकते हैं.

BatchCreateTasksResponse

BatchCreateTask का जवाब देने वाला मैसेज.

फ़ील्ड
tasks[]

Task

बनाए गए टास्क.

CreateDeliveryVehicleRequest

CreateDeliveryVehicle का अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
parent

string

ज़रूरी है. यह providers/{provider} फ़ॉर्मैट में होना चाहिए. प्रोवाइडर, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project.
delivery_vehicle_id

string

ज़रूरी है. डिलीवरी वाहन का आईडी यूनीक होना चाहिए. साथ ही, यह इन पाबंदियों के मुताबिक होना चाहिए:

  • एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इनमें से कोई भी ASCII वर्ण शामिल नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
delivery_vehicle

DeliveryVehicle

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

  • टाइप
  • last_location
  • विशेषताएं

ध्यान दें: DeliveryVehicle के name फ़ील्ड को अनदेखा किया जाता है. DeliveryVehicle के अन्य सभी फ़ील्ड सेट नहीं होने चाहिए. ऐसा करने पर, गड़बड़ी का मैसेज दिखता है.

CreateTaskRequest

CreateTask के अनुरोध का मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
parent

string

ज़रूरी है. providers/{provider} फ़ॉर्मैट में होना चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project.
task_id

string

ज़रूरी है. टास्क आईडी यूनीक होना चाहिए. हालांकि, यह शिपमेंट ट्रैकिंग आईडी नहीं होना चाहिए. शिपमेंट का ट्रैकिंग आईडी सेव करने के लिए, tracking_id फ़ील्ड का इस्तेमाल करें. ध्यान दें कि एक से ज़्यादा टास्क में एक ही tracking_id हो सकता है. टास्क आईडी पर ये पाबंदियां लागू होती हैं:

  • एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इसमें इनमें से कोई भी ASCII वर्ण नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
task

Task

ज़रूरी है. टास्क इकाई बनाने के लिए. टास्क बनाते समय, इन फ़ील्ड में जानकारी डालना ज़रूरी है:

  • type
  • state (OPEN पर सेट होना चाहिए)
  • tracking_id (इसे UNAVAILABLE या SCHEDULED_STOP टास्क के लिए सेट नहीं किया जाना चाहिए, लेकिन अन्य सभी तरह के टास्क के लिए ज़रूरी है)
  • planned_location (UNAVAILABLE टास्क के लिए ज़रूरी नहीं)
  • task_duration

ध्यान दें: टास्क के name फ़ील्ड को अनदेखा किया जाता है. अन्य सभी टास्क फ़ील्ड को सेट नहीं किया जाना चाहिए. ऐसा न करने पर, एक गड़बड़ी दिखती है.

DeliveryRequestHeader

requestHeader में सभी वितरण RPC अनुरोधों के लिए सामान्य फ़ील्ड शामिल होते हैं.

फ़ील्ड
language_code

string

BCP-47 भाषा कोड, जैसे कि en-US या sr-Latn. ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier देखें. अगर कोई भाषा नहीं दी गई है, तो जवाब किसी भी भाषा में हो सकता है. अगर कोई ऐसा नाम मौजूद है, तो अंग्रेज़ी को प्राथमिकता दी जाएगी. फ़ील्ड की वैल्यू का उदाहरण: en-US.
region_code

string

ज़रूरी है. उस इलाके का CLDR क्षेत्र कोड जहां से अनुरोध किया गया है. फ़ील्ड की वैल्यू का उदाहरण: US.
sdk_version

string

अगर लागू हो, तो कॉल करने वाले SDK टूल का वर्शन. वर्शन का फ़ॉर्मैट "major.minor.patch" है. उदाहरण के लिए: 1.1.2.
os_version

string

ऑपरेटिंग सिस्टम का वर्शन, जिस पर कॉलिंग SDK चल रहा है. फ़ील्ड की वैल्यू के उदाहरण: 4.4.1, 12.1.
device_model

string

उस डिवाइस का मॉडल जिस पर कॉलिंग एसडीके टूल चल रहा है. फ़ील्ड की वैल्यू के उदाहरण: iPhone12,1, SM-G920F.
sdk_type

SdkType

अनुरोध भेजने वाले SDK टूल का टाइप.
maps_sdk_version

string

MapSDK टूल का वह वर्शन जिस पर कॉल करने वाला SDK टूल निर्भर करता है. हालांकि, यह ज़रूरी नहीं है कि यह वैल्यू मौजूद हो. वर्शन का फ़ॉर्मैट "major.minor.patch" है. उदाहरण के लिए: 5.2.1.
nav_sdk_version

string

NavSDK टूल का वर्शन, जिस पर कॉल करने वाला SDK टूल निर्भर करता है. हालांकि, यह ज़रूरी नहीं है कि यह जानकारी दी जाए. वर्शन का फ़ॉर्मैट "major.minor.patch" है. उदाहरण के लिए: 2.1.0.
platform

Platform

कॉल करने वाले SDK टूल का प्लैटफ़ॉर्म.
manufacturer

string

कॉलिंग SDK टूल से Android डिवाइस निर्माता, सिर्फ़ Android SDK के लिए लागू होता है. फ़ील्ड की वैल्यू का उदाहरण: Samsung.
android_api_level

int32

कॉलिंग SDK का Android API लेवल, सिर्फ़ Android SDK के लिए लागू होता है. फ़ील्ड की वैल्यू का उदाहरण: 23.
trace_id

string

यह एक वैकल्पिक आईडी है. अनुरोध की पहचान करने के लिए, इसे लॉग करने के मकसद से दिया जा सकता है.

प्लैटफ़ॉर्म

कॉल करने वाले SDK टूल का प्लैटफ़ॉर्म.

Enums
PLATFORM_UNSPECIFIED डिफ़ॉल्ट वैल्यू. अगर प्लैटफ़ॉर्म को शामिल नहीं किया जाता है, तो इस वैल्यू का इस्तेमाल किया जाता है.
ANDROID अनुरोध, Android से आ रहा है.
IOS यह अनुरोध iOS से किया जा रहा है.
WEB अनुरोध, वेब से किया जा रहा हो.

SdkType

SDK टूल के संभावित टाइप.

Enums
SDK_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. अगर sdk_type को शामिल नहीं किया जाता है, तो इस वैल्यू का इस्तेमाल किया जाता है.
CONSUMER कॉल करने वाला SDK टूल, Consumer है.
DRIVER कॉल के लिए इस्तेमाल किया जाने वाला SDK टूल, ड्राइवर है.
JAVASCRIPT कॉल करने वाला SDK, JavaScript है.

DeliveryVehicle

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

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

फ़ील्ड
name

string

डिलीवरी के लिए इस्तेमाल होने वाले इस वाहन का यूनीक नाम. फ़ॉर्मैट providers/{provider}/deliveryVehicles/{vehicle} है.
last_location

DeliveryVehicleLocation

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

DeliveryVehicleNavigationStatus

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

bytes

कोड में बदली गई पॉलीलाइन, जो उस रास्ते की जानकारी देती है जिसका सुझाव नेविगेशन, अगले वेपॉइंट पर जाने के लिए देता है. ड्राइवर ऐप्लिकेशन, स्टॉप पर पहुंचने या उससे गुज़रने के साथ-साथ, नेविगेशन के रास्ते बदलने पर भी इस जानकारी को अपडेट करता है. वाहन के साथ असाइन किए गए सभी चालू टास्क के लिए, इन 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) को पॉप्युलेट करने के लिए नहीं किया जा सकता:

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

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

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

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

LatLng

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

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

Int32Value

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

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

Duration

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

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

VehicleJourneySegment

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

DeliveryVehicleAttribute

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

DeliveryVehicleType

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

DeliveryVehicleType

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

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

DeliveryVehicleAttribute

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

फ़ील्ड
key

string

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

string

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

string

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

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

bool

बूलियन टाइप की एट्रिब्यूट वैल्यू.
number_value

double

डबल टाइप की एट्रिब्यूट वैल्यू.

DeliveryVehicleLocation

किसी समय पर वाहन की जगह, रफ़्तार, और दिशा की जानकारी.

फ़ील्ड
location

LatLng

वाहन की जगह की जानकारी. जब फ़्लीट इंजन को भेजा जाता है, तो गाड़ी की जगह की जानकारी जीपीएस लोकेशन के तौर पर दिखती है. जब आपको जवाब में यह जानकारी मिलती है, तो वाहन की जगह की जानकारी, जीपीएस की जगह की जानकारी, अतिरिक्त जगह की जानकारी या अनुमानित जगह की जानकारी हो सकती है. सोर्स की जानकारी location_sensor में दी गई है.
horizontal_accuracy
(deprecated)

DoubleValue

अब काम नहीं करता: इसके बजाय, latlng_accuracy का इस्तेमाल करें.
latlng_accuracy

DoubleValue

location मीटर के दायरे के तौर पर सटीक.
heading

Int32Value

दिशा में वाहन डिग्री में चल रहा है. 0 का मतलब उत्तर है. मान की सही रेंज [0,360) है.
bearing_accuracy
(deprecated)

DoubleValue

बंद कर दिया गया है: इसके बजाय, heading_accuracy का इस्तेमाल करें.
heading_accuracy

DoubleValue

तापमान heading डिग्री तक सटीक है.
altitude

DoubleValue

WGS84 के ऊपर मीटर में ऊंचाई.
vertical_accuracy
(deprecated)

DoubleValue

बंद कर दिया गया है: इसके बजाय, altitude_accuracy का इस्तेमाल करें.
altitude_accuracy

DoubleValue

altitude मीटर तक सटीक.
speed_kmph
(deprecated)

Int32Value

वाहन की रफ़्तार, किलोमीटर प्रति घंटा में. बंद कर दिया गया है: इसके बजाय, speed का इस्तेमाल करें.
speed

DoubleValue

वाहन की रफ़्तार, मीटर/सेकंड में
speed_accuracy

DoubleValue

सटीक होने की जानकारी speed मीटर/सेकंड में.
update_time

Timestamp

सेंसर की घड़ी के हिसाब से, location की रिपोर्ट करने का समय.
server_time

Timestamp

सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को जगह की जानकारी मिली.
location_sensor

DeliveryVehicleLocationSensor

जगह की जानकारी का डेटा देने वाली कंपनी (उदाहरण के लिए, GPS).
is_road_snapped

BoolValue

location को सड़क पर स्नैप किया गया है या नहीं.
is_gps_sensor_enabled

BoolValue

सिर्फ़ इनपुट के लिए. इससे पता चलता है कि मोबाइल डिवाइस पर जीपीएस सेंसर चालू है या नहीं.
time_since_update

Int32Value

सिर्फ़ इनपुट के लिए. सर्वर पर इस जगह की जानकारी भेजे जाने के बाद से अब तक का समय (सेकंड में). यह पहले अपडेट के लिए शून्य होगा. अगर समय की जानकारी नहीं है (उदाहरण के लिए, जब ऐप्लिकेशन रीस्टार्ट होता है), तो यह वैल्यू शून्य पर रीसेट हो जाती है.
num_stale_updates
(deprecated)

Int32Value

सिर्फ़ इनपुट के लिए. अब इस्तेमाल नहीं किया जाता: किसी जगह की जानकारी पुरानी है या नहीं, यह पता लगाने के लिए अब दूसरे सिग्नल का इस्तेमाल किया जाता है.
raw_location

LatLng

वाहन की रॉ लोकेशन (रोड-स्नैपर से प्रोसेस नहीं की गई).
raw_location_time

Timestamp

रॉ लोकेशन से जुड़ा टाइमस्टैंप.
raw_location_sensor

DeliveryVehicleLocationSensor

रॉ लोकेशन का सोर्स. डिफ़ॉल्ट रूप से, यह GPS पर सेट होती है.
raw_location_accuracy

DoubleValue

raw_location की सटीक जानकारी, मीटर में त्रिज्या के तौर पर.
supplemental_location

LatLng

इंटिग्रेट किए गए ऐप्लिकेशन से मिली जगह की अतिरिक्त जानकारी.
supplemental_location_time

Timestamp

अतिरिक्त जगह की जानकारी से जुड़ा टाइमस्टैंप.
supplemental_location_sensor

DeliveryVehicleLocationSensor

पूरक लोकेशन का सोर्स. डिफ़ॉल्ट तौर पर, यह CUSTOMER_SUPPLIED_LOCATION पर सेट होता है.
supplemental_location_accuracy

DoubleValue

मीटर में, रेडियस के तौर पर supplemental_location की सटीक जानकारी.
road_snapped
(deprecated)

bool

अब काम नहीं करता: इसके बजाय, is_road_snapped का इस्तेमाल करें.

DeliveryVehicleLocationSensor

जगह का पता लगाने के लिए इस्तेमाल किया गया सेंसर या तरीका.

Enums
UNKNOWN_SENSOR सेंसर की जानकारी नहीं है या इसकी जानकारी नहीं है.
GPS GPS या असिस्टेड जीपीएस.
NETWORK असिस्टेड जीपीएस, सेल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
PASSIVE मोबाइल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
ROAD_SNAPPED_LOCATION_PROVIDER मोबाइल डिवाइस से तय की गई ऐसी जगह जो सड़क की सबसे सही जगह हो सकती है.
CUSTOMER_SUPPLIED_LOCATION किसी स्वतंत्र स्रोत से ग्राहक की ओर से दी जाने वाली जगह. आम तौर पर, इस वैल्यू का इस्तेमाल, ड्राइवर SDK टूल चलाने वाले मोबाइल डिवाइस के अलावा, किसी और सोर्स से मिली जगह की जानकारी के लिए किया जाता है. अगर ओरिजनल सोर्स के बारे में किसी अन्य ईनम वैल्यू से बताया गया है, तो उस वैल्यू का इस्तेमाल करें. CUSTOMER_SUPPLIED_LOCATION के तौर पर मार्क की गई जगहों की जानकारी, आम तौर पर डिलीवरी वाहन के last_location.supplemental_location_sensor से मिलती है.
FLEET_ENGINE_LOCATION Fleet Engine, उपलब्ध सिग्नल के आधार पर जगह की जानकारी का हिसाब लगाता है. सिर्फ़ आउटपुट के लिए. अगर यह वैल्यू किसी अनुरोध में मिलती है, तो उसे अस्वीकार कर दिया जाएगा.
FUSED_LOCATION_PROVIDER Android का Fused Location Provider.
CORE_LOCATION Apple के ऑपरेटिंग सिस्टम पर जगह की जानकारी देने वाली कंपनी.

DeliveryVehicleNavigationStatus

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

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

GetDeliveryVehicleRequest

GetDeliveryVehicle का अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
name

string

ज़रूरी है. यह providers/{provider}/deliveryVehicles/{delivery_vehicle} फ़ॉर्मैट में होना चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project.

GetTaskRequest

GetTask के अनुरोध का मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
name

string

ज़रूरी है. यह providers/{provider}/tasks/{task} फ़ॉर्मैट में होना चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project.

GetTaskTrackingInfoRequest

GetTaskTrackingInfoRequest के अनुरोध का मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
name

string

ज़रूरी है. यह providers/{provider}/taskTrackingInfo/{tracking_id} फ़ॉर्मैट में होना चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए और tracking_id, टास्क से जुड़ा ट्रैकिंग आईडी होना चाहिए. उदाहरण के लिए, providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

ListDeliveryVehicles का अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
parent

string

ज़रूरी है. providers/{provider} फ़ॉर्मैट में होना चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project.
page_size

int32

ज़रूरी नहीं. लौटाए जाने वाले वाहनों की ज़्यादा से ज़्यादा संख्या. हो सकता है कि सेवा इस संख्या से कम नतीजे दिखाए. अगर आपने यह संख्या नहीं दी है, तो सर्वर यह तय करता है कि कितने नतीजे दिखाने हैं.
page_token

string

ज़रूरी नहीं. पेज टोकन, जो पिछले ListDeliveryVehicles कॉल से मिला था. अगले पेज को फिर से पाने के लिए, आपको यह जानकारी देनी होगी.

पेजों पर नंबर डालते समय, ListDeliveryVehicles को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मैच होने चाहिए.
filter

string

ज़रूरी नहीं. डिलीवरी वाहनों की लिस्टिंग करते समय लागू करने के लिए फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरणों के लिए, http://aip.dev/160 देखें. अगर आपने कोई वैल्यू नहीं दी है या फ़िल्टर के लिए कोई खाली स्ट्रिंग दी है, तो सभी डिलीवरी वाहन दिखाए जाते हैं.

ध्यान दें कि ListDeliveryVehicles के लिए सिर्फ़ वाहन के एट्रिब्यूट (उदाहरण के लिए, attributes.<key> = <value> या attributes.<key1> = <value1> AND attributes.<key2> = <value2>) पर क्वेरी की जा सकती हैं. साथ ही, सभी एट्रिब्यूट को स्ट्रिंग के तौर पर सेव किया जाता है. इसलिए, एट्रिब्यूट के लिए सिर्फ़ स्ट्रिंग की तुलना की जा सकती है. संख्या या बूलियन वैल्यू की तुलना करने के लिए, वैल्यू को साफ़ तौर पर कोट किया जाना चाहिए, ताकि उन्हें स्ट्रिंग के तौर पर माना जा सके. उदाहरण के लिए, attributes.<key> = "10" या attributes.<key> = "true".

फ़िल्टर क्वेरी में ज़्यादा से ज़्यादा 50 पाबंदियां हो सकती हैं. पाबंदी, attribute.<KEY> <COMPARATOR> <VALUE> फ़ॉर्म की क्वेरी का हिस्सा होती है. उदाहरण के लिए, attributes.foo = bar एक पाबंदी है.
viewport

Viewport

ज़रूरी नहीं. यह फ़िल्टर, उन वाहनों को दिखाता है जिनकी पिछली जगह की जानकारी, व्यूपोर्ट के दायरे में मौजूद आयताकार इलाके में थी.

ListDeliveryVehiclesResponse

ListDeliveryVehicles का जवाब देने वाला मैसेज.

फ़ील्ड
delivery_vehicles[]

DeliveryVehicle

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

string

नतीजों की सूची जारी रखने के लिए, इस टोकन को ListDeliveryVehiclesRequest में पास किया जा सकता है. सभी नतीजे मिलने पर, यह फ़ील्ड जवाब में नहीं होगा या यह एक खाली स्ट्रिंग होगी.
total_size

int64

सभी पेजों पर, अनुरोध की ज़रूरी शर्तों से मैच करने वाले डिलीवरी वाहनों की कुल संख्या.

ListTasksRequest

ListTasks का अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
parent

string

ज़रूरी है. providers/{provider} फ़ॉर्मैट में होना चाहिए. provider, Google Cloud प्रोजेक्ट आईडी होना चाहिए. उदाहरण के लिए, sample-cloud-project.
page_size

int32

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितने टास्क दिखाने हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर आपने यह वैल्यू नहीं दी है, तो सर्वर यह तय करता है कि कितने नतीजे दिखाने हैं.
page_token

string

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

पेज बनाते समय, ListTasks के लिए दिए गए सभी अन्य पैरामीटर, उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया था.
filter

string

ज़रूरी नहीं. टास्क की सूची बनाते समय लागू करने के लिए फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरणों के लिए, http://aip.dev/160 देखें. अगर कोई वैल्यू नहीं दी जाती है या खाली स्ट्रिंग पर फ़िल्टर किया जाता है, तो सभी टास्क दिखाए जाते हैं. टास्क की उन प्रॉपर्टी के बारे में जानकारी पाने के लिए जिन पर फ़िल्टर किया जा सकता है, टास्क की सूची देखें.

ListTasksResponse

ListTasks रिस्पॉन्स, जिसमें Tasks का ऐसा सेट शामिल है जो ListTasksRequest में मौजूद फ़िल्टर की शर्तों को पूरा करता है.

फ़ील्ड
tasks[]

Task

टास्क का वह सेट जो फ़िल्टर करने के लिए बताई गई शर्तों को पूरा करता है. जब कोई फ़िल्टर तय नहीं किया गया हो, तो अनुरोध सभी टास्क दिखाता है. सफल जवाब खाली भी हो सकता है. खाली जवाब से पता चलता है कि फ़िल्टर के लिए तय की गई शर्तों को पूरा करने वाला कोई टास्क नहीं मिला.
next_page_token

string

नतीजों की सूची जारी रखने के लिए, इस टोकन को ListTasksRequest में पास करें. अगर सभी नतीजे दिखाए गए हैं, तो यह फ़ील्ड खाली स्ट्रिंग है या यह जवाब में नहीं दिखता.
total_size

int64

सभी पेजों पर, अनुरोध की शर्तों से मैच करने वाले टास्क की कुल संख्या.

LocationInfo

अतिरिक्त आइडेंटिफ़ायर वाली जगह.

फ़ील्ड
point

LatLng

जगह के निर्देशांक.

टास्क

Delivery API में मौजूद टास्क, ट्रैक करने के लिए एक ही कार्रवाई दिखाता है. आम तौर पर, शिपमेंट से जुड़े टास्क और ब्रेक टास्क में अंतर होता है. किसी शिपमेंट से जुड़े कई टास्क हो सकते हैं. उदाहरण के लिए, पिकअप के लिए एक टास्क और डिलीवरी या ट्रांसफ़र के लिए एक टास्क हो सकता है. साथ ही, किसी शिपमेंट के लिए अलग-अलग टास्क, अलग-अलग वाहनों से मैनेज किए जा सकते हैं. उदाहरण के लिए, एक वाहन शिपमेंट को पिकअप करके हब तक ले जा सकता है, जबकि दूसरा वाहन उसी शिपमेंट को हब से डिलीवरी की जगह तक ले जा सकता है.

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

फ़ील्ड
name

string

यह providers/{provider}/tasks/{task} फ़ॉर्मैट में होना चाहिए.
type

Type

ज़रूरी है. इम्यूटेबल. टास्क का टाइप तय करता है. उदाहरण के लिए, ब्रेक या शिपमेंट.
state

State

ज़रूरी है. टास्क को लागू करने की मौजूदा स्थिति.
task_outcome

TaskOutcome

टास्क का नतीजा.
task_outcome_time

Timestamp

टाइमस्टैंप, जो बताता है कि सेवा देने वाली कंपनी ने Task का नतीजा कब सेट किया था.
task_outcome_location

LocationInfo

वह जगह जहां Task का नतीजा सेट किया गया था. इस वैल्यू को UpdateTask के हिस्से के तौर पर अपडेट किया जाता है. अगर सेवा देने वाली कंपनी ने इस वैल्यू को साफ़ तौर पर अपडेट नहीं किया है, तो Fleet Engine इसे डिफ़ॉल्ट रूप से, वाहन की पिछली जगह की जानकारी (रॉ जगह की जानकारी) से पॉप्युलेट करता है.
task_outcome_location_source

TaskOutcomeLocationSource

इससे पता चलता है कि task_outcome_location की वैल्यू कहां से मिली है.
tracking_id

string

इम्यूटेबल. इस फ़ील्ड की मदद से, आईडी को सेव किया जा सकता है, ताकि आपको जटिल मैपिंग का इस्तेमाल न करना पड़े. UNAVAILABLE और SCHEDULED_STOP टाइप के टास्क के लिए, tracking_id सेट नहीं किया जा सकता. इन आईडी पर ये पाबंदियां लागू होती हैं:

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • इसे यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया जाता है.
  • इसमें इनमें से कोई भी ASCII वर्ण नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
delivery_vehicle_id

string

सिर्फ़ आउटपुट के लिए. उस वाहन का आईडी जो यह टास्क पूरा कर रहा है. डिलीवरी वाहन के आईडी पर ये पाबंदियां लागू होती हैं:

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इसमें इनमें से कोई भी ASCII वर्ण नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
planned_location

LocationInfo

इम्यूटेबल. वह जगह जहां टास्क पूरा किया जाएगा. UNAVAILABLE टास्क के लिए ज़रूरी नहीं है, लेकिन दूसरे सभी टास्क के लिए ज़रूरी है.
task_duration

Duration

ज़रूरी है. इम्यूटेबल. इस जगह पर टास्क पूरा करने में लगने वाला समय.
target_time_window

TimeWindow

वह समयसीमा जिसके दौरान टास्क पूरा किया जाना चाहिए.
journey_sharing_info

JourneySharingInfo

सिर्फ़ आउटपुट के लिए. यात्रा की जानकारी शेयर करने से जुड़े फ़ील्ड. राज्य CLOSED होने पर अपने-आप जानकारी नहीं भरती.
task_tracking_view_config

TaskTrackingViewConfig

टास्क ट्रैकिंग के लिए कॉन्फ़िगरेशन, जो यह तय करता है कि किन परिस्थितियों में असली उपयोगकर्ताओं को कौनसे डेटा एलिमेंट दिखेंगे.
attributes[]

TaskAttribute

टास्क के कस्टम एट्रिब्यूट की सूची. हर एट्रिब्यूट की एक खास कुंजी होनी चाहिए.

JourneySharingInfo

खास फ़ील्ड शेयर करने की प्रोसेस.

फ़ील्ड
remaining_vehicle_journey_segments[]

VehicleJourneySegment

उन स्टॉप की जानकारी ट्रैक करना जिन्हें असाइन किया गया वाहन, इस टास्क के पूरा होने से पहले करेगा. ध्यान दें कि इस सूची में, अन्य टास्क के स्टॉप भी शामिल हो सकते हैं.

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

DeliveryVehicleLocation

यह असाइन किए गए वाहन की पिछली जगह की जानकारी दिखाता है.
last_location_snappable

bool

यह बताता है कि वाहन की आखिरी जगह की जानकारी को current_route_segment पर स्नैप किया जा सकता है या नहीं. अगर last_location या current_route_segment मौजूद नहीं है, तो यह वैल्यू False होती है. इस वैल्यू का हिसाब, Fleet Engine लगाता है. क्लाइंट से मिले अपडेट को अनदेखा किया जाता है.

स्थिति

टास्क की स्थिति. इससे Tasks की प्रोग्रेस का पता चलता है.

Enums
STATE_UNSPECIFIED डिफ़ॉल्ट. इसका इस्तेमाल, टास्क की ऐसी स्थिति के लिए किया जाता है जिसकी जानकारी नहीं दी गई है या जिसकी पहचान नहीं की जा सकी है.
OPEN टास्क को डिलीवरी वाहन को अभी तक असाइन नहीं किया गया है या डिलीवरी वाहन, Task के असाइन किए गए वाहन स्टॉप से अभी तक नहीं गुज़रा है.
CLOSED जब वाहन इस टास्क के लिए, वाहन के स्टॉप से गुज़रता है.

TaskOutcome

टास्क को लागू करने की कोशिश का नतीजा. TaskState बंद होने पर, TaskOutcome से पता चलता है कि प्रोसेस पूरी हुई या नहीं.

Enums
TASK_OUTCOME_UNSPECIFIED वैल्यू सेट होने से पहले, टास्क का नतीजा.
SUCCEEDED टास्क पूरा हो गया.
FAILED टास्क पूरा नहीं हो सका या उसे रद्द कर दिया गया.

TaskOutcomeLocationSource

task_outcome_location को पॉप्युलेट करने वाले सोर्स की पहचान.

Enums
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED टास्क सेट होने से पहले उसका आउटपुट.
PROVIDER सेवा देने वाली कंपनी ने task_outcome_location की जानकारी दी है.
LAST_VEHICLE_LOCATION सेवा देने वाली कंपनी ने task_outcome_location की जानकारी नहीं दी है. इसलिए, Fleet Engine ने वाहन की पिछली लोकेशन का इस्तेमाल किया है.

टाइप

टास्क का टाइप.

Enums
TYPE_UNSPECIFIED डिफ़ॉल्ट रूप से, टास्क का टाइप पता नहीं होता.
PICKUP पिकअप टास्क, किसी खरीदार से शिपमेंट लेने के लिए की गई कार्रवाई है. डिपो या फ़ीडिंग वाहन के पिकअप के लिए, SCHEDULED_STOP टाइप का इस्तेमाल किया जाना चाहिए.
DELIVERY डिलीवरी टास्क, किसी ग्राहक को शिपमेंट भेजने के लिए की जाने वाली कार्रवाई है. डिपो या फ़ीडर वाहन के ड्रॉपऑफ़ के लिए, SCHEDULED_STOP टाइप का इस्तेमाल किया जाना चाहिए.
SCHEDULED_STOP शेड्यूल किए गए स्टॉप टास्क का इस्तेमाल, प्लान बनाने के लिए किया जाता है. उदाहरण के लिए, यह फ़ीडर वाहनों या डिपो से शिपमेंट को पिक अप या ड्रॉप करने का काम कर सकता है. इसका इस्तेमाल ऐसे किसी भी शिपमेंट के लिए नहीं किया जाना चाहिए जिसे असली ग्राहक से पिक अप या ड्रॉप किया गया हो.
UNAVAILABLE ऐसा टास्क जिसका मतलब है कि वाहन, सर्विस के लिए उपलब्ध नहीं है. उदाहरण के लिए, ऐसा तब हो सकता है, जब ड्राइवर ब्रेक लेता है या गाड़ी में ईंधन भरा जा रहा हो.

TaskAttribute

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

फ़ील्ड
key

string

एट्रिब्यूट की कुंजी. बटन में कोलन वर्ण (:) नहीं हो सकता.
यूनियन फ़ील्ड task_attribute_value. एट्रिब्यूट की वैल्यू, स्ट्रिंग, बूल या डबल टाइप में हो सकती है. अगर कोई भी सेट नहीं है, तो TaskAttribute की स्ट्रिंग_वैल्यू को खाली स्ट्रिंग "" के तौर पर सेव किया जाएगा. task_attribute_value इनमें से सिर्फ़ एक हो सकता है:
string_value

string

स्ट्रिंग टाइप की गई एट्रिब्यूट वैल्यू.
bool_value

bool

बूलियन टाइप की एट्रिब्यूट वैल्यू.
number_value

double

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

TaskTrackingInfo

TaskTrackingInfo मैसेज. मैसेज में टास्क की ट्रैकिंग की जानकारी होती है. इसका इस्तेमाल डिसप्ले के लिए किया जाएगा. अगर कोई ट्रैकिंग आईडी एक से ज़्यादा टास्क से जुड़ा है, तो Fleet Engine यह तय करने के लिए, हेयुरिस्टिक का इस्तेमाल करता है कि किस टास्क की TaskTrackingInfo चुननी है.

फ़ील्ड
name

string

यह providers/{provider}/taskTrackingInfo/{tracking} फ़ॉर्मैट में होना चाहिए, जहां tracking ट्रैकिंग आईडी को दिखाता है.
tracking_id

string

इम्यूटेबल. किसी टास्क का ट्रैकिंग आईडी. * यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए. * इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं. * यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया. * इसमें इनमें से कोई भी ASCII वर्ण नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
vehicle_location

DeliveryVehicleLocation

वाहन की आखिरी जगह की जानकारी.
route_polyline_points[]

LatLng

पॉइंट की सूची, जो कनेक्ट होने पर, इस टास्क की जगह तक वाहन के अनुमानित रास्ते की पॉलीलाइन बनाती है.
remaining_stop_count

Int32Value

इससे पता चलता है कि टास्क स्टॉप तक पहुंचने में, वाहन को कितने स्टॉप पर रुकना पड़ेगा. इसमें टास्क स्टॉप भी शामिल है. उदाहरण के लिए, अगर वाहन का अगला स्टॉप टास्क स्टॉप है, तो वैल्यू 1 होगी.
remaining_driving_distance_meters

Int32Value

आपकी पसंद के VehicleStop तक की कुल दूरी, मीटर में.
estimated_arrival_time

Timestamp

वह टाइमस्टैंप जो स्टॉप की जगह तक पहुंचने का अनुमानित समय दिखाता है.
estimated_task_completion_time

Timestamp

टाइमस्टैंप, जो किसी टास्क को पूरा करने में लगने वाले अनुमानित समय के बारे में बताता है.
state

State

टास्क को लागू करने की मौजूदा स्थिति.
task_outcome

TaskOutcome

टास्क को लागू करने की कोशिश का नतीजा.
task_outcome_time

Timestamp

टाइमस्टैंप, जो यह बताता है कि सेवा देने वाली कंपनी ने टास्क का नतीजा कब सेट किया था.
planned_location

LocationInfo

इम्यूटेबल. वह जगह जहां टास्क पूरा करना है.
target_time_window

TimeWindow

वह समयसीमा जिसके दौरान टास्क पूरा किया जाना चाहिए.
attributes[]

TaskAttribute

टास्क पर सेट किए गए कस्टम एट्रिब्यूट.

TaskTrackingViewConfig

वह कॉन्फ़िगरेशन मैसेज जो तय करता है कि किसी टास्क का डेटा एलिमेंट, असली उपयोगकर्ताओं को कब दिखना चाहिए.

फ़ील्ड
route_polyline_points_visibility

VisibilityOption

यह फ़ील्ड बताता है कि रास्ते के पॉलीलाइन पॉइंट कब दिख सकते हैं. अगर यह फ़ील्ड तय नहीं किया गया है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर मौजूद डिफ़ॉल्ट 'किसको दिखे' कॉन्फ़िगरेशन का इस्तेमाल किया जाएगा.
estimated_arrival_time_visibility

VisibilityOption

पहुंचने का अनुमानित समय कब बताया जाता है, इसकी जानकारी देने वाले फ़ील्ड को देखा जा सकता है. अगर यह फ़ील्ड तय नहीं किया गया है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर मौजूद डिफ़ॉल्ट 'किसको दिखे' कॉन्फ़िगरेशन का इस्तेमाल किया जाएगा.
estimated_task_completion_time_visibility

VisibilityOption

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

VisibilityOption

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

VisibilityOption

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

VisibilityOption

यह फ़ील्ड बताता है कि वाहन की जगह की जानकारी कब दिख सकती है. अगर यह फ़ील्ड तय नहीं किया गया है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर मौजूद डिफ़ॉल्ट 'किसको दिखे' कॉन्फ़िगरेशन का इस्तेमाल किया जाएगा.

VisibilityOption

विकल्प मैसेज, जो यह तय करता है कि असली उपयोगकर्ताओं को डेटा एलिमेंट कब दिखना चाहिए.

फ़ील्ड
यूनियन फ़ील्ड visibility_option. 'किसको दिखे' सेटिंग के लिए चुना गया विकल्प. visibility_option इनमें से कोई एक हो सकता है:
remaining_stop_count_threshold

int32

यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब बचे हुए स्टॉप की संख्या <= remaining_stop_count_threshold हो.
duration_until_estimated_arrival_time_threshold

Duration

यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब बस स्टॉप पर पहुंचने का अनुमानित समय <= अनुमानित पहुंचने के समय की सीमा तक की अवधि हो.
remaining_driving_distance_meters_threshold

int32

यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब ड्राइविंग के लिए बची हुई दूरी मीटर में <= back_driving_distance_meters_threshold हो.
always

bool

अगर नीति को 'सही है' पर सेट किया जाता है, तो यह डेटा एलिमेंट बिना थ्रेशोल्ड वाले असली उपयोगकर्ताओं को हमेशा दिखता है. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता.
never

bool

अगर इस विकल्प को 'सही' पर सेट किया जाता है, तो यह डेटा एलिमेंट, असली उपयोगकर्ताओं से हमेशा छिपा रहता है. इसके लिए, थ्रेशोल्ड की ज़रूरत नहीं होती. इस फ़ील्ड को गलत पर सेट नहीं किया जा सकता.

TimeWindow

समयसीमा.

फ़ील्ड
start_time

Timestamp

ज़रूरी है. समय विंडो के शुरू होने का समय (शामिल है).
end_time

Timestamp

ज़रूरी है. समयसीमा खत्म होने का समय.

UpdateDeliveryVehicleRequest

UpdateDeliveryVehicle का अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
delivery_vehicle

DeliveryVehicle

ज़रूरी है. लागू करने के लिए DeliveryVehicle इकाई का अपडेट. ध्यान दें: DeliveryVehicle का नाम अपडेट नहीं किया जा सकता.
update_mask

FieldMask

ज़रूरी है. फ़ील्ड मास्क, जो यह बताता है कि किन DeliveryVehicle फ़ील्ड को अपडेट करना है. ध्यान दें कि updated_mask में कम से कम एक फ़ील्ड होना चाहिए.

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "remaining_vehicle_journey_segments".

UpdateTaskRequest

UpdateTask का अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर.
task

Task

ज़रूरी है. अपडेट से जुड़ा टास्क. इन फ़ील्ड को Fleet Engine मैनेज करता है. Task.update का इस्तेमाल करके, इन्हें अपडेट न करें.

  • last_location.
  • last_location_snappable.
  • name.
  • remaining_vehicle_journey_segments.
  • task_outcome_location_source.

ध्यान दें: task_outcome की वैल्यू सेट करने के बाद, उसे बदला नहीं जा सकता.

अगर टास्क किसी डिलीवरी व्हीकल को असाइन किया गया है, तो Task.update का इस्तेमाल करके टास्क की स्थिति को 'बंद है' पर सेट न करें. इसके बजाय, डिलीवरी वाहन से उस VehicleStop को हटा दें जिसमें Tasks मौजूद है. इससे टास्क की स्थिति अपने-आप 'बंद है' पर सेट हो जाती है.
update_mask

FieldMask

ज़रूरी है. फ़ील्ड मास्क, जो यह बताता है कि टास्क के किन फ़ील्ड को अपडेट करना है. ध्यान दें: update_mask में कम से कम एक फ़ील्ड होना चाहिए.

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

इससे वाहन के यात्रा सेगमेंट के बारे में पता चलता है. जैसे, पिछले स्टॉप से मौजूदा स्टॉप तक. अगर यह पहला चालू स्टॉप है, तो इसका मतलब है कि यह गाड़ी की मौजूदा जगह से इस स्टॉप तक की दूरी है.

फ़ील्ड
stop

VehicleStop

स्टॉप की जगह की जानकारी के साथ-साथ, स्टॉप से जुड़े Task की जानकारी देता है. अगर यात्रा का यह सेगमेंट JourneySharingInfo का हिस्सा है, तो हो सकता है कि व्हीकलस्टॉप के कुछ फ़ील्ड मौजूद न हों.
driving_distance_meters

Int32Value

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

Duration

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

अगर इस फ़ील्ड को पाथ Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) या Task.remainingVehicleJourneySegments[0].drivingDuration (REST) में तय किया गया है, तो इसे DeliveryVehicle.remaining_duration (gRPC) या DeliveryVehicle.remainingDuration (REST) की वैल्यू से पॉप्युलेट किया जा सकता है. इससे, ड्राइवर ऐप्लिकेशन की पिछली जगह की जानकारी के बजाय, मौजूदा जगह से ड्राइविंग में लगने वाला समय पता चलता है.
path[]

LatLng

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

अगर इस फ़ील्ड को पाथ Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) या Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) में तय किया गया है, तो इसे DeliveryVehicle.current_route_segment (gRPC) या DeliveryVehicle.currentRouteSegment (REST) से डिकोड किए गए LatLng से पॉप्युलेट किया जा सकता है. इससे, ड्राइवर ऐप्लिकेशन की पिछली जगह की जानकारी के बजाय, उसकी मौजूदा जगह की जानकारी के हिसाब से ड्राइविंग का रास्ता मिलता है.

VehicleStop

उस पॉइंट के बारे में बताता है जहां वाहन एक या एक से ज़्यादा Task करने के लिए रुकता है.

फ़ील्ड
planned_location

LocationInfo

ज़रूरी है. स्टॉप की जगह. ध्यान दें कि हो सकता है कि Task में दी गई जगहें, इस जगह से पूरी तरह मेल न खाएं. हालांकि, वे इस जगह के आस-पास ही होंगी. GetTask कॉल के जवाब में, यह फ़ील्ड अपने-आप नहीं भरेगा.
tasks[]

TaskInfo

इस स्टॉप पर किए जाने वाले Task की सूची. GetTask कॉल के जवाब में, यह फ़ील्ड अपने-आप नहीं भरेगा.
state

State

VehicleStop की स्थिति. GetTask कॉल के जवाब में, यह फ़ील्ड अपने-आप नहीं भरेगा.

स्थिति

VehicleStop की मौजूदा स्थिति.

Enums
STATE_UNSPECIFIED अज्ञात.
NEW बनाया गया, लेकिन रूट नहीं किया जा रहा है.
ENROUTE असाइन किया गया और सक्रिय रूप से रूट किया जा रहा है.
ARRIVED बस स्टॉप पर पहुंच गई. यह मान लिया जाता है कि जब वाहन अगले स्टॉप पर जा रहा है, तो पिछले सभी स्टॉप पूरे हो चुके हैं.

TaskInfo

इस स्टॉप पर किए गए टास्क के बारे में ज़्यादा जानकारी.

फ़ील्ड
task_id

string

टास्क आईडी. GetTask कॉल के जवाब में, यह फ़ील्ड अपने-आप नहीं भरेगा. टास्क आईडी पर ये पाबंदियां लागू होती हैं:

  • एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इनमें से कोई भी ASCII वर्ण शामिल नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
task_duration

Duration

सिर्फ़ आउटपुट के लिए. टास्क पूरा करने में लगने वाला समय.
target_time_window

TimeWindow

सिर्फ़ आउटपुट के लिए. वह समयसीमा जिसके दौरान टास्क पूरा किया जाना चाहिए. यह सिर्फ़ GetDeliveryVehicle के जवाब में सेट किया जाता है.