Package maps.fleetengine.delivery.v1

इंडेक्स

DeliveryService

The Last Mile डिलीवरी सेवा.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

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

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

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

rpc CreateTask(CreateTaskRequest) returns (Task)

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

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

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

अगर DeliveryVehicle के लिए, पूरे नहीं किए गए टास्क असाइन हैं, तो FAILED_PRECONDITION दिखाता है.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

किसी एक टास्क को मिटाता है.

अगर टास्क 'खुला है' स्टेटस में है और उसे किसी डिलीवरी वाहन को असाइन किया गया है, तो FAILED_PRECONDITION दिखाता है.
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

नीचे दिए गए फ़ील्ड को सेट करना ज़रूरी नहीं है:

  • target_time_window
  • task_tracking_view_config
  • attributes

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

DeleteDeliveryVehicleRequest

DeleteDeliveryVehicle अनुरोध मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

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

string

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

DeleteTaskRequest

DeleteTask का अनुरोध करने वाला मैसेज.

फ़ील्ड
header

DeliveryRequestHeader

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

string

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

DeliveryRequestHeader

RequestHeader में, डिलीवरी आरपीसी के सभी अनुरोधों के लिए सामान्य फ़ील्ड होते हैं.

फ़ील्ड
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 एपीआई लेवल. यह सिर्फ़ 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 टूल, Driver है.
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

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

DeliveryVehicleLocation

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

DeliveryVehicleNavigationStatus

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

bytes

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

  • 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 होता है. इसके बाद, Fleet Engine असल 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

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

फ़ील्ड
tasks[]

Task

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

string

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

int64

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

LocationInfo

ऐसी जगह जिसका कोई अन्य आइडेंटिफ़ायर हो.

फ़ील्ड
point

LatLng

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

टास्क

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

ध्यान दें: 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

यह बताता है कि वाहन की lastLocation को 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

यह डेटा एलिमेंट, असली उपयोगकर्ताओं को तब दिखता है, जब ड्राइविंग की बाकी दूरी मीटर में <= remaining_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 फ़ील्ड को अपडेट करना है. ध्यान दें कि update_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 को हटाएं जिसमें टास्क शामिल है. इससे टास्क का स्टेटस अपने-आप 'पूरा हो गया' पर सेट हो जाएगा.
update_mask

FieldMask

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

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

VehicleJourneySegment

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

फ़ील्ड
stop

VehicleStop

स्टॉप की जगह की जानकारी के साथ-साथ, स्टॉप से जुड़े Task की जानकारी देता है. अगर यह यात्रा का सेगमेंट JourneySharingInfo का हिस्सा है, तो हो सकता है कि VehicleStop के कुछ फ़ील्ड मौजूद न हों.
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 के जवाब में सेट किया जाता है.