Package maps.fleetengine.delivery.v1

אינדקס

• 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
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 ל-Fleet Engine, ומקצה את Tasks ל-DeliveryVehicle. אי אפשר לעדכן את השם של DeliveryVehicle. אפשר לעדכן את remaining_vehicle_journey_segments, אבל הוא צריך להכיל את כל הפרמטרים VehicleJourneySegment שיישמרו ב-DeliveryVehicle. הערכים מסוג 'task_id' מאוחזרים מתוך remaining_vehicle_journey_segments, והשדות Tasks התואמים מוקצים ל-DeliveryVehicle אם הם עדיין לא הוקצו.

UpdateTask
rpc UpdateTask(UpdateTaskRequest) returns (Task) עדכון הנתונים של Task.

BatchCreateTasksRequest

הודעת הבקשה של BatchCreateTask.

שדות
header	DeliveryRequestHeader זה שינוי אופציונלי. כותרת הבקשה הרגילה של Delivery API. הערה: אם מגדירים את השדה הזה, שדה הכותרת בהודעות CreateTaskRequest חייב להיות ריק או להתאים לשדה הזה.
parent	string חובה. משאב ההורה שמשותף לכל המשימות. הפורמט של הערך הזה חייב להיות providers/{provider}. השדה provider חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project. שדה ההורה בהודעות CreateTaskRequest חייב להיות ריק או להתאים לשדה הזה.
requests[]	CreateTaskRequest חובה. הודעת הבקשה שמציינת את המשאבים שיש ליצור. הערה: אפשר ליצור עד 500 משימות בבת אחת.

BatchCreateTasksResponse

הודעת התשובה BatchCreateTask.

שדות
tasks[]	Task המשימות שנוצרו.

CreateDeliveryVehicleRequest

הודעת הבקשה של CreateDeliveryVehicle.

שדות
header	DeliveryRequestHeader זה שינוי אופציונלי. כותרת הבקשה הרגילה של Delivery API.
parent	string חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project.
delivery_vehicle_id	string חובה. מזהה רכב המסירה חייב להיות ייחודי וכפוף להגבלות הבאות: חייבת להיות מחרוזת Unicode חוקית. מוגבלת לאורך של 64 תווים לכל היותר. מנורמלים בהתאם לטופס הנירמול של Unicode C. לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
delivery_vehicle	DeliveryVehicle חובה. הישות DeliveryVehicle שצריך ליצור. כשיוצרים רכב משלוח חדש, אפשר להגדיר את השדות האופציונליים הבאים: סוג last_location מאפיינים הערה: המערכת מתעלמת מהשדה name של DeliveryVehicle. אין להגדיר את כל השדות האחרים של DeliveryAutomotive; אחרת, תוחזר שגיאה.

CreateTaskRequest

הודעת הבקשה של CreateTask.

שדות
header	DeliveryRequestHeader זה שינוי אופציונלי. כותרת הבקשה הרגילה של Delivery API.
parent	string חובה. חייב להיות בפורמט providers/{provider}. השדה provider חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project.
task_id	string חובה. מזהה המשימה חייב להיות ייחודי, אבל לא מזהה לצורכי מעקב אחר משלוח. כדי לשמור מזהה לצורכי מעקב, צריך להשתמש בשדה tracking_id. הערה: לכמה משימות יכול להיות אותו tracking_id. מזהי המשימות כפופים להגבלות הבאות: חייבת להיות מחרוזת Unicode חוקית. מוגבלת לאורך של 64 תווים לכל היותר. מנורמלים בהתאם לטופס הנירמול של Unicode 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 הגרסה של Nav SDK שבה ערכת ה-SDK לשיחות תלויה, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: 2.1.0.
platform	Platform הפלטפורמה של ה-SDK לשיחות.
manufacturer	string היצרן של מכשיר Android מה-SDK לשיחות, רלוונטי רק לערכות ה-SDK של Android. דוגמה לערך בשדה: Samsung.
android_api_level	int32 רמת ה-API של Android של ה-SDK לשיחות, רלוונטית רק לערכות ה-SDK ל-Android. דוגמה לערך בשדה: 23.
trace_id	string מזהה אופציונלי שאפשר לספק למטרות רישום ביומן לצורך זיהוי הבקשה.

פלטפורמה

