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 ऑब्जेक्ट बनाता है और उसे दिखाता है.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

यह फ़ंक्शन, Fleet Engine से DeliveryVehicle मिटाता है.

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

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

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

अगर टास्क OPEN है और उसे DeliveryVehicle को असाइन किया गया है, तो यह 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)

यह कुकी, अपडेट किए गए DeliveryVehicle डेटा को Fleet Engine में लिखती है. साथ ही, Tasks को DeliveryVehicle असाइन करती है. DeliveryVehicle का नाम अपडेट नहीं किया जा सकता. remaining_vehicle_journey_segments को अपडेट किया जा सकता है. हालांकि, DeliveryVehicle पर बने रहने के लिए, इसमें सभी VehicleJourneySegment शामिल होने चाहिए. 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 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म सी के हिसाब से नॉर्मलाइज़ किया गया हो.
  • इसमें ये 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 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म सी के हिसाब से नॉर्मलाइज़ किया गया हो.
  • इसमें ये 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

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

string

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

SdkType

अनुरोध भेजने वाला एसडीके किस तरह का है.
maps_sdk_version

string

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

string

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

Platform

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

string

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

int32

कॉल करने वाले SDK टूल का Android एपीआई लेवल. यह सिर्फ़ Android SDK टूल पर लागू होता है. फ़ील्ड की वैल्यू का उदाहरण: 23.
trace_id

string

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

प्लैटफ़ॉर्म

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

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

SdkType

एसडीके के संभावित टाइप.

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 की सटीक जानकारी.
flp_location

LatLng

Android के Fused Location Provider से मिली जगह की जानकारी.
flp_update_time

Timestamp

flp_location के अपडेट का टाइमस्टैंप
flp_latlng_accuracy_meters

DoubleValue

रेडियस के तौर पर, flp_location मीटर की सटीक जानकारी.
flp_heading_degrees

Int32Value

वाहन के चलने की दिशा को डिग्री में दिखाया जाता है. यह जानकारी, फ़्यूज़्ड लोकेशन प्रोवाइडर से मिलती है. 0 का मतलब उत्तर है. मान्य रेंज [0,360) है.
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 या असिस्टेड GPS.
NETWORK एसिस्टेड जीपीएस, सेल टॉवर आईडी या वाईफ़ाई ऐक्सेस पॉइंट.
PASSIVE मोबाइल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
ROAD_SNAPPED_LOCATION_PROVIDER मोबाइल डिवाइस से पता लगाई गई ऐसी जगह जो सड़क पर मौजूद होने की सबसे ज़्यादा संभावना रखती है.
CUSTOMER_SUPPLIED_LOCATION किसी ग्राहक की दी गई जगह की जानकारी, जो किसी स्वतंत्र स्रोत से मिली हो. आम तौर पर, इस वैल्यू का इस्तेमाल उस जगह की जानकारी के लिए किया जाता है जो Driver SDK चलाने वाले मोबाइल डिवाइस के अलावा किसी अन्य सोर्स से मिली हो. अगर ओरिजनल सोर्स को अन्य enum वैल्यू में से किसी एक से दिखाया गया है, तो उस वैल्यू का इस्तेमाल करें. CUSTOMER_SUPPLIED_LOCATION के तौर पर मार्क की गई जगहों की जानकारी आम तौर पर, DeliveryVehicle के 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 जवाब में, ऐसे टास्क का सेट होता है जो ListTasksRequest में फ़िल्टर करने की शर्तों को पूरा करते हैं.

फ़ील्ड
tasks[]

Task

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

string

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

int64

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

LocationInfo

कोई ऐसी जगह जिसके लिए कोई अतिरिक्त आइडेंटिफ़ायर मौजूद हो.

फ़ील्ड
point

LatLng

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

string

उस जगह का संसाधन नाम जो इस जगह को दिखाता है. फ़ॉर्मैट places/{place_id} है. इनपुट के तौर पर point या place में से किसी एक की जानकारी देना ज़रूरी है. अगर दोनों दिए गए हैं, तो रूटिंग के लिए point और मेटाडेटा के लिए place का इस्तेमाल किया जाएगा. place को सिर्फ़ तब आउटपुट में शामिल किया जाता है, जब इसे इनपुट में शामिल किया गया हो. इसका मतलब है कि LatLng से place लुकअप नहीं किया जाता है.

इस सुविधा को प्रयोग के तौर पर दिया जा रहा है.
point_location_source

PointSource

सिर्फ़ आउटपुट के लिए. latlng point फ़ील्ड का सोर्स. यह सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है.

PointSource

इससे LatLng के सोर्स के बारे में पता चलता है.

Enums
POINT_SOURCE_UNSPECIFIED पॉइंट सोर्स की जानकारी नहीं दी गई है.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng को डेवलपर ने साफ़ तौर पर उपलब्ध कराया था.
POINT_SOURCE_CALCULATED_FROM_PLACE 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 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म सी के हिसाब से नॉर्मलाइज़ किया गया हो.
  • इसमें ये ASCII वर्ण शामिल नहीं होने चाहिए: '/', ':', '?', ',' या '#'.
delivery_vehicle_id

string

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

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

LocationInfo

इम्यूटेबल. वह जगह जहां टास्क पूरा किया जाएगा. UNAVAILABLE Tasks के लिए ज़रूरी नहीं है, लेकिन अन्य सभी Tasks के लिए ज़रूरी है.
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 लगाता है. क्लाइंट से मिले अपडेट को अनदेखा किया जाता है.

स्थिति

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

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 की string_value को खाली स्ट्रिंग "" के तौर पर सेव किया जाएगा. 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

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

फ़ील्ड
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 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म सी के हिसाब से नॉर्मलाइज़ किया गया हो.
  • इसमें ये ASCII वर्ण शामिल नहीं होने चाहिए: '/', ':', '?', ',' या '#'.
task_duration

Duration

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

TimeWindow

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