इंडेक्स
DeliveryService
(इंटरफ़ेस)BatchCreateTasksRequest
(मैसेज)BatchCreateTasksResponse
(मैसेज)CreateDeliveryVehicleRequest
(मैसेज)CreateTaskRequest
(मैसेज)DeliveryRequestHeader
(मैसेज)DeliveryRequestHeader.Platform
(enum)DeliveryRequestHeader.SdkType
(enum)DeliveryVehicle
(मैसेज)DeliveryVehicle.DeliveryVehicleType
(enum)DeliveryVehicleAttribute
(मैसेज)DeliveryVehicleLocation
(मैसेज)DeliveryVehicleLocationSensor
(enum)DeliveryVehicleNavigationStatus
(enum)GetDeliveryVehicleRequest
(मैसेज)GetTaskRequest
(मैसेज)GetTaskTrackingInfoRequest
(मैसेज)ListDeliveryVehiclesRequest
(मैसेज)ListDeliveryVehiclesResponse
(मैसेज)ListTasksRequest
(मैसेज)ListTasksResponse
(मैसेज)LocationInfo
(मैसेज)Task
(मैसेज)Task.JourneySharingInfo
(मैसेज)Task.State
(enum)Task.TaskOutcome
(enum)Task.TaskOutcomeLocationSource
(enum)Task.Type
(enum)TaskAttribute
(मैसेज)TaskTrackingInfo
(मैसेज)TaskTrackingViewConfig
(मैसेज)TaskTrackingViewConfig.VisibilityOption
(मैसेज)TimeWindow
(मैसेज)UpdateDeliveryVehicleRequest
(मैसेज)UpdateTaskRequest
(मैसेज)VehicleJourneySegment
(मैसेज)VehicleStop
(मैसेज)VehicleStop.State
(enum)VehicleStop.TaskInfo
(मैसेज)
DeliveryService
लास्ट माइल डिलीवरी सेवा.
BatchCreateTasks |
---|
नए |
CreateDeliveryVehicle |
---|
नया |
CreateTask |
---|
नया |
GetDeliveryVehicle |
---|
बताया गया |
GetTask |
---|
|
GetTaskTrackingInfo |
---|
बताया गया |
ListDeliveryVehicles |
---|
फ़िल्टर करने की तय की गई शर्तों को पूरा करने वाले सभी |
ListTasks |
---|
फ़िल्टर करने की तय की गई शर्तों को पूरा करने वाले सभी |
UpdateDeliveryVehicle |
---|
अपडेट किया गया |
UpdateTask |
---|
|
BatchCreateTasksRequest
BatchCreateTask
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. ध्यान दें: अगर आपने यह फ़ील्ड सेट किया है, तो |
parent |
ज़रूरी है. सभी टास्क के लिए शेयर किया जाने वाला पैरंट रिसॉर्स. यह वैल्यू, |
requests[] |
ज़रूरी है. अनुरोध वाला वह मैसेज जिसमें बनाने के लिए संसाधनों के बारे में बताया गया है. ध्यान दें: एक बैच में ज़्यादा से ज़्यादा 500 टास्क बनाए जा सकते हैं. |
BatchCreateTasksResponse
BatchCreateTask
का जवाब.
फ़ील्ड | |
---|---|
tasks[] |
बनाए गए टास्क. |
CreateDeliveryVehicleRequest
CreateDeliveryVehicle
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
parent |
ज़रूरी है. |
delivery_vehicle_id |
ज़रूरी है. डिलीवरी करने वाले वाहन का आईडी यूनीक होना चाहिए. साथ ही, इस पर नीचे दी गई पाबंदियां लागू होनी चाहिए:
|
delivery_vehicle |
ज़रूरी है.
ध्यान दें: DeliveryVehicle के |
CreateTaskRequest
CreateTask
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
parent |
ज़रूरी है. |
task_id |
ज़रूरी है. टास्क आईडी यूनीक होना चाहिए, लेकिन यह शिपमेंट ट्रैकिंग आईडी नहीं होना चाहिए. किसी शिपमेंट ट्रैकिंग आईडी को सेव करने के लिए,
|
task |
ज़रूरी है. बनाई जाने वाली टास्क इकाई. टास्क बनाते समय, इन फ़ील्ड में जानकारी डालना ज़रूरी है:
ध्यान दें: टास्क के |
DeliveryRequestHeader
अनुरोध हेडर में सभी डिलीवरी RPC अनुरोधों के लिए सामान्य फ़ील्ड होते हैं.
फ़ील्ड | |
---|---|
language_code |
BCP-47 भाषा कोड, जैसे कि en-US या sr-Latn. ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier देखें. अगर कोई तय नहीं किया गया है, तो जवाब किसी भी भाषा में हो सकता है. साथ ही, अगर नाम मौजूद हो, तो अंग्रेज़ी को प्राथमिकता दी जा सकती है. फ़ील्ड की वैल्यू का उदाहरण: |
region_code |
ज़रूरी है. अनुरोध किए जाने वाले इलाके का CLDR इलाके का कोड. फ़ील्ड की वैल्यू का उदाहरण: |
sdk_version |
कॉल करने के लिए इस्तेमाल किए जाने वाले SDK टूल का वर्शन, अगर लागू हो. वर्शन का फ़ॉर्मैट "major.minor.patch" है, जैसे: |
os_version |
उस ऑपरेटिंग सिस्टम का वर्शन जिस पर कॉल करने के लिए इस्तेमाल किया जाने वाला SDK टूल चल रहा है. फ़ील्ड वैल्यू के उदाहरण: |
device_model |
उस डिवाइस का मॉडल जिस पर SDK टूल चल रहा है. फ़ील्ड वैल्यू के उदाहरण: |
sdk_type |
अनुरोध भेजने वाले SDK टूल का टाइप. |
maps_sdk_version |
लागू होने पर, MapSDK का वह वर्शन जिस पर कॉल करने वाले SDK टूल का इस्तेमाल किया जाता है. वर्शन का फ़ॉर्मैट "major.minor.patch" है, जैसे: |
nav_sdk_version |
अगर लागू हो, तो NavSDK का वह वर्शन जिस पर कॉल करने के SDK टूल का इस्तेमाल किया जाता है. वर्शन का फ़ॉर्मैट "major.minor.patch" है, जैसे: |
platform |
कॉल करने वाले SDK टूल का प्लैटफ़ॉर्म. |
manufacturer |
कॉलिंग SDK टूल से Android डिवाइस बनाने वाली कंपनी, जो सिर्फ़ Android SDK टूल पर लागू होती है. फ़ील्ड की वैल्यू का उदाहरण: |
android_api_level |
कॉल करने के लिए इस्तेमाल किए जाने वाले SDK टूल का Android एपीआई लेवल, जो सिर्फ़ Android SDK टूल पर लागू होता है. फ़ील्ड की वैल्यू का उदाहरण: |
trace_id |
वैकल्पिक आईडी, जो अनुरोध की पहचान करने के लिए डेटा लॉग करने के लिए दिया जा सकता है. |
प्लैटफ़ॉर्म
कॉल करने वाले 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 |
डिलीवरी की इस गाड़ी का खास नाम. फ़ॉर्मैट |
last_location |
डिलीवरी गाड़ी की आखिरी जगह की जानकारी. |
navigation_status |
डिलीवरी करने वाले वाहन के नेविगेशन की स्थिति. |
current_route_segment |
कोड में बदली गई पॉलीलाइन उस रास्ते के बारे में बताती है जिसे नेविगेशन में अगले वेपॉइंट पर ले जाने का सुझाव दिया गया है. स्टॉप के पहुंचने या पास होने पर, और नेविगेशन के रास्ते में बदलाव होने पर, ड्राइवर ऐप्लिकेशन इसे अपडेट कर देता है. वाहन को असाइन किए गए सभी चालू टास्क के लिए, ये कुछ ऐसे मामले हैं जिनमें शायद इस फ़ील्ड का इस्तेमाल,
ऐसे मामलों में, Fleet Engine इस फ़ील्ड में, हाल ही में पास हुए VehicleStop से आने वाले VehicleStop के रास्ते को भर देता है. इससे यह पक्का किया जाता है कि इस फ़ील्ड के उपभोक्ता को डिलीवरी वाहन के मौजूदा पाथ के बारे में सबसे सही जानकारी मिले. |
current_route_segment_end_point |
वह जगह जहां अगर |
remaining_distance_meters |
अगर |
remaining_duration |
अगर |
remaining_vehicle_journey_segments[] |
डिलीवरी की सुविधा देने वाले इस वाहन को असाइन किए गए यात्रा के सेगमेंट, जो वाहन की सबसे हाल ही की जगह से शुरू होते हैं. |
attributes[] |
पसंद के मुताबिक डिलीवर किए जाने वाले वाहन के एट्रिब्यूट की सूची. डिलीवरी की सुविधा देने वाले किसी वाहन में ज़्यादा से ज़्यादा 100 एट्रिब्यूट हो सकते हैं. साथ ही, हर एट्रिब्यूट की एक अलग कुंजी होनी चाहिए. |
type |
डिलीवरी करने वाले इस वाहन का टाइप. अगर इसे सेट नहीं किया जाता है, तो यह डिफ़ॉल्ट रूप से |
DeliveryVehicleType
डिलीवरी की सुविधा देने वाले वाहन का टाइप.
Enums | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
मान का इस्तेमाल नहीं किया गया है. |
AUTO |
एक ऑटोमोबाइल. |
TWO_WHEELER |
मोटरसाइकल, मोपेड या दोपहिया वाहन |
BICYCLE |
इंसानों से चलने वाला परिवहन. |
PEDESTRIAN |
एक ह्यूमन ट्रांसपोर्टर, जो आम तौर पर पैदल चलता या दौड़ता है और पैदल चलने के रास्तों पर चलता है. |
DeliveryVehicleAttribute
इसमें वाहन एट्रिब्यूट को की-वैल्यू पेयर के तौर पर बताया गया है. "key:value" स्ट्रिंग में 256 से ज़्यादा वर्ण नहीं हो सकते.
फ़ील्ड | |
---|---|
key |
एट्रिब्यूट की कुंजी. |
value |
एट्रिब्यूट की वैल्यू. |
यूनियन फ़ील्ड delivery_vehicle_attribute_value . एट्रिब्यूट की वैल्यू, स्ट्रिंग, बूल या डबल टाइप में हो सकती है. delivery_vehicle_attribute_value इनमें से सिर्फ़ एक हो सकती है: |
|
string_value |
स्ट्रिंग टाइप की गई विशेषता मान. ध्यान दें: यह |
bool_value |
बूलियन टाइप किया गया विशेषता मान. |
number_value |
दो बार टाइप की गई विशेषता मान. |
DeliveryVehicleLocation
किसी समय पर वाहन की जगह, स्पीड, और हेडिंग.
फ़ील्ड | |
---|---|
location |
वाहन की जगह. जब वाहन को Fleet Engine को भेजा जाता है, तब उसकी जगह की जानकारी जीपीएस से मिलती है. जवाब के जवाब में, वाहन की जगह की जानकारी, जीपीएस से मिली जगह की जानकारी, पूरक जगह या कोई दूसरी अनुमानित जगह हो सकती है. सोर्स की जानकारी |
horizontal_accuracy |
अब काम नहीं करता: इसके बजाय |
latlng_accuracy |
दायरे के रूप में |
heading |
जिस दिशा में वाहन चल रहा है वह डिग्री में है. 0 से उत्तर दिशा का पता चलता है. मान्य रेंज [0,360) है. |
bearing_accuracy |
अब काम नहीं करता: इसके बजाय |
heading_accuracy |
डिग्री में |
altitude |
WGS84 से ऊपर मीटर में ऊंचाई. |
vertical_accuracy |
अब काम नहीं करता: इसके बजाय |
altitude_accuracy |
मीटर में |
speed_kmph |
किलोमीटर प्रति घंटे में वाहन की रफ़्तार. अब काम नहीं करता: इसके बजाय |
speed |
मीटर/सेकंड में वाहन की रफ़्तार |
speed_accuracy |
मीटर/सेकंड में |
update_time |
सेंसर की घड़ी के मुताबिक, सेंसर से |
server_time |
सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को जगह की जानकारी मिली. |
location_sensor |
जगह की जानकारी का डेटा देने वाली कंपनी (उदाहरण के लिए, |
is_road_snapped |
|
is_gps_sensor_enabled |
सिर्फ़ इनपुट. यह बताता है कि मोबाइल डिवाइस पर जीपीएस सेंसर चालू है या नहीं. |
time_since_update |
सिर्फ़ इनपुट. इस जगह को पहली बार सर्वर पर भेजे जाने के बाद से समय (सेकंड में). पहले अपडेट के लिए, यह संख्या शून्य होगी. अगर समय की जानकारी नहीं है (उदाहरण के लिए, ऐप्लिकेशन के रीस्टार्ट होने पर), तो यह वैल्यू शून्य पर रीसेट हो जाती है. |
num_stale_updates |
सिर्फ़ इनपुट. अब काम नहीं करता: अब अन्य सिग्नल का इस्तेमाल, यह पता लगाने के लिए किया जाता है कि कोई जगह पुरानी है या नहीं. |
raw_location |
वाहन की रॉ जगह की जानकारी (रोड-स्नैपर से प्रोसेस नहीं की गई). |
raw_location_time |
रॉ जगह की जानकारी देने वाला टाइमस्टैंप. |
raw_location_sensor |
रॉ लोकेशन का सोर्स. डिफ़ॉल्ट वैल्यू |
raw_location_accuracy |
मीटर में, दायरे के रूप में |
supplemental_location |
इंटिग्रेशन वाले ऐप्लिकेशन से मिली दूसरी जगह की जानकारी. |
supplemental_location_time |
पूरक जगह से जुड़ा टाइमस्टैंप. |
supplemental_location_sensor |
पूरक जगह का सोर्स. डिफ़ॉल्ट वैल्यू |
supplemental_location_accuracy |
मीटर में, दायरे के रूप में |
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 के ऑपरेटिंग सिस्टम पर जगह की जानकारी देने वाली कंपनी. |
GetDeliveryVehicleRequest
GetDeliveryVehicle
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
name |
ज़रूरी है. |
GetTaskRequest
GetTask
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
name |
ज़रूरी है. |
GetTaskTrackingInfoRequest
GetTaskTrackingInfoRequest
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
name |
ज़रूरी है. |
ListDeliveryVehiclesRequest
ListDeliveryVehicles
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
parent |
ज़रूरी है. |
page_size |
ज़रूरी नहीं. लौटाए जाने वाले वाहनों की ज़्यादा से ज़्यादा संख्या. सेवा इस संख्या से कम जवाब दे सकती है. अगर यह संख्या नहीं दी जाती है, तो सर्वर तय करता है कि कितने नतीजे देखने हैं. |
page_token |
ज़रूरी नहीं. पिछले पेज पर नंबर जोड़ते समय, |
filter |
ज़रूरी नहीं. डिलीवरी में इस्तेमाल होने वाले वाहनों की लिस्टिंग करते समय लागू की जाने वाली फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरण देखने के लिए, http://aip.dev/160 पर जाएं. अगर आपने कोई वैल्यू नहीं दी है या फ़िल्टर के लिए कोई खाली स्ट्रिंग चुनी है, तो डिलीवरी करने वाले सभी वाहन दिखाए जाएंगे. ध्यान दें कि फ़िल्टर क्वेरी में ज़्यादा से ज़्यादा 50 पाबंदियां हो सकती हैं. पाबंदी, |
viewport |
ज़रूरी नहीं. यह फ़िल्टर उन वाहनों को सीमित करता है जिनकी आखिरी जगह, व्यूपोर्ट के तय किए गए आयताकार इलाके में थी. |
ListDeliveryVehiclesResponse
ListDeliveryVehicles
का जवाब.
फ़ील्ड | |
---|---|
delivery_vehicles[] |
डिलीवरी की सुविधा देने वाले ऐसे वाहनों का सेट जो अनुरोध किए गए फ़िल्टर करने की ज़रूरी शर्तों को पूरा करते हैं. अगर कोई फ़िल्टर सेट नहीं किया गया है, तो अनुरोध करने पर डिलीवरी की सभी गाड़ियों को दिखाया जाता है. सही जवाब वाले फ़ील्ड को भी खाली छोड़ा जा सकता है. अगर कोई जवाब नहीं दिया गया है, तो इसका मतलब है कि डिलीवरी करने वाला कोई भी वाहन, अनुरोध किए गए फ़िल्टर की ज़रूरी शर्तों को पूरा नहीं करता. |
next_page_token |
नतीजों की सूची जारी रखने के लिए, इस टोकन को |
total_size |
सभी पेजों पर, डिलीवरी के उन वाहनों की कुल संख्या जो अनुरोध की शर्तों के मुताबिक हैं. |
ListTasksRequest
ListTasks
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
parent |
ज़रूरी है. |
page_size |
ज़रूरी नहीं. लौटाए जाने वाले Tasks की ज़्यादा से ज़्यादा संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. अगर यह वैल्यू नहीं दी जाती है, तो सर्वर यह तय करता है कि कितने नतीजे देखने हैं. |
page_token |
ज़रूरी नहीं. पिछले पेज पर नंबर जोड़ते समय, |
filter |
ज़रूरी नहीं. Tasks को सूची में जोड़ते समय लागू की जाने वाली फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरण देखने के लिए, http://aip.dev/160 पर जाएं. अगर कोई वैल्यू नहीं दी जाती है या खाली स्ट्रिंग पर फ़िल्टर लगाया जाता है, तो सभी Tasks दिखते हैं. जिन टास्क प्रॉपर्टी पर फ़िल्टर लगाया जा सकता है उनके बारे में जानकारी पाने के लिए, टास्क की सूची बनाएं लेख पढ़ें. |
ListTasksResponse
ListTasks
रिस्पॉन्स, जिसमें ऐसे Tasks का सेट शामिल है जो ListTasksRequest
में फ़िल्टर की शर्तों को पूरा करते हैं.
फ़ील्ड | |
---|---|
tasks[] |
टास्क का वह सेट जो अनुरोध किए गए फ़िल्टर करने की शर्तों को पूरा करता है. अगर कोई फ़िल्टर सेट नहीं किया गया है, तो अनुरोध करने पर सभी टास्क दिखते हैं. सही जवाब वाले फ़ील्ड को भी खाली छोड़ा जा सकता है. खाली जवाब का मतलब है कि अनुरोध किए गए फ़िल्टर की शर्तों को पूरा करने वाला कोई भी Tasks नहीं मिला. |
next_page_token |
नतीजों की सूची जारी रखने के लिए, इस टोकन को |
total_size |
सभी पेजों पर मौजूद ऐसे टास्क की कुल संख्या जो अनुरोध की शर्त से मेल खाते हैं. |
LocationInfo
ऐसी जगह जहां कोई अतिरिक्त आइडेंटिफ़ायर मौजूद होता है.
फ़ील्ड | |
---|---|
point |
जगह के निर्देशांक. |
टास्क
Delivery API में मौजूद टास्क से, सिर्फ़ एक कार्रवाई को ट्रैक किया जाता है. आम तौर पर, शिपमेंट से जुड़े Tasks और ब्रेक Tasks में अंतर होता है. किसी शिपमेंट में उससे जुड़े एक से ज़्यादा Tasks हो सकते हैं. उदाहरण के लिए, हो सकता है कि पिकअप के लिए एक टास्क और ड्रॉप-ऑफ़ या ट्रांसफ़र के लिए एक टास्क हो. साथ ही, किसी शिपमेंट को अलग-अलग गाड़ियों से मैनेज किया जा सकता है. उदाहरण के लिए, एक वाहन पिकअप को हैंडल कर सकता है और शिपमेंट को हब तक ले जा सकता है. वहीं, दूसरा वाहन उसी शिपमेंट को हब से वहां ले जाता है जहां से उसे ड्रॉप-ऑफ़ किया जाता है.
ध्यान दें: gRPC और REST API, फ़ील्ड का नाम रखने के अलग-अलग तरीकों का इस्तेमाल करते हैं. उदाहरण के लिए, gRPC एपीआई में Task.journey_sharing_info
फ़ील्ड और REST API में Task.journeySharingInfo
फ़ील्ड, एक ही फ़ील्ड को रेफ़र करते हैं.
फ़ील्ड | |
---|---|
name |
|
type |
ज़रूरी है. इम्यूटेबल. यह बताता है कि टास्क किस तरह का है. उदाहरण के लिए, ब्रेक या शिपमेंट. |
state |
ज़रूरी है. टास्क के चलने की मौजूदा स्थिति. |
task_outcome |
टास्क का नतीजा. |
task_outcome_time |
वह टाइमस्टैंप जिससे पता चलता है कि सेवा देने वाली कंपनी ने |
task_outcome_location |
वह जगह जहां |
task_outcome_location_source |
यह बताता है कि |
tracking_id |
इम्यूटेबल. यह फ़ील्ड, आईडी को सेव करने में मदद करता है, ताकि आप मुश्किल मैपिंग का इस्तेमाल करने से बच सकें.
|
delivery_vehicle_id |
सिर्फ़ आउटपुट के लिए. उस वाहन का आईडी जिससे टास्क को पूरा किया जा रहा है. डिलीवरी वाले वाहन के आईडी पर ये पाबंदियां लागू होती हैं:
|
planned_location |
इम्यूटेबल. वह जगह जहां टास्क पूरा किया जाएगा. |
task_duration |
ज़रूरी है. इम्यूटेबल. इस जगह पर कोई टास्क चलाने में लगने वाला समय. |
target_time_window |
वह समय विंडो जिसके दौरान टास्क पूरा होना चाहिए. |
journey_sharing_info |
सिर्फ़ आउटपुट के लिए. गतिविधि की जानकारी शेयर करने से जुड़े खास फ़ील्ड. स्थिति |
task_tracking_view_config |
टास्क ट्रैकिंग का कॉन्फ़िगरेशन यह बताता है कि असली उपयोगकर्ताओं को कौनसे डेटा एलिमेंट किन स्थितियों में दिखते हैं. |
attributes[] |
कस्टम टास्क एट्रिब्यूट की सूची. हर एट्रिब्यूट के लिए एक खास कुंजी होनी चाहिए. |
JourneySharingInfo
खास फ़ील्ड शेयर करने का सफ़र.
फ़ील्ड | |
---|---|
remaining_vehicle_journey_segments[] |
उन स्टॉप की जानकारी ट्रैक करना जिन्हें असाइन किया गया वाहन, टास्क पूरा करने से पहले बनाएगा. ध्यान दें कि इस सूची में, दूसरे टास्क के स्टॉप शामिल हो सकते हैं. पहले सेगमेंट, |
last_location |
इससे, यह पता चलता है कि असाइन किया गया वाहन पिछली बार किस जगह पर मौजूद था. |
last_location_snappable |
यह बताता है कि वाहन की आखिरी जगह को |
स्थिति
टास्क की स्थिति. यह 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 |
एट्रिब्यूट की कुंजी. कुंजियों में कोलन वर्ण (:) नहीं होना चाहिए. |
यूनियन फ़ील्ड task_attribute_value . एट्रिब्यूट की वैल्यू, स्ट्रिंग, बूल या डबल टाइप में हो सकती है. अगर कोई भी TaskAttribute स्ट्रिंग_वैल्यू सेट नहीं है, तो उसे खाली स्ट्रिंग "" के तौर पर सेव किया जाएगा. task_attribute_value इनमें से सिर्फ़ एक हो सकता है: |
|
string_value |
स्ट्रिंग टाइप की गई विशेषता मान. |
bool_value |
बूलियन टाइप किया गया विशेषता मान. |
number_value |
दो बार टाइप की गई विशेषता मान. |
TaskTrackingInfo
TaskTrackingInfo
मैसेज. मैसेज में टास्क को ट्रैक करने की जानकारी होती है. इसे दिखाने के लिए इस्तेमाल किया जाता है. अगर कोई ट्रैकिंग आईडी कई टास्क से जुड़ा है, तो Fleet Engine अनुमानित आधार का इस्तेमाल करके यह तय करता है कि किस टास्क के TaskTrackingInfo को चुनना है.
फ़ील्ड | |
---|---|
name |
यह |
tracking_id |
इम्यूटेबल. किसी टास्क का ट्रैकिंग आईडी. * एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए. * इसमें 64 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते. * यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया. * ऐसा हो सकता है कि इनमें से कोई भी ASCII वर्ण न हो: '/', ':', '?', ',' या '#'. |
vehicle_location |
वाहन की पिछली जगह की जानकारी. |
route_polyline_points[] |
पॉइंट की ऐसी सूची जो टास्क के कनेक्ट होने पर वाहन के उस रास्ते की पॉलीलाइन बनाती है जहां से टास्क के लिए जगह तक पहुंचा जा सकता है. |
remaining_stop_count |
टास्क के स्टॉप तक पहुंचने से पहले वाहन के बचे हुए स्टॉप की संख्या के बारे में बताता है. इसमें टास्क स्टॉप भी शामिल है. उदाहरण के लिए, अगर वाहन का अगला स्टॉप टास्क स्टॉप है, तो वैल्यू 1 होगी. |
remaining_driving_distance_meters |
रुचि की |
estimated_arrival_time |
वह टाइमस्टैंप, जो स्टॉप की जगह पर पहुंचने के अनुमानित समय के बारे में बताता है. |
estimated_task_completion_time |
वह टाइमस्टैंप जिससे किसी टास्क को पूरा होने में लगने वाले अनुमानित समय के बारे में पता चलता है. |
state |
टास्क के चलने की मौजूदा स्थिति. |
task_outcome |
किसी टास्क को लागू करने की कोशिश का नतीजा. |
task_outcome_time |
वह टाइमस्टैंप जिससे पता चलता है कि सेवा देने वाली कंपनी ने टास्क के नतीजे कब सेट किए हैं. |
planned_location |
इम्यूटेबल. वह जगह जहां टास्क पूरा किया जाएगा. |
target_time_window |
वह समय विंडो जिसके दौरान टास्क पूरा होना चाहिए. |
attributes[] |
टास्क पर सेट किए गए कस्टम एट्रिब्यूट. |
TaskTrackingViewConfig
कॉन्फ़िगरेशन मैसेज से पता चलता है कि टास्क का डेटा एलिमेंट, असली उपयोगकर्ताओं को कब दिखना चाहिए.
फ़ील्ड | |
---|---|
route_polyline_points_visibility |
वह फ़ील्ड जिससे पता चलता है कि रास्ते के पॉलीलाइन पॉइंट कब दिख सकते हैं. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
estimated_arrival_time_visibility |
वह फ़ील्ड जो बताता है कि पहुंचने का अनुमानित समय कब दिख सकता है. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
estimated_task_completion_time_visibility |
वह फ़ील्ड जिससे पता चलता है कि टास्क पूरा होने में लगने वाला अनुमानित समय कब दिखेगा. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
remaining_driving_distance_visibility |
वह फ़ील्ड जो बताता है कि ड्राइविंग से जुड़ी बाकी दूरी कब तक देखी जा सकती है. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
remaining_stop_count_visibility |
वह फ़ील्ड जिसके बारे में जानकारी दी जाती है कि स्टॉप की गिनती कब दिखेगी. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
vehicle_location_visibility |
वह फ़ील्ड जिससे पता चलता है कि वाहन की जगह की जानकारी कब दिख सकती है. अगर इस फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो इस डेटा के लिए, प्रोजेक्ट लेवल पर 'किसको दिखे' का डिफ़ॉल्ट कॉन्फ़िगरेशन इस्तेमाल किया जाएगा. |
VisibilityOption
विकल्प मैसेज से तय होता है कि डेटा एलिमेंट, असली उपयोगकर्ताओं को कब दिखना चाहिए.
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड visibility_option . चुना गया 'किसको दिखे' विकल्प. visibility_option इनमें से सिर्फ़ एक हो सकती है: |
|
remaining_stop_count_threshold |
यह डेटा एलिमेंट असली उपयोगकर्ताओं को तब दिखता है, जब बाकी स्टॉप की संख्या <= ढूंढी गई स्टॉप_count_threshold से ज़्यादा हो जाती है. |
duration_until_estimated_arrival_time_threshold |
अगर ETA, <= duration_till_estimated_arual_time_threshold पर जाता है, तो असली उपयोगकर्ताओं को यह डेटा एलिमेंट दिखता है. |
remaining_driving_distance_meters_threshold |
यह डेटा एलिमेंट असली उपयोगकर्ताओं को तब ही दिखेगा, जब ड्राइविंग की दूरी मीटर से कम हो <= balance_driving_distance_meters_threshold. |
always |
अगर 'सही है' पर सेट किया जाता है, तो यह डेटा एलिमेंट असली उपयोगकर्ताओं को हमेशा बिना किसी थ्रेशोल्ड के दिखता है. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता. |
never |
अगर इसे 'सही है' पर सेट किया जाता है, तो यह डेटा एलिमेंट असली उपयोगकर्ताओं के लिए हमेशा छिपा रहता है. साथ ही, इसमें कोई थ्रेशोल्ड नहीं होता. इस फ़ील्ड को 'गलत' पर सेट नहीं किया जा सकता. |
TimeWindow
कोई समयसीमा.
फ़ील्ड | |
---|---|
start_time |
ज़रूरी है. समय विंडो के शुरू होने का समय (शामिल). |
end_time |
ज़रूरी है. समय विंडो के खत्म होने का समय (शामिल). |
UpdateDeliveryVehicleRequest
UpdateDeliveryVehicle
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
delivery_vehicle |
ज़रूरी है. लागू करने के लिए, |
update_mask |
ज़रूरी है. ऐसा फ़ील्ड मास्क जो बताता है कि किन यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा-सेपरेटेड लिस्ट है. उदाहरण: |
UpdateTaskRequest
UpdateTask
का अनुरोध वाला मैसेज.
फ़ील्ड | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड Delivery API अनुरोध हेडर. |
task |
ज़रूरी है. अपडेट से जुड़ा टास्क. इन फ़ील्ड का रखरखाव Fleet Engine करता है.
ध्यान दें: अगर टास्क को किसी डिलीवरी वाहन को असाइन किया गया है, तो |
update_mask |
ज़रूरी है. यह फ़ील्ड मास्क बताता है कि किन टास्क फ़ील्ड को अपडेट करना है. ध्यान दें: यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा-सेपरेटेड लिस्ट है. उदाहरण: |
VehicleJourneySegment
वाहन के यात्रा के सेगमेंट के बारे में बताता है - उसके पिछले स्टॉप से लेकर मौजूदा स्टॉप तक. अगर यह पहला चालू स्टॉप है, तो यह वाहन की मौजूदा जगह से इस स्टॉप के लिए होगा.
फ़ील्ड | |
---|---|
stop |
स्टॉप से जुड़ी |
driving_distance_meters |
सिर्फ़ आउटपुट के लिए. पिछले स्टॉप से इस स्टॉप तक की यात्रा की दूरी. अगर मौजूदा स्टॉप, यात्रा के सेगमेंट की सूची में पहला स्टॉप है, तो शुरुआत की जगह उस वाहन की जगह की जानकारी होगी जब यह स्टॉप सूची में जोड़ा गया था. अगर यात्रा का यह सेगमेंट |
driving_duration |
सिर्फ़ आउटपुट के लिए. पिछले स्टॉप से इस स्टॉप तक यात्रा में लगने वाला समय. अगर मौजूदा स्टॉप, यात्रा के सेगमेंट की सूची में पहला स्टॉप है, तो शुरुआत की जगह उस वाहन की जगह की जानकारी होगी जब यह स्टॉप सूची में जोड़ा गया था. अगर यह फ़ील्ड |
path[] |
सिर्फ़ आउटपुट के लिए. पिछले स्टॉप से इस स्टॉप तक का पथ. अगर यात्रा के सेगमेंट की सूची में मौजूदा स्टॉप, पहला स्टॉप है, तो सूची में जोड़े जाने के समय वाहन की मौजूदा जगह से इस स्टॉप तक का यह पाथ होगा. अगर यात्रा का यह सेगमेंट अगर यह फ़ील्ड |
VehicleStop
उस पॉइंट के बारे में बताता है जहां वाहन एक या उससे ज़्यादा Task
सेकंड के बाद रुक जाता है.
फ़ील्ड | |
---|---|
planned_location |
ज़रूरी है. स्टॉप की जगह. ध्यान दें कि हो सकता है कि |
tasks[] |
इस स्टॉप पर किए जाने वाले |
state |
|
स्थिति
VehicleStop
की मौजूदा स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
अज्ञात. |
NEW |
बनाया गया, लेकिन सक्रिय रूप से रूट नहीं किया जा रहा है. |
ENROUTE |
असाइन किया गया है और सक्रिय रूप से रूटिंग किया जा रहा है. |
ARRIVED |
स्टॉप पर पहुंच गई. यह मानता है कि जब वाहन अगले स्टॉप पर जा रहा है, तो पिछले सभी स्टॉप पूरे हो गए हैं. |
TaskInfo
इस स्टॉप पर किए गए टास्क के बारे में ज़्यादा जानकारी.
फ़ील्ड | |
---|---|
task_id |
टास्क आईडी.
|
task_duration |
सिर्फ़ आउटपुट के लिए. टास्क पूरा करने में लगने वाला समय. |
target_time_window |
सिर्फ़ आउटपुट के लिए. वह समय विंडो जिसके दौरान टास्क पूरा होना चाहिए. इसे सिर्फ़ |