הפלטפורמה של ה-SDK לשיחות.

טיפוסים בני מנייה (enum)
PLATFORM_UNSPECIFIED	ערך ברירת המחדל. הערך הזה משמש אם הפלטפורמה לא מוצגת.
ANDROID	הבקשה מגיעה מ-Android.
IOS	הבקשה מגיעה מ-iOS.
WEB	הבקשה מגיעה מהאינטרנט.

SdkType

סוגים אפשריים של SDK.

טיפוסים בני מנייה (enum)
SDK_TYPE_UNSPECIFIED	ערך ברירת המחדל. המערכת תשתמש בערך הזה אם לא מציינים את sdk_type.
CONSUMER	ה-SDK של הקריאה הוא צרכן.
DRIVER	ה-SDK לשיחות הוא של מנהל התקן.
JAVASCRIPT	ה-SDK ששולח הוא JavaScript.

DeliveryVehicle

ההודעה DeliveryVehicle. רכב משלוחים מוביל משלוחים מנקודת איסוף ליעד משלוחים, ומנקודת איסוף אל תחנת המשלוחים. במקרים מסוימים, רכבי משלוחים מעבירים משלוחים גם ישירות מנקודת האיסוף אל יעד המשלוח.

הערה: ממשקי API ל-gRPC ול-REST משתמשים במוסכמות שונות של מתן שמות לשדות. לדוגמה, השדה DeliveryVehicle.current_route_segment ב-API ל-gRPC והשדה DeliveryVehicle.currentRouteSegment ב-API ל-REST מפנים לאותו שדה.

שדות
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 מאכלסת את השדה הזה במסלול מהרכב האחרון שהועבר אל קרון הרכב הבא כדי להבטיח שלצרכן בשדה הזה יש את המידע שזמין בצורה הטובה ביותר לגבי הנתיב הנוכחי של רכב המסירה.
current_route_segment_end_point	LatLng המיקום שבו current_route_segment מסתיים. השדה הזה לא מאוכלס כרגע באפליקציית הנהג, אבל אפשר לספק אותו בשיחות של UpdateDeliveryVehicle. הכתובת היא LatLng מהתחנה הקרובה או הLatLng האחרונה של current_route_segment. לאחר מכן, Fleet Engine יעשה כמיטב יכולתו כדי לבצע אינטרפולציה לVehicleStop בפועל. המערכת תתעלם משדה זה בקריאות UpdateDeliveryVehicle אם השדה current_route_segment ריק.
remaining_distance_meters	Int32Value מרחק הנסיעה שנותר עבור current_route_segment. בדרך כלל, אפליקציית Driver מספקת את השדה הזה, אבל יש מקרים שבהם Fleet Engine יבטל את הערך שנשלח על ידי האפליקציה. מידע נוסף זמין כאן: DeliveryVehicle.current_route_segment. השדה הזה מוחזר ב-Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) או ב-Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) לכל נכסי Task הפעילים שהוקצו לרכב המסירה. Fleet Engine מתעלם מהשדה הזה ב-UpdateDeliveryVehicleRequest אם השדה current_route_segment ריק.
remaining_duration	Duration זמן הנסיעה שנותר ל-current_route_segment. בדרך כלל, אפליקציית Driver מספקת את השדה הזה, אבל יש מקרים שבהם Fleet Engine יבטל את הערך שנשלח על ידי האפליקציה. מידע נוסף זמין כאן: DeliveryVehicle.current_route_segment. השדה הזה מוחזר ב-Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) או ב-Task.remainingVehicleJourneySegments[0].drivingDuration (REST) עבור כל המשימות הפעילות שהוקצו לרכב המסירה. Fleet Engine מתעלם מהשדה הזה ב-UpdateDeliveryVehicleRequest אם השדה current_route_segment ריק.
remaining_vehicle_journey_segments[]	VehicleJourneySegment קטעי הנסיעה שהוקצו לרכב המשלוחים הזה, החל מהמיקום האחרון שדווח לגבי הרכב. השדה הזה לא יאוכלס בתשובה של ListDeliveryVehicles.
attributes[]	DeliveryVehicleAttribute רשימה של מאפיינים מותאמים אישית לרכבי הובלה. רכב הובלה יכול לכלול עד 100 מאפיינים, ולכל מאפיין צריך להיות מפתח ייחודי.
type	DeliveryVehicleType הסוג של רכב המשלוחים הזה. אם המדיניות לא מוגדרת, ברירת המחדל תהיה AUTO.

