Package maps.fleetengine.delivery.v1

אינדקס

DeliveryService

שירות המשלוחים האחרון.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

יוצרת ומחזירה קבוצה של אובייקטים חדשים מסוג Task.

CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

יצירה ומחזירה של DeliveryVehicle חדש.

CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

יצירה ומחזירה של אובייקט Task חדש.

GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

הפונקציה מחזירה את המופע שצוין בשדה DeliveryVehicle.

GetTask

rpc GetTask(GetTaskRequest) returns (Task)

קבלת מידע על Task.

GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

הפונקציה מחזירה את המופע שצוין בשדה TaskTrackingInfo.

ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

הפונקציה מקבלת את כל הפריטים מסוג 'DeliveryVehicle' שעומדים בקריטריונים לסינון שצוינו.

ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

הפונקציה מקבלת את כל הפריטים מסוג 'Task' שעומדים בקריטריונים לסינון שצוינו.

UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

כתיבת נתונים מעודכנים של DeliveryVehicle ל-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.