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 पाएं.
SearchTasks

rpc SearchTasks(SearchTasksRequest) returns (SearchTasksResponse)

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

DeliveryVehicle

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

  • last_location
  • एट्रिब्यूट

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

CreateTaskRequest

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

फ़ील्ड
header

DeliveryRequestHeader

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

string

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

string

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

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

Task

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

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

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

DeliveryRequestHeader

अनुरोध हेडर में सभी डिलीवरी 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 एपीआई लेवल, जो सिर्फ़ Android SDK टूल पर लागू होता है. फ़ील्ड की वैल्यू का उदाहरण: 23.
trace_id

string

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

प्लैटफ़ॉर्म

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

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

SdkType

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

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

DeliveryVehicle

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

ध्यान दें: gRPC और REST API, फ़ील्ड का नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. उदाहरण के लिए, gRPC एपीआई में 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 (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 के लिए शेष ड्राइविंग दूरी. आम तौर पर, ड्राइवर ऐप्लिकेशन यह फ़ील्ड उपलब्ध कराता है, लेकिन कुछ मामलों में 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 फ़ील्ड खाली है, तो UpdateDeliveryVehicleRequest में Fleet Engine इस फ़ील्ड को अनदेखा कर देता है.
remaining_duration

Duration

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

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

ज़रूरी नहीं. स्टैंडर्ड 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 1 पाबंदी है.
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

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

string

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

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

string

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

ListTasksResponse

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

फ़ील्ड
tasks[]

Task

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

string

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

int64

सभी पेजों पर मौजूद ऐसे टास्क की कुल संख्या जो अनुरोध की शर्त से मेल खाते हैं.

LocationInfo

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

फ़ील्ड
point

LatLng

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

SearchTasksRequest

अब काम नहीं करता: इसके बजाय, GetTaskTrackingInfoRequest समस्या को GetTaskTrackingInfo के लिए जारी करें.

फ़ील्ड
header

DeliveryRequestHeader

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

string

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

string

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

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

int32

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

string

ज़रूरी नहीं. पिछले SearchTasks कॉल से मिला पेज टोकन. बाद वाले पेज को फिर से पाने के लिए आपको यह वैल्यू देनी होगी.

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

SearchTasksResponse

SearchTasks रिस्पॉन्स. इसमें ऐसे Tasks का सेट होता है जो SearchTasksRequest में खोज की शर्तों को पूरा करते हैं.

फ़ील्ड
tasks[]

Task

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

string

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

टास्क

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

ध्यान दें: gRPC और REST API, फ़ील्ड का नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. उदाहरण के लिए, gRPC एपीआई में 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 टाइप के Tasks के लिए, 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 स्ट्रिंग_वैल्यू सेट नहीं है, तो उसे खाली स्ट्रिंग "" के तौर पर सेव किया जाएगा. 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

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

Duration

अगर ETA, <= duration_till_estimated_arual_time_threshold पर जाता है, तो असली उपयोगकर्ताओं को यह डेटा एलिमेंट दिखता है.
remaining_driving_distance_meters_threshold

int32

यह डेटा एलिमेंट असली उपयोगकर्ताओं को तब ही दिखेगा, जब ड्राइविंग की दूरी मीटर से कम हो <= balance_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 या SearchTasks कॉल के जवाब में पॉप्युलेट नहीं होगा.
tasks[]

TaskInfo

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

State

VehicleStop की स्थिति. यह फ़ील्ड GetTask या SearchTasks कॉल के जवाब में पॉप्युलेट नहीं होगा.

स्थिति

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

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

TaskInfo

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

फ़ील्ड
task_id

string

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

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

Duration

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

TimeWindow

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