DeliveryVehicleType

סוג רכב המשלוחים.

טיפוסים בני מנייה (enum)
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, מיקום הרכב הוא מיקום לפי GPS. כשאתם מקבלים אותו בתגובה, מיקום הרכב יכול להיות מיקום GPS, מיקום משלים או מיקום משוער אחר. המקור מצוין ב-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 קלט בלבד. מציינת אם חיישן ה-GPS מופעל במכשיר הנייד.
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

החיישן או המתודולוגיה ששימשו לקביעת המיקום.

טיפוסים בני מנייה (enum)
UNKNOWN_SENSOR	החיישן לא מוגדר או לא ידוע.
GPS	GPS או Assist GPS.
NETWORK	תמיכה ב-GPS, מזהה של מגדל תקשורת או נקודת גישה ל-Wi-Fi.
PASSIVE	מזהה מגדל סלולרי או נקודת גישה ל-Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER	מיקום שנקבע על ידי המכשיר הנייד הוא המיקום הטוב ביותר בכביש.
CUSTOMER_SUPPLIED_LOCATION	מיקום שמסופק על ידי הלקוח ממקור בלתי תלוי. בדרך כלל, הערך הזה משמש למיקום שסופק ממקורות שאינם המכשיר הנייד שבו פועל Driver SDK. אם המקור המקורי מתואר על ידי אחד מערכי ה-enum האחרים, משתמשים בערך הזה. מיקומים שמסומנים כ-CUSTOMER_SUPPLIED_LOCATION מסופקים בדרך כלל באמצעות last_location.supplemental_location_sensor של DeliveryVehicle.
FLEET_ENGINE_LOCATION	המיקום מחושב על ידי Fleet Engine על סמך האותות שזמינים לו. פלט בלבד. הערך הזה יידחה אם הוא יתקבל בבקשה.
FUSED_LOCATION_PROVIDER	ספק המיקום המשולב של Android.
CORE_LOCATION	ספק המיקום במערכות ההפעלה של Apple.

DeliveryVehicleNavigationStatus

סטטוס הניווט של הרכב.

טיפוסים בני מנייה (enum)
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 היא הגבלה אחת.
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 תוכלו לראות דוגמאות לתחביר של מסננים. אם לא תציינו ערך, או אם בחרתם לסנן לפי מחרוזת ריקה, כל המשימות יוחזרו. מידע נוסף על המאפיינים של משימות שאפשר לסנן לפיהם מופיע במאמר הצגת רשימת המשימות.

ListTasksResponse

התשובה ListTasks שמכילה את קבוצת המשימות שעומדות בקריטריוני הסינון של ListTasksRequest.

שדות
tasks[]	Task קבוצת המשימות שעומדות בקריטריונים לסינון הנדרשים. אם לא מוגדר מסנן, הבקשה מחזירה את כל המשימות. תגובה מוצלחת יכולה גם להיות ריקה. תגובה ריקה מציינת שלא נמצאו משימות שתואמות לקריטריוני הסינון המבוקשים.
next_page_token	string צריך להעביר את האסימון הזה ב-ListTasksRequest כדי להמשיך להצגת התוצאות. אם כל התוצאות הוחזרו, השדה הזה הוא מחרוזת ריקה או שהוא לא מופיע בתשובה.
total_size	int64 המספר הכולל של משימות שתואמות לקריטריוני הבקשה, בכל הדפים.

LocationInfo

מיקום עם מזהים נוספים.

שדות
point	LatLng הקואורדינטות של המיקום.

משימה

משימה ב-Delivery API מייצגת פעולה יחידה למעקב. באופן כללי, יש הבחנה בין Tasks שקשורות למשלוחים לבין משימות 'הפסקות'. לכל משלוח אפשר לשייך אליו כמה משימות. לדוגמה, יכולה להיות משימה אחת לאיסוף ומשימה אחת לאיסוף או להעברה. בנוסף, כלי רכב שונים יכולים לטפל במשימות שונות לכל משלוח. לדוגמה, רכב אחד יכול לטפל באיסוף עצמי ולהביא את המשלוח למרכז, ורכב אחר מנהל את אותו משלוח מהמרכז אל נקודת ההורדה.

