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)

यह फ़्लीट इंजन में, DeliveryVehicle का अपडेट किया गया डेटा लिखता है और DeliveryVehicle को Tasks असाइन करता है. आप 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

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

parent

string

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

requests[]

CreateTaskRequest

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

BatchCreateTasksResponse

BatchCreateTask रिस्पॉन्स मैसेज.

फ़ील्ड
tasks[]

Task

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

CreateDeliveryVehicleRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

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

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

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

उस डिवाइस का मॉडल जिस पर, कॉल करने के लिए इस्तेमाल किया जाने वाला SDK टूल चल रहा है. फ़ील्ड वैल्यू के उदाहरण: 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 टूल, उपभोक्ता है.
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 पुराना है और यह वाहन को पिछले स्टॉप पर ले जाता है.

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

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

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

remaining_duration

Duration

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

अगर current_route_segment फ़ील्ड खाली होता है, तो फ़्लीट इंजन 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 या सहायता प्राप्त GPS.
NETWORK सहायता पाने वाला जीपीएस, सेल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
PASSIVE सेल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
ROAD_SNAPPED_LOCATION_PROVIDER मोबाइल डिवाइस के ज़रिए तय की गई कोई जगह. यह सड़क की स्थिति के तौर पर सबसे अच्छी होती है.
CUSTOMER_SUPPLIED_LOCATION किसी स्वतंत्र स्रोत से ग्राहक की ओर से दी जाने वाली जगह. आम तौर पर, इस वैल्यू का इस्तेमाल, ड्राइवर SDK टूल चलाने वाले मोबाइल डिवाइस के अलावा, किसी और सोर्स से मिली जगह की जानकारी के लिए किया जाता है. अगर ओरिजनल सोर्स के बारे में किसी अन्य ईनम वैल्यू से बताया गया है, तो उस वैल्यू का इस्तेमाल करें. CUSTOMER_SUPPLIED_LOCATION के तौर पर मार्क की गई जगहों की जानकारी, आम तौर पर DeliveryVehicle के last_location.supplemental_location_sensor के ज़रिए दी जाती है.
FLEET_ENGINE_LOCATION किसी जगह का हिसाब, फ़्लीट इंजन देता है. यह काम, वहां मौजूद सिग्नल के आधार पर किया जाता है. सिर्फ़ आउटपुट के लिए. अनुरोध में यह वैल्यू मिलने पर, इसे अस्वीकार कर दिया जाएगा.
FUSED_LOCATION_PROVIDER Android की, इंटिग्रेट की गई जगह की जानकारी देने वाली कंपनी.
CORE_LOCATION Apple ऑपरेटिंग सिस्टम पर जगह की जानकारी देने वाली कंपनी.

DeliveryVehicleNavigationStatus

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

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

GetDeliveryVehicleRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

name

string

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

GetTaskRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

name

string

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

GetTaskTrackingInfoRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

name

string

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

ListDeliveryVehiclesRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

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

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

parent

string

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

page_size

int32

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

page_token

string

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

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

filter

string

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

ListTasksResponse

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

फ़ील्ड
tasks[]

Task

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

next_page_token

string

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

total_size

int64

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

LocationInfo

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

फ़ील्ड
point

LatLng

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

टास्क

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

ध्यान दें: 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 मौजूद न होने पर, यह वैल्यू 'गलत' होती है. इस वैल्यू का हिसाब, 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 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

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

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

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

duration_until_estimated_arrival_time_threshold

Duration

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

remaining_driving_distance_meters_threshold

int32

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

always

bool

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

never

bool

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

TimeWindow

कोई समयसीमा.

फ़ील्ड
start_time

Timestamp

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

end_time

Timestamp

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

UpdateDeliveryVehicleRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

delivery_vehicle

DeliveryVehicle

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

update_mask

FieldMask

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

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

UpdateTaskRequest

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

फ़ील्ड
header

DeliveryRequestHeader

ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर.

task

Task

ज़रूरी है. अपडेट से जुड़ा टास्क. इन फ़ील्ड का रखरखाव फ़्लीट इंजन करता है. 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 के जवाब में सेट किया जाता है.