הערה: ממשקי API ל-gRPC ול-REST משתמשים במוסכמות שונות של מתן שמות לשדות. לדוגמה, השדה Task.journey_sharing_info ב-API ל-gRPC והשדה Task.journeySharingInfo ב-API ל-REST מפנים לאותו שדה.

שדות
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 בלתי ניתן לשינוי. השדה הזה מאפשר לשמור את המזהה וכך להימנע משימוש במיפוי מורכב. לא ניתן להגדיר את tracking_id ל-Tasks מסוג UNAVAILABLE ו-SCHEDULED_STOP. על המזהים האלה חלות ההגבלות הבאות: חייבת להיות מחרוזת Unicode חוקית. מוגבלת לאורך של 64 תווים לכל היותר. מנורמלים בהתאם לטופס הנירמול של Unicode C. לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
delivery_vehicle_id	string פלט בלבד. המזהה של הרכב שמבצע את המשימה הזו. מזהי רכבים להעברה כפופים להגבלות הבאות: חייבת להיות מחרוזת Unicode חוקית. מוגבלת לאורך של 64 תווים לכל היותר. מנורמלים בהתאם לטופס הנירמול של Unicode C. לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
planned_location	LocationInfo בלתי ניתן לשינוי. המיקום שבו המשימה תושלם. אופציונלי ל-UNAVAILABLE Tasks, אבל חובה לכל שאר המשימות.
task_duration	Duration חובה. בלתי ניתן לשינוי. הזמן הדרוש לביצוע משימה במיקום הזה.
target_time_window	TimeWindow חלון הזמן שבמהלכו צריך להשלים את המשימה.
journey_sharing_info	JourneySharingInfo פלט בלבד. שדות ספציפיים לשיתוף תהליכים. לא מאוכלס כשהמדינה היא CLOSED.
task_tracking_view_config	TaskTrackingViewConfig התצורה של מעקב אחר משימות שמציינת אילו רכיבי נתונים יהיו גלויים למשתמשי הקצה ובאילו נסיבות.
attributes[]	TaskAttribute רשימה של מאפיינים מותאמים אישית למשימה. לכל מאפיין צריך להיות מפתח ייחודי.

JourneySharingInfo

שיתוף שדות ספציפיים בתהליך.

שדות
remaining_vehicle_journey_segments[]	VehicleJourneySegment נתוני מעקב של העצירות שבהן הרכב המוקצה יפנה לפני שהמשימה הזו תסתיים. שימו לב שהרשימה הזו יכולה להכיל עצירות ממשימות אחרות. המקטע הראשון, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) או Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), מכיל פרטי מסלול מהמיקום האחרון הידוע של הנהג אל VehicleStop הקרוב. המידע על המסלול הנוכחי בדרך כלל מגיע מאפליקציית הנהג, מלבד מקרים מסוימים שצוינו בתיעוד של DeliveryVehicle.current_route_segment. הפלחים האחרים ב-Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) או ב-Task.journeySharingInfo.remainingVehicleJourneySegments (REST) מאוכלסים על-ידי Fleet Engine. הם מספקים פרטי מסלול בין שאר VehicleStops.
last_location	DeliveryVehicleLocation מציין את המיקום המדווח האחרון של הרכב שהוקצה.
last_location_snappable	bool מציינת אם ניתן להצמיד את המיקום האחרון של הרכב אל current_route_segment. הערך הזה מוגדר כ-False אם last_location או current_route_segment לא קיימים. הערך הזה מחושב על ידי Fleet Engine. המערכת מתעלמת מעדכונים מלקוחות.

מדינה

המצב של משימה. הסטטוס הזה מציין את ההתקדמות של Tasks.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED	ברירת מחדל. משמש למצב משימה לא מזוהה או לא מזוהה.
OPEN	המשימה עדיין לא הוקצתה לרכבת מסירה, או שרכב המשלוחים עדיין לא עבר את העצירה שהוקצתה לTask.
CLOSED	כשהרכב עובר את העצירה במשימה הזו.

TaskOutcome

התוצאה של הניסיון לבצע משימה. כאשר TaskState סגור, TaskOutcome מציין אם הפעולה הושלמה בהצלחה.

טיפוסים בני מנייה (enum)
TASK_OUTCOME_UNSPECIFIED	תוצאת המשימה לפני הגדרת הערך שלה.
SUCCEEDED	המשימה הושלמה.
FAILED	יכול להיות שהמשימה לא הושלמה או שהיא בוטלה.

TaskOutcomeLocationSource

זהות המקור שאיכלס את task_outcome_location.

טיפוסים בני מנייה (enum)
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED	תוצאת המשימה לפני הגדרתה.
PROVIDER	הספק ציין את task_outcome_location.
LAST_VEHICLE_LOCATION	הספק לא ציין task_outcome_location, ולכן Fleet Engine השתמש במיקום הרכב הידוע האחרון.

סוג

סוג המשימה.

טיפוסים בני מנייה (enum)
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 בלתי ניתן לשינוי. מזהה המעקב של משימה. * הערך חייב להיות מחרוזת Unicode חוקית. * מוגבל לאורך של 64 תווים לכל היותר. * נורמליזציה בהתאם לטופס נירמול Unicode 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 רכיב הנתונים הזה גלוי למשתמשי הקצה אם מספר העצירה שנותר <= נותרו_stop_count_threshold.
duration_until_estimated_arrival_time_threshold	Duration רכיב הנתונים הזה גלוי למשתמשי הקצה אם זמן ההגעה המשוער לעצירה <= duration_until_estimated_arrival_time_threshold.
remaining_driving_distance_meters_threshold	int32 רכיב הנתונים הזה גלוי למשתמשי הקצה אם מרחק הנסיעה שנותר במטרים <= left_driving_distance_meters_threshold.
always	bool אם המדיניות מוגדרת כ-True, רכיב הנתונים הזה תמיד גלוי למשתמשי קצה ללא ערכי סף. לא ניתן להגדיר את השדה הזה כ-False.
never	bool אם המדיניות מוגדרת כ-True, רכיב הנתונים הזה תמיד מוסתר ממשתמשי הקצה ללא ערכי סף. לא ניתן להגדיר את השדה הזה כ-False.

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), יכול להיות שהוא יאוכלס במזהי LatLng שמפוענחים מ-DeliveryVehicle.current_route_segment (gRPC) או מ-DeliveryVehicle.currentRouteSegment (REST). הנהג הזה מספק את נתיב הנסיעה מהמיקום האחרון הידוע של אפליקציית הנהג, ולא את הנתיב מהתחנה הקודמת.

VehicleStop

מתארת נקודה שבה כלי רכב עוצר כדי לבצע פעולת Task אחת או יותר.

שדות
planned_location	LocationInfo חובה. מיקום העצירה. חשוב לשים לב שהמיקומים בTask לא תמיד זהים למיקום הזה, אבל הם נמצאים במרחק קצר ממנו. השדה הזה לא יאוכלס בתגובה לקריאה של GetTask.
tasks[]	TaskInfo הרשימה של Task לביצוע בתחנה הזו. השדה הזה לא יאוכלס בתגובה לקריאה של GetTask.
state	State המדינה של VehicleStop. השדה הזה לא יאוכלס בתגובה לקריאה של GetTask.

מדינה

המצב הנוכחי של VehicleStop.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED	לא ידוע.
NEW	נוצר, אבל לא מתבצע ניתוב באופן פעיל.
ENROUTE	מוקצים וניתוב באופן פעיל.
ARRIVED	הגיעה לתחנה. בהנחה שכשהרכב עובר לתחנה הבאה, כל העצירות הקודמות הושלמו.

TaskInfo

מידע נוסף על המשימה שבוצעה בעצירה הזו.

שדות
task_id	string מזהה המשימה. השדה הזה לא יאוכלס בתגובה לקריאה של GetTask. מזהי המשימות כפופים להגבלות הבאות: חייבת להיות מחרוזת Unicode חוקית. מוגבלת לאורך של 64 תווים לכל היותר. מנורמלים בהתאם לטופס הנירמול של Unicode C. לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
task_duration	Duration פלט בלבד. הזמן שנדרש לביצוע המשימה.
target_time_window	TimeWindow פלט בלבד. חלון הזמן שבמהלכו צריך להשלים את המשימה. ההגדרה הזו מוגדרת רק בתשובה ל-GetDeliveryVehicle.