Package maps.fleetengine.v1

אינדקס

TripService

שירות לניהול נסיעות.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

יצירת נסיעה ב-Fleet Engine ומחזירה את הנסיעה החדשה.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

קבלת מידע על נסיעה יחידה.
ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

דיווח על שימוש בתשלום בנסיעה.
SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

הצגת כל הנסיעות ברכב מסוים.
UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

נתוני הנסיעה מתעדכנים.

VehicleService

שירות ניהול רכב.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

יוצרים כלי רכב חדש שמשויך לספקי משלוחים או נסיעות על פי דרישה. לכל Vehicle צריך להיות מזהה רכב ייחודי.

כשיוצרים Vehicle, צריך למלא את השדות הבאים מסוג Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

כשיוצרים Vehicle, המערכת מתעלמת מהשדות הבאים של Vehicle:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

כל שאר השדות הם אופציונליים ונעשה בהם שימוש אם סופקו.
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

מחזירה רכב מ-Fleet Engine.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

הפונקציה מחזירה רשימה מקטעי של כלי רכב שמשויכים לספק שתואמים לאפשרויות הבקשה.
SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

הפונקציה מחזירה רשימה של כלי רכב שתואמים לאפשרויות הבקשה.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

כתיבת נתונים מעודכנים של רכב ב-Fleet Engine.

כשמעדכנים Vehicle, אי אפשר לעדכן את השדות הבאים כי הם מנוהלים על ידי השרת:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

כמו כן, לא ניתן לעדכן את הרכב name.

אם מעדכנים את השדה attributes, כל מאפייני הרכב מוחלפים במאפיינים שצוינו בבקשה. אם רוצים לעדכן רק חלק מהמאפיינים, אפשר לעיין בשיטה UpdateVehicleAttributes. בדומה לכך, אפשר לעדכן את השדה waypoints, אבל עליו לכלול את כל ציוני הדרך שנמצאים כרגע ברכב, ולא ציוני דרך אחרים.
UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

עדכון חלקי של מאפייני הרכב. רק המאפיינים שצוינו בבקשה יעודכנו. לא יתבצע שינוי במאפיינים אחרים. הערה: המצב הזה שונה ב-UpdateVehicle, שם השדה attributes כולו יוחלף בערך שב-UpdateVehicleRequest. מאפיינים שלא צוינו בבקשה יוסרו.

BatteryInfo

מידע על סוללת המכשיר.

שדות
battery_status

BatteryStatus

סטטוס הסוללה, אם היא מלאה או נטענת וכו'.
power_source

PowerSource

הסטטוס של מקור החשמל.
battery_percentage

float

אחוז הסוללה הנוכחי [0-100].

BatteryStatus

סטטוס הסוללה, אם היא מלאה או נטענת וכו'.

טיפוסים בני מנייה (enum)
UNKNOWN_BATTERY_STATUS סטטוס הסוללה לא ידוע.
BATTERY_STATUS_CHARGING הסוללה בטעינה.
BATTERY_STATUS_DISCHARGING הסוללה פורקת.
BATTERY_STATUS_FULL הסוללה מלאה.
BATTERY_STATUS_NOT_CHARGING הסוללה לא נטענת.
BATTERY_STATUS_POWER_LOW הסוללה חלשה.

BillingPlatformIdentifier

קבוצת ערכים שמציינים באיזו פלטפורמה נשלחה הבקשה.

טיפוסים בני מנייה (enum)
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED ברירת מחדל. משמש לפלטפורמות שלא צוינו.
SERVER הפלטפורמה היא שרת לקוח.
WEB הפלטפורמה היא דפדפן אינטרנט.
ANDROID הפלטפורמה היא מכשיר נייד Android.
IOS הפלטפורמה היא מכשיר נייד ל-iOS.
OTHERS פלטפורמות אחרות שלא רשומות בספירה הזו.

ConsumableTrafficPolyline

צפיפות התנועה לאורך נתיב הרכב.

שדות
speed_reading_interval[]

SpeedReadingInterval

מהירות התנועה לאורך הנתיב מציון הדרך הקודם עד לנקודת הציון הנוכחית.
encoded_path_to_waypoint

string

הנתיב שהנהג עובר מנקודת הציון הקודמת עד לנקודת הציון הנוכחית. הנתיב הזה כולל ציוני דרך כדי שהלקוחות יוכלו להציג סמני תנועה לאורך הנתיב (ראו speed_reading_interval). עדיין אין תמיכה בפענוח קוד.

CreateTripRequest

הודעת בקשה ל-CreateTrip.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
parent

string

חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
trip_id

string

חובה. מזהה נסיעה ייחודי. בכפוף להגבלות הבאות:

  • חייבת להיות מחרוזת Unicode חוקית.
  • מוגבלת לאורך של 64 תווים לכל היותר.
  • מנורמלים בהתאם לטופס הנירמול של Unicode C.
  • לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
trip

Trip

חובה. ישות בנסיעה כדי ליצור.

כשיוצרים נסיעה, חובה למלא את השדות הבאים:

  • trip_type
  • pickup_point

אם תציינו את השדות הבאים, הם יופיעו:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

המערכת מתעלמת מכל שאר שדות הנסיעה. לדוגמה, כל הנסיעות מתחילות ב-trip_status של NEW גם אם עברת ב-trip_status של CANCELED בבקשת היצירה.

רק נסיעות של EXCLUSIVE תומכות בintermediate_destinations.

אם מגדירים את vehicle_id לנסיעה משותפת, צריך לספק את הרשימה של Trip.vehicle_waypoints כדי לציין את הסדר של שאר ציוני הדרך ברכב, אחרת לא יהיה ידוע לפי סדר הציון.

כשמציינים את Trip.vehicle_waypoints, הרשימה צריכה לכלול את כל ציוני הדרך שנותרו לנסיעות ברכב, ללא ציוני דרך נוספים. חובה להזמין את נקודות הדרך האלה כך שבנסיעה מסוימת, נקודת האיסוף תהיה לפני יעדי הביניים וכל יעדי הביניים יגיעו לפני נקודת ההורדה. אסור שציוני הדרך בEXCLUSIVE יהיו משתלבים עם נסיעות אחרות.

המערכת משתמשת בשדות trip_id, waypoint_type ו-location. המערכת מתעלמת מכל שאר השדות של TripWaypoint ב-vehicle_waypoints.

CreateVehicleRequest

הודעה עם בקשת CreateVehicle.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
parent

string

חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
vehicle_id

string

חובה. מזהה הרכב ייחודי. בכפוף להגבלות הבאות:

  • חייבת להיות מחרוזת Unicode חוקית.
  • מוגבלת לאורך של 64 תווים לכל היותר.
  • מנורמלים בהתאם לטופס הנירמול של Unicode C.
  • לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
vehicle

Vehicle

חובה. ישות הרכב שצריך ליצור. כשיוצרים כלי רכב, חובה למלא את השדות הבאים:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

כשיוצרים כלי רכב, המערכת מתעלמת מהשדות הבאים:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

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

DeviceSettings

מידע על הגדרות שונות במכשיר הנייד.

שדות
location_power_save_mode

LocationPowerSaveMode

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

bool

האם המכשיר נמצא כרגע במצב חיסכון בסוללה.
is_interactive

bool

האם המכשיר במצב אינטראקטיבי.
battery_info

BatteryInfo

מידע על מצב הסוללה.

GetTripRequest

הודעת בקשה ל-GetTrip.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
name

string

חובה. חייב להיות בפורמט providers/{provider}/trips/{trip}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
view

TripView

קבוצת המשנה של שדות הנסיעה שצריכים להחזיר ואת הפרשנות שלהם.
current_route_segment_version

Timestamp

מציינת את חותמת הזמן המינימלית (לא כולל) שלגביה אוחזרו נתונים של Trip.route או Trip.current_route_segment. אם נתוני המסלול לא השתנו מאז חותמת הזמן הזו, שדה הנתיב לא יוגדר בתשובה. אם לא צוין מינימום, נתוני המסלול תמיד מאוחזרים.
remaining_waypoints_version

Timestamp

מציינת את חותמת הזמן המינימלית (לא כולל) שעבורה Trip.remaining_waypoints אוחזרו. אם הערכים לא משתנים מאז חותמת הזמן הזו, הערכים remaining_waypoints לא מוגדרים בתשובה. אם השדה הזה לא מצוין, הערך remaining_waypoints תמיד מאוחזר.
route_format_type

PolylineFormatType

פורמט המסלול הנוכחי שהוחזר, LAT_LNG_LIST_TYPE (ב-Trip.route) או ENCODED_POLYLINE_TYPE (בTrip.current_route_segment). ערך ברירת המחדל הוא LAT_LNG_LIST_TYPE.
current_route_segment_traffic_version

Timestamp

מציינת את חותמת הזמן המינימלית (לא כולל) שעבורה Trip.current_route_segment_traffic אוחזרו. אם נתוני התנועה לא משתנים מאז חותמת הזמן הזו, השדה current_route_segment_traffic לא מוגדר בתשובה. אם לא צוין מינימום, נתוני התנועה תמיד מאוחזרים. לתשומת ליבכם: התנועה זמינה רק ללקוחות שמשתמשים בפתרונות לנסיעות ולמשלוחים על פי דרישה.
remaining_waypoints_route_version

Timestamp

מציינת את חותמת הזמן המינימלית (לא כולל) שלגביה אוחזרו נתונים של Trip.remaining_waypoints.traffic_to_waypoint ו-Trip.remaining_waypoints.path_to_waypoint. אם הנתונים לא השתנו מאז חותמת הזמן הזו, השדות שלמעלה לא יוגדרו בתשובה. אם לא צוין remaining_waypoints_route_version, התנועה והנתיב תמיד מאוחזרים.

GetVehicleRequest

הודעה עם בקשת GetVehicle.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
name

string

חובה. חייב להיות בפורמט providers/{provider}/vehicles/{vehicle}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
current_route_segment_version

Timestamp

מציינת את חותמת הזמן המינימלית (לא כולל) שעבורה Vehicle.current_route_segment אוחזרו. אם המסלול לא משתנה מאז חותמת הזמן הזו, השדה current_route_segment לא יוגדר בתשובה. אם לא צוין מינימום, הערך current_route_segment תמיד מאוחזר.
waypoints_version

Timestamp

מציינת את חותמת הזמן המינימלית (לא כולל) שלגביה אוחזרו נתונים של Vehicle.waypoints. אם ציוני הדרך לא השתנו מאז חותמת הזמן הזו, הנתונים של vehicle.waypoints לא יוגדרו בתשובה. אם השדה הזה לא מצוין, הערך vehicle.waypoints תמיד מאוחזר.

LicensePlate

פרטי לוחית הרישוי של הרכב. כדי להימנע מאחסון פרטים אישיים מזהים, רק המידע המינימלי לגבי לוחית הרישוי מאוחסן כחלק מהישות.

שדות
country_code

string

חובה. קוד המדינה או האזור במאגר CLDR. לדוגמה, US לארצות הברית או IN להודו.
last_character

string

הספרה האחרונה של לוחית הרישוי או '1-' כדי לציין שלוחית הרישוי לא מכילה ערך מספרי.

  • "ABC 1234" -> '4'
  • 'AB 123 CD' -> '3'
  • 'ABCDEF' -> " -1"

ListVehiclesRequest

הודעה עם בקשת ListVehicles.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
parent

string

חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
page_size

int32

המספר המקסימלי של כלי רכב שצריך להחזיר. ערך ברירת המחדל: 100.
page_token

string

הערך של הnext_page_token שסופק על ידי קריאה קודמת ל-ListVehicles, כדי שאפשר יהיה לעבור לדפים בקבוצות של כלי רכב. הערך לא מוגדר אם קריטריוני הסינון של הבקשה לא זהים לקריטריוני הסינון של הקריאה הקודמת אל ListVehicles.
minimum_capacity

Int32Value

מציינת את הקיבולת המינימלית הנדרשת של הרכב. הערך של כל כלי הרכב שמוחזרים יהיה maximum_capacity גדול יותר מהערך הזה או שווה לו. אם הערך מוגדר, הערך חייב להיות שווה ל-0 או גדול ממנו.
trip_types[]

TripType

הגבלת התגובה לכלי רכב שתומכים לפחות באחד מסוגי הנסיעה שצוינו.
maximum_staleness

Duration

הגבלת התגובה לכלי רכב ששלחו עדכוני מיקום ל-Fleet Engine בטווח הזמן שצוין. כלי רכב נייחים שעדיין משדרים את מיקומם לא נחשבים למיושנים. אם השדה הזה קיים, הוא צריך להיות משך זמן תקין תקין.
vehicle_type_categories[]

Category

חובה. מגבילה את התגובה לכלי רכב עם אחת מקטגוריות הסוגים שצוינו. לא ניתן להפר את המדיניות: UNKNOWN
required_attributes[]

string

מתקשרים יכולים ליצור פעולות לוגיות מורכבות באמצעות כל שילוב של השדות required_attributes, required_one_of_attributes ו-required_one_of_attribute_sets.

required_attributes היא רשימה; required_one_of_attributes משתמש בהודעה שמאפשרת להציג רשימה של רשימות. בשילוב, שני השדות מאפשרים את ההרכבת של הביטוי הזה:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

המדיניות מגבילה את התגובה לכלי רכב עם המאפיינים שצוינו. השדה הזה הוא פעולת חיבור/AND. אפשר להוסיף עד 50 מאפייני required_attribute. הערך הזה תואם למספר המאפיינים המקסימלי שמותר לכלול ברכב. כל מחרוזת חוזרת צריכה להיות בפורמט "key:value".
required_one_of_attributes[]

string

הגבלת התגובה לכלי רכב עם לפחות אחד מהמאפיינים שצוינו בכל VehicleAttributeList. בכל רשימה, הרכב צריך להתאים לפחות לאחד מהמאפיינים. השדה הזה הוא פעולת פירוק/או (OR) כוללני בכל VehicleAttributeList ופעולת חיבור/AND בכל האוסף של VehicleAttributeList. כל מחרוזת חוזרת צריכה להיות בפורמט "key1:value1|key2:value2|key3:value3".
required_one_of_attribute_sets[]

string

האפליקציה required_one_of_attribute_sets מספקת פונקציונליות נוספת.

בדומה ל-required_one_of_attributes, הפקודה required_one_of_attribute_sets משתמשת בהודעה שמאפשרת להציג רשימה של רשימות, באמצעות שימוש בביטויים כמו זה:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

המדיניות מגבילה את התגובה לכלי רכב שתואמים לכל המאפיינים ב-VehicleAttributeList. בכל רשימה, הרכב צריך להתאים לכל המאפיינים. השדה הזה הוא פעולת חיבור/AND בכל פעולת VehicleAttributeList פרטנית/או כוללת בכל האוסף של VehicleAttributeList. כל מחרוזת חוזרת צריכה להיות בפורמט "key1:value1|key2:value2|key3:value3".
vehicle_state

VehicleState

הגבלת התגובה לכלי רכב עם מצב הרכב הזה.
on_trip_only

bool

החזרת רכבים עם נסיעות נוכחיות בלבד.
filter

string

זה שינוי אופציונלי. שאילתת סינון שצריך להחיל כשמציגים כלי רכב. דוגמאות לתחביר של המסנן: http://aip.dev/160

השדה הזה נועד להחליף את השדות required_attributes, required_one_of_attributes ו-required_one_of_attributes_sets. אם מצוין כאן ערך שאינו ריק, השדות הבאים צריכים להיות ריקים: required_attributes, required_one_of_attributes ו-required_one_of_attributes_sets.

המסנן הזה פועל כתנאי AND עם אילוצים אחרים, כמו vehicle_state או on_trip_only.

לתשומת ליבכם, השאילתות היחידות שנתמכות הן על מאפייני רכב (לדוגמה, attributes.<key> = <value> או attributes.<key1> = <value1> AND attributes.<key2> = <value2>). מספר ההגבלות המקסימלי המותר לשאילתת סינון הוא 50.

בנוסף, כל המאפיינים מאוחסנים כמחרוזות, כך שאפשר להשוות רק בין מחרוזות לבין מאפיינים. כדי להשוות מול ערכים של מספרים או בוליאניים, יש להקיף את הערכים באופן מפורש כך שיטופלו כמחרוזות (לדוגמה, attributes.<key> = "10" או attributes.<key> = "true").
viewport

Viewport

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

ListVehiclesResponse

הודעת תגובה אחת (ListVehicles).

שדות
vehicles[]

Vehicle

כלי רכב שתואמים לקריטריונים של הבקשה. המספר המקסימלי של כלי רכב שהוחזרו נקבע לפי השדה page_size בבקשה.
next_page_token

string

אסימון לשחזור הדף הבא של כלי רכב, או ריק אם אין עוד רכבים שעומדים בקריטריונים של הבקשה.
total_size

int64

חובה. המספר הכולל של כלי רכב שתואמים לקריטריוני הבקשה בכל הדפים.

LocationPowerSaveMode

איך תכונות המיקום מוגדרות כך שיפעלו בנייד כשהמכשירים במצב 'חיסכון בסוללה' התכונה מופעלת. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

טיפוסים בני מנייה (enum)
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode לא מוגדר
LOCATION_MODE_NO_CHANGE ספקי המיקום לא אמורים להיות מושפעים ממצב 'חיסכון בסוללה' או מ'חיסכון בסוללה'.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF יש להשבית את ספק המיקום המבוסס על GPS כשמצב חיסכון בסוללה מופעל והמכשיר לא אינטראקטיבי.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF יש להשבית את כל ספקי המיקום כשמצב 'חיסכון בסוללה' פועל כשהמכשיר לא אינטראקטיבי.
LOCATION_MODE_FOREGROUND_ONLY כל ספקי המיקום ימשיכו להיות זמינים, אבל יש לספק תיקוני מיקום רק לאפליקציות שפועלות בחזית.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF התכונה 'מיקום' לא תושבת, אבל מנהל המיקום ויסות את כל הבקשות לספקים כשהמכשיר לא אינטראקטיבי.

LocationSensor

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

טיפוסים בני מנייה (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 של רכב.
FLEET_ENGINE_LOCATION המיקום מחושב על ידי Fleet Engine על סמך האותות שזמינים לו. פלט בלבד. הערך הזה יידחה אם הוא יתקבל בבקשה.
FUSED_LOCATION_PROVIDER ספק המיקום המשולב של Android.
CORE_LOCATION ספק המיקום במערכות ההפעלה של Apple.

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

טיפוסים בני מנייה (enum)
UNKNOWN_NAVIGATION_STATUS סטטוס הניווט לא צוין.
NO_GUIDANCE הניווט באפליקציית הנהג נמצא במצב FREE_NAV.
ENROUTE_TO_DESTINATION יש ניווט במסלול מפורט, והניווט באפליקציית הנהג עבר למצב GUIDED_NAV.
OFF_ROUTE הרכב סטה מהמסלול שהצענו.
ARRIVED_AT_DESTINATION הרכב נמצא בטווח של כ-50 מטרים מהיעד.

PolylineFormatType

סוג הפורמט של קו פוליגוני.

טיפוסים בני מנייה (enum)
UNKNOWN_FORMAT_TYPE הפורמט לא צוין או שהוא לא ידוע.
LAT_LNG_LIST_TYPE רשימה של google.type.LatLng.
ENCODED_POLYLINE_TYPE קו פוליגוני שמקודד באמצעות אלגוריתם לדחיסת קו פוליגוני. עדיין אין תמיכה בפענוח קוד.

PowerSource

סוג המטען שמשמש לטעינת הסוללה.

טיפוסים בני מנייה (enum)
UNKNOWN_POWER_SOURCE מקור החשמל לא ידוע.
POWER_SOURCE_AC מקור החשמל הוא מטען לחשמל.
POWER_SOURCE_USB מקור החשמל הוא יציאת USB.
POWER_SOURCE_WIRELESS מקור החשמל הוא אלחוטי.
POWER_SOURCE_UNPLUGGED הסוללה מנותקת.

ReportBillableTripRequest

הודעת הבקשה ReportBillableTrip.

שדות
name

string

חובה. חייב להיות בפורמט providers/{provider}/billableTrips/{billable_trip}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
country_code

string

חובה. קוד מדינה בן 2 אותיות של המדינה שבה הנסיעה מתבצעת. המחיר מוגדר בהתאם לקוד המדינה.
platform

BillingPlatformIdentifier

הפלטפורמה שאליה נשלחה הבקשה.
related_ids[]

string

המזהים שקשורים ישירות לנסיעה המדווחת. אלה בדרך כלל מזהים (למשל, מזהי סשנים) של פעולות הזמנה מראש שבוצעו לפני שמזהה הנסיעה יהיה זמין. מספר הrelated_ids מוגבל ל-50.
solution_type

SolutionType

סוג הפתרון למוצר GMP (לדוגמה, ON_DEMAND_RIDESHARING_AND_DELIVERIES) ששימש לנסיעה שדווחה.

SolutionType

בורר לסוגי פתרונות שונים של נסיעה שדווחה.

טיפוסים בני מנייה (enum)
SOLUTION_TYPE_UNSPECIFIED ערך ברירת המחדל. לצורך תאימות לאחור, ה-API ישתמש כברירת מחדל ב-ON_DEMAND_RIDESHARING_AND_DELIVERIES, שהוא סוג הפתרון הראשון הנתמך.
ON_DEMAND_RIDESHARING_AND_DELIVERIES הפתרון הוא נסיעה משותפת ונסיעות על פי דרישה.

RequestHeader

RequestHeader מכיל שדות משותפים לכל בקשות ה-RPC ב-Fleet Engine.

שדות
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.

SearchTripsRequest

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

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
parent

string

חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
vehicle_id

string

הרכב שמשויך לנסיעות בבקשה. אם לא צוין, הנסיעות שהוחזרו לא יכללו:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

אם המדיניות מוגדרת כ-True, התגובה כוללת 'נסיעות' שמשפיעות על מסלול הנהג.
page_size

int32

אם המדיניות לא מוגדרת, השרת קובע את מספר התוצאות שיוחזרו.
page_token

string

כדי להמשיך מהתוצאות הקודמות, צריך להגדיר את הערך הזה לערך שהוחזר בעבר ב-SearchTripsResponse.
minimum_staleness

Duration

אם צוין, המערכת תחזיר את הנסיעות שלא עודכנו אחרי השעה (current - minimum_staleness).

SearchTripsResponse

הודעת תגובה מ-SearchTrips.

שדות
trips[]

Trip

רשימת הנסיעות של הרכב המבוקש.
next_page_token

string

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

SearchVehiclesRequest

הודעה עם בקשת SearchVehicles.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
parent

string

חובה. חייב להיות בפורמט providers/{provider}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
pickup_point

TerminalLocation

חובה. נקודת האיסוף שבה יש לחפש.
dropoff_point

TerminalLocation

מיקום המסירה המיועד של הלקוח. השדה הזה הוא חובה אם הערך trip_types מכיל TripType.SHARED.
pickup_radius_meters

int32

חובה. הגדרת הרדיוס של חיפוש הרכבים סביב נקודת האיסוף. יוחזרו רק כלי רכב שנמצאים ברדיוס החיפוש. הערך חייב להיות בין 400 ל-10,000 מטרים (כולל).
count

int32

חובה. מציינת את מספר הרכבים המקסימלי שצריך להחזיר. הערך חייב להיות בין 1 ל-50 (כולל).
minimum_capacity

int32

חובה. מציין את מספר הנוסעים שנכללו בנסיעה. הערך חייב להיות גדול מ-1 או שווה לו. הנהג לא נלקח בחשבון בערך הקיבולת.
trip_types[]

TripType

חובה. סוג הנסיעה המוצעת. חייב לכלול סוג אחד בלבד. לא ניתן להפר את המדיניות: UNKNOWN_TRIP_TYPE מגביל את החיפוש רק לכלי הרכב שיכולים לתמוך בסוג הנסיעה הזה.
maximum_staleness

Duration

מגביל את החיפוש רק לכלי רכב ששלחו עדכוני מיקום ל-Fleet Engine במשך פרק הזמן שצוין. כלי רכב נייחים שעדיין משדרים את מיקומם לא נחשבים למיושנים. אם השדה הזה לא מוגדר, השרת ישתמש ב-5 דקות כערך ברירת המחדל.
vehicle_types[]

VehicleType

חובה. מגביל את החיפוש לכלי רכב עם אחד מהסוגים שצוינו. יש לציין לפחות סוג רכב אחד. אסור לפרסם סוגי רכב עם קטגוריה של UNKNOWN.
required_attributes[]

VehicleAttribute

מתקשרים יכולים ליצור פעולות לוגיות מורכבות באמצעות כל שילוב של השדות required_attributes, required_one_of_attributes ו-required_one_of_attribute_sets.

required_attributes היא רשימה; required_one_of_attributes משתמש בהודעה שמאפשרת להציג רשימה של רשימות. בשילוב, שני השדות מאפשרים את ההרכבת של הביטוי הזה:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

מגביל את החיפוש רק לרכבים עם המאפיינים שצוינו. השדה הזה הוא פעולת חיבור/AND. אפשר להוסיף עד 50 מאפייני required_attribute. הערך הזה תואם למספר המאפיינים המקסימלי שמותר לכלול ברכב.
required_one_of_attributes[]

VehicleAttributeList

מגביל את החיפוש רק לרכבים עם לפחות אחד מהמאפיינים שצוינו בכל VehicleAttributeList. בכל רשימה, הרכב צריך להתאים לפחות לאחד מהמאפיינים. השדה הזה הוא פעולת פירוק/או (OR) כוללני בכל VehicleAttributeList ופעולת חיבור/AND בכל האוסף של VehicleAttributeList.
required_one_of_attribute_sets[]

VehicleAttributeList

האפליקציה required_one_of_attribute_sets מספקת פונקציונליות נוספת.

בדומה ל-required_one_of_attributes, הפקודה required_one_of_attribute_sets משתמשת בהודעה שמאפשרת להציג רשימה של רשימות, באמצעות שימוש בביטויים כמו זה:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

מגביל את החיפוש רק לרכבים עם כל המאפיינים בVehicleAttributeList. בכל רשימה, הרכב צריך להתאים לכל המאפיינים. השדה הזה הוא פעולת חיבור/AND בכל פעולת VehicleAttributeList פרטנית/או כוללת בכל האוסף של VehicleAttributeList.
order_by

VehicleMatchOrder

חובה. מציינת את הקריטריון הרצוי לסדר התוצאות.
include_back_to_back

bool

האפשרות הזו מציינת אם כלי רכב עם נסיעה פעילה אחת עומדים בדרישות לחיפוש הזה. השדה הזה משמש רק אם לא צוין current_trips_present. אם לא צוין current_trips_present והשדה הזה הוא false, כלי רכב שהוקצו להם נסיעות מוחרגים מתוצאות החיפוש. אם לא צוין current_trips_present והשדה הזה הוא true, תוצאות החיפוש יכולות לכלול כלי רכב עם נסיעה פעילה אחת בסטטוס ENROUTE_TO_DROPOFF. אם מציינים את current_trips_present, אי אפשר להגדיר את השדה הזה כ-true.

ערך ברירת המחדל הוא false.
trip_id

string

מציין את הנסיעה שמשויכת לSearchVehicleRequest הזה.
current_trips_present

CurrentTripsPresent

האפשרות מציינת אם כלי רכב עם נסיעות פעילות עומדים בדרישות לחיפוש הזה. הערך צריך להיות מוגדר לערך שאינו CURRENT_TRIPS_PRESENT_UNSPECIFIED אם trip_type כולל את SHARED.
filter

string

זה שינוי אופציונלי. שאילתת סינון שצריך להחיל כשמחפשים כלי רכב. דוגמאות לתחביר של המסנן: http://aip.dev/160

השדה הזה נועד להחליף את השדות required_attributes, required_one_of_attributes ו-required_one_of_attributes_sets. אם מצוין כאן ערך שאינו ריק, השדות הבאים צריכים להיות ריקים: required_attributes, required_one_of_attributes ו-required_one_of_attributes_sets.

המסנן הזה פועל כתנאי AND עם אילוצים אחרים, כמו minimum_capacity או vehicle_types.

לתשומת ליבכם, השאילתות היחידות שנתמכות הן על מאפייני רכב (לדוגמה, attributes.<key> = <value> או attributes.<key1> = <value1> AND attributes.<key2> = <value2>). מספר ההגבלות המקסימלי המותר לשאילתת סינון הוא 50.

בנוסף, כל המאפיינים מאוחסנים כמחרוזות, כך שאפשר להשוות רק בין מחרוזות לבין מאפיינים. כדי להשוות מול ערכים של מספרים או בוליאניים, יש להקיף את הערכים באופן מפורש כך שיטופלו כמחרוזות (לדוגמה, attributes.<key> = "10" או attributes.<key> = "true").

CurrentTripsPresent

מציינת את סוגי ההגבלות בנסיעות הנוכחיות של הרכב.

טיפוסים בני מנייה (enum)
CURRENT_TRIPS_PRESENT_UNSPECIFIED הזמינות של כלי רכב שיש בהם נסיעות נקבעת לפי השדה include_back_to_back.
NONE רכבים ללא נסיעות יכולים להופיע בתוצאות החיפוש. כשמשתמשים בערך הזה, הערך של include_back_to_back לא יכול להיות true.
ANY כלי רכב עם 5 נסיעות עדכניות ו-10 ציוני דרך לכל היותר נכללים בתוצאות החיפוש. כשמשתמשים בערך הזה, הערך של include_back_to_back לא יכול להיות true.

VehicleMatchOrder

מציינת את סדר ההתאמות של הרכב בתגובה.

טיפוסים בני מנייה (enum)
UNKNOWN_VEHICLE_MATCH_ORDER ברירת מחדל, משמשת להתאמות של רכבים שלא צוינו או לא מזוהים.
PICKUP_POINT_ETA הזמנה בסדר עולה לפי זמן הנסיעה של הרכב עד לנקודת האיסוף.
PICKUP_POINT_DISTANCE סדר עולה לפי מרחק הנסיעה של הרכב לנקודת האיסוף.
DROPOFF_POINT_ETA סדר עולה לפי זמן הנסיעה ברכב עד לנקודת ההורדה. אפשר להשתמש בהזמנה הזו רק אם נקודת ההורדה מצוינת בבקשה.
PICKUP_POINT_STRAIGHT_DISTANCE סדר עולה לפי המרחק של הקו הישר מהמיקום האחרון של הרכב ועד לנקודת האיסוף.
COST סדר עולה לפי עלות ההתאמה שהוגדרה. עלות ההתאמה מוגדרת כחישוב משוקלל בין מרחק הקו הישר וזמן ההגעה המשוער. המשקלים מוגדרים עם ערכי ברירת המחדל, ואפשר לשנות אותם לכל לקוח. אם צריך לשנות את המשקלים האלה בפרויקט שלכם, יש לפנות לתמיכה של Google.

SearchVehiclesResponse

הודעת תגובה אחת (SearchVehicles).

שדות
matches[]

VehicleMatch

רשימת רכבים שתואמים לקריטריונים של SearchVehiclesRequest, מסודרים לפי השדה SearchVehiclesRequest.order_by.

SpeedReadingInterval

אינדיקטור של צפיפות התנועה בקטע רציף של נתיב. בהינתן נתיב עם נקודות P_0, P_1, ... , P_N (אינדקס מבוסס אפס), ה- SpeedReadingInterval מגדיר מרווח ומתאר את התנועה באמצעות הקטגוריות הבאות.

שדות
start_polyline_point_index

int32

האינדקס ההתחלתי של המרווח הזה בנתיב. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס.
end_polyline_point_index

int32

האינדקס האחרון של המרווח הזה בנתיב. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס.
speed

Speed

מהירות התנועה במרווח הזה.

מהירות

סיווג מהירות של קו פוליגוני על סמך נתוני תנועה.

טיפוסים בני מנייה (enum)
SPEED_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
NORMAL מהירות רגילה, לא מזוהה האטה.
SLOW זוהתה האטה, אבל לא נוצר עומס תנועה.
TRAFFIC_JAM זוהה עומס תנועה.

StopLocation

המיקום בפועל שבו התרחשה העצירה (איסוף/הורדה).

שדות
point

LatLng

חובה. מציינת את המיקום בפועל.
timestamp

Timestamp

מציין מתי הופסקה העצירה.
stop_time
(deprecated)

Timestamp

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

TerminalLocation

מתאר את המיקום של ציון דרך.

שדות
point

LatLng

חובה. מציין את המיקום של ציון דרך בנסיעה.
terminal_point_id
(deprecated)

TerminalPointId

הוצא משימוש: צריך לציין במקום זאת את השדה point.
access_point_id
(deprecated)

string

הוצא משימוש: צריך לציין במקום זאת את השדה point.
trip_id
(deprecated)

string

הוצא משימוש.
terminal_location_type
(deprecated)

WaypointType

הוצא משימוש: ל-Vehicle.waypoint יהיו הנתונים האלה.

TerminalPointId

הוצא משימוש: אין יותר תמיכה ב-TerminalPoints ב-Fleet Engine. במקום זאת, אתם צריכים להשתמש ב-TerminalLocation.point.

שדות
value
(deprecated)

string

הוצא משימוש.
שדה איחוד Id. הוצא משימוש. Id יכול להיות רק אחת מהאפשרויות הבאות:
place_id
(deprecated)

string

הוצא משימוש.
generated_id
(deprecated)

string

הוצא משימוש.

TrafficPolylineData

מצב התנועה לאורך מסלול הרכב הצפוי.

שדות
traffic_rendering

VisualTrafficReportPolylineRendering

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

נסיעה

המטא-נתונים של הנסיעה.

שדות
name

string

פלט בלבד. בפורמט 'providers/{provider}/trips/{trip}'
vehicle_id

string

המזהה של הרכב בנסיעה הזו.
trip_status

TripStatus

הסטטוס הנוכחי של הנסיעה.
trip_type

TripType

סוג הנסיעה.
pickup_point

TerminalLocation

המיקום שבו הלקוח מציין שהוא יאסוף.
actual_pickup_point

StopLocation

קלט בלבד. המיקום בפועל מתי ואיפה הלקוח נאסף. השדה הזה נועד לספק משוב על פרטי האיסוף בפועל.
actual_pickup_arrival_point

StopLocation

קלט בלבד. השעה והמיקום בפועל של ההגעה של הנהג לנקודת האיסוף. השדה הזה מיועד לספק משוב לגבי ההגעה בפועל לנקודת האיסוף.
pickup_time

Timestamp

פלט בלבד. הזמן המשוער העתידי לאיסוף הנוסעים או השעה בפועל שבה הם נאספו.
intermediate_destinations[]

TerminalLocation

עצירות ביניים לפי סדר בקשת הנסיעה (בנוסף לאיסוף ולהורדה). בשלב הראשון לא תהיה תמיכה באפשרות הזו בנסיעות משותפות.
intermediate_destinations_version

Timestamp

מציין את הפעם האחרונה שבה בוצע שינוי ב-intermediate_destinations. השרת צריך לשמור את הערך הזה במטמון ולהעביר אותו ב-UpdateTripRequest כשמעדכנים את intermediate_destination_index, כדי להבטיח שה-intermediate_destinations לא ישתנה.
intermediate_destination_index

int32

כשהערך בשדה TripStatus הוא ENROUTE_TO_INTERMEDIATE_DESTINATION, יופיע מספר בין [0..N-1] שמציין את יעד הביניים הבא שבו הרכב יעבור. כשהערך של TripStatus הוא ARRIVED_AT_INTERMEDIATE_DESTINATION, מספר בין [0..N-1] שמציין את יעד הביניים שבו נמצא הרכב. הספק מגדיר את הערך הזה. אם אין intermediate_destinations, המערכת תתעלם מהשדה הזה.
actual_intermediate_destination_arrival_points[]

StopLocation

קלט בלבד. השעה והמיקום בפועל של הגעת הנהג ליעד הביניים. השדה הזה נועד לספק משוב לגבי הגעה בפועל ליעדי הביניים.
actual_intermediate_destinations[]

StopLocation

קלט בלבד. השעה והמיקום האמיתיים שבהם בוצע האיסוף של הלקוח מיעד הביניים, ושבו. השדה הזה נועד לספק משוב לגבי המידע על האיסוף בפועל ביעדי הביניים.
dropoff_point

TerminalLocation

המיקום שבו הלקוח מציין שהוא יעזוב.
actual_dropoff_point

StopLocation

קלט בלבד. השעה והמיקום בפועל שבהם הלקוח עצר. השדה הזה נועד לספק משוב על מידע בפועל על נשירה.
dropoff_time

Timestamp

פלט בלבד. הזמן המשוער העתידי שבו נוסעים יעזבו את היעד הסופי או השעה בפועל שבה הם הושמטו.
remaining_waypoints[]

TripWaypoint

פלט בלבד. הנתיב המלא מהמיקום הנוכחי אל נקודת הירידה, כולל. הנתיב הזה יכול לכלול ציוני דרך מנסיעות אחרות.
vehicle_waypoints[]

TripWaypoint

השדה הזה תומך בסדר ידני של ציוני הדרך בנסיעה. היא מכילה את כל נקודות הדרך הנותרות של הרכב שהוקצה לה, וגם את ציוני הדרך לאיסוף ולהורדה בנסיעה הזו. אם הנסיעה לא הוקצתה לרכב, Fleet Engine מתעלם מהשדה הזה. מטעמי פרטיות, השדה הזה מאוכלס רק על ידי השרת בשיחות UpdateTrip ו-CreateTrip, ולא בקריאות GetTrip.
route[]

LatLng

פלט בלבד. המסלול הצפוי לנסיעה הזו אל הכניסה הראשונה ב-נשארים_waypoints. לתשומת ליבכם: יכול להיות שציון הדרך הראשון שייך לנסיעה אחרת.
current_route_segment

string

פלט בלבד. נתיב מקודד לנקודת הציון הבאה.

הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK. עדיין אין תמיכה בפענוח קוד.
current_route_segment_version

Timestamp

פלט בלבד. מציין את הפעם האחרונה שבה בוצע שינוי במסלול.

הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK.
current_route_segment_traffic

ConsumableTrafficPolyline

פלט בלבד. מציין את מצב התנועה לאורך current_route_segment, כשהם זמינים.

הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK.
current_route_segment_traffic_version

Timestamp

פלט בלבד. זוהי הפעם האחרונה שבה בוצע שינוי ב-current_route_segment_traffic.

הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK.
current_route_segment_end_point

TripWaypoint

פלט בלבד. ציון הדרך שבו מסתיים current_route_segment.
remaining_distance_meters

Int32Value

פלט בלבד. מרחק הנסיעה שנותר בשדה current_route_segment. הערך לא צוין אם הנסיעה לא הוקצתה לרכב, או אם הנסיעה הושלמה או בוטלה.
eta_to_first_waypoint

Timestamp

פלט בלבד. זמן ההגעה המשוער לציון הדרך הבא (הרשומה הראשונה בשדה remaining_waypoints). הערך לא צוין אם הנסיעה לא הוקצתה לרכב, או אם הנסיעה לא פעילה (הושלמה או בוטלה).
remaining_time_to_first_waypoint

Duration

פלט בלבד. משך הזמן שממנו מוחזרים נתוני הנסיעה לזמן ב-Trip.eta_to_first_waypoint. הערך לא צוין אם הנסיעה לא הוקצתה לרכב, או אם הנסיעה לא פעילה (הושלמה או בוטלה).
remaining_waypoints_version

Timestamp

פלט בלבד. מציין את הפעם האחרונה שבה בוצע שינוי של remaining_waypoints (נוסף, הוסר או השתנה ציון דרך).
remaining_waypoints_route_version

Timestamp

פלט בלבד. זוהי הפעם האחרונה שבה בוצע שינוי ב-remaining_waypoints.path_to_waypoint וב-remaining_waypoints.traffic_to_waypoint. אפליקציית הלקוח צריכה לשמור את הערך הזה במטמון ולהעביר אותו ב-GetTripRequest כדי להבטיח שהנתיבים והתנועה של remaining_waypoints יוחזרו רק אם הם יעודכנו.
number_of_passengers

int32

בלתי ניתן לשינוי. מציין את מספר הנוסעים בנסיעה הזו ולא כולל את הנהג. כדי להחזיר רכב בתגובה SearchVehicles, צריכה להיות קיבולת זמינה של רכב.
last_location

VehicleLocation

פלט בלבד. מציינת את המיקום האחרון שדווחו על ידי הרכב לאורך המסלול.
last_location_snappable

bool

פלט בלבד. שדה זה מציין אם ניתן להצמיד את last_location של הרכב למקטע הנוכחי_נתיב. הערך הוא False אם last_location או current_route_segment לא קיימים. החישוב שלו מתבצע על ידי Fleet Engine. המערכת תתעלם מעדכונים מלקוחות.
view

TripView

קבוצת המשנה של שדות הנסיעה שאוכלסו ואיך צריך לפרש אותם.

TripStatus

הסטטוס של נסיעה שמעיד על ההתקדמות שלה.

טיפוסים בני מנייה (enum)
UNKNOWN_TRIP_STATUS ברירת המחדל, משמשת לסטטוס נסיעה שלא צוין או לא מזוהה.
NEW נסיעה חדשה שנוצרה.
ENROUTE_TO_PICKUP הנהג בדרך לנקודת האיסוף.
ARRIVED_AT_PICKUP הנהג הגיע לנקודת האיסוף.
ARRIVED_AT_INTERMEDIATE_DESTINATION הנהג הגיע ליעד ביניים וממתין לנוסע.
ENROUTE_TO_INTERMEDIATE_DESTINATION הנהג נמצא בדרכו ליעד ביניים (לא לנקודת ההורדה).
ENROUTE_TO_DROPOFF הנהג אסף את הנוסע ושוכן בדרכו ליעד הבא.
COMPLETE הנוסעים ירדו והנסיעה הושלמה.
CANCELED הנסיעה בוטלה לפני האיסוף על ידי הנהג, הנוסע או ספק שיתוף הנסיעה.

TripType

סוג הנסיעה.

טיפוסים בני מנייה (enum)
UNKNOWN_TRIP_TYPE ברירת המחדל, משמשת לסוגי נסיעות שלא צוינו או לא מזוהים.
SHARED הנסיעה עשויה לשתף רכב עם נסיעות אחרות.
EXCLUSIVE הנסיעה היא בלעדית לרכב.

TripView

סלקטור לקבוצות שונות של שדות נסיעה בתשובת GetTrip. למידע נוסף, ראו AIP-157. סביר להניח שיתווספו עוד תצוגות.

טיפוסים בני מנייה (enum)
TRIP_VIEW_UNSPECIFIED ערך ברירת המחדל. בתאימות לאחור, ה-API יוגדר כברירת מחדל לתצוגת SDK. כדי לשמור על יציבות ותמיכה, אנחנו ממליצים ללקוחות לבחור מכשיר TripView שהוא לא SDK.
SDK נכללים שדות שייתכן שלא ניתן לפרש או לתמוך בהם באמצעות ספריות זמינות לציבור.
JOURNEY_SHARING_V1S שדות הנסיעה מאוכלסים בתרחיש לדוגמה של 'שיתוף מסלול'. התצוגה הזו מיועדת לתקשורת בין שרתים.

TripWaypoint

מתארת נקודת עצירה במסלול הרכב או נקודת סיום בנסיעה של רכב.

שדות
location

TerminalLocation

המיקום של ציון הדרך הזה.
trip_id

string

הנסיעה שמשויכת לנקודת הציון הזו.
waypoint_type

WaypointType

התפקיד שציון הדרך הזה ממלא בנסיעה הזו, למשל איסוף או החזרה.
path_to_waypoint[]

LatLng

הנתיב מציון הדרך הקודם עד לנקודת הציון הנוכחית. לא מוגדר לציון הדרך הראשון ברשימה. השדה הזה יאוכלס רק כשנשלחת בקשה לכך.
encoded_path_to_waypoint

string

הנתיב המקודד מציון הדרך הקודם עד לנקודת הציון הנוכחית.

הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK. עדיין אין תמיכה בפענוח קוד.
traffic_to_waypoint

ConsumableTrafficPolyline

מצב התנועה לאורך הנתיב לנקודת הציון הזו. לתשומת ליבכם: התנועה זמינה רק ללקוחות של הפתרון 'נסיעות ומשלוחים' בפלטפורמה של מפות Google.
distance_meters

Int32Value

המרחק של הדרך מציון הדרך הקודם עד לנקודת הציון הנוכחית. לא מוגדר לציון הדרך הראשון ברשימה.
eta

Timestamp

זמן ההגעה המשוער לנקודת הציון הזו. לא מוגדר לציון הדרך הראשון ברשימה.
duration

Duration

זמן הנסיעה מנקודת הציון הקודמת עד לנקודה הזו. לא מוגדר לציון הדרך הראשון ברשימה.

UpdateTripRequest

הודעת בקשה ל-UpdateTrip.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
name

string

חובה. חייב להיות בפורמט providers/{provider}/trips/{trip}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-consumer-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
trip

Trip

חובה. הנסיעה שמשויכת לעדכון.

השדות הבאים מתוחזקים על ידי Fleet Engine. אין לעדכן אותן באמצעות Trip.update.

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

כשמעדכנים את Trip.vehicle_id של נסיעה משותפת, צריך לספק את הרשימה של Trip.vehicle_waypoints כדי לציין את הסדר של נקודות הדרך שנותרו, אחרת הסדר לא ייקבע.

כשמציינים את Trip.vehicle_waypoints, הרשימה צריכה להכיל את כל ציוני הדרך שנותרו בנסיעות ברכב, ללא ציוני דרך נוספים. חובה להזמין את נקודות הדרך האלה כך שבנסיעה מסוימת, נקודת האיסוף תהיה לפני יעדי הביניים וכל יעדי הביניים יגיעו לפני נקודת ההורדה. אסור שציוני הדרך בEXCLUSIVE יהיו משתלבים עם נסיעות אחרות. המערכת משתמשת בשדות trip_id, waypoint_type ו-location. המערכת מתעלמת מכל שאר השדות של TripWaypoint ב-vehicle_waypoints.

כדי להימנע ממרוץ תהליכים בנסיעות עם מספר יעדים, צריך לספק Trip.intermediate_destinations_version כשמעדכנים את סטטוס הנסיעה לENROUTE_TO_INTERMEDIATE_DESTINATION. הערך של Trip.intermediate_destinations_version שהועבר צריך להיות תואם לגרסה של Fleet Engine. אם לא, הבקשה תיכשל.
update_mask

FieldMask

חובה. מסכת השדות שמציינת אילו שדות ב'נסיעה' לעדכן. השדה update_mask חייב להכיל לפחות שדה אחד.

UpdateVehicleAttributesRequest

הודעה עם בקשת UpdateVehicleAttributes.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
name

string

חובה. חייב להיות בפורמט providers/{provider}/vehicles/{vehicle}. הספק חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
attributes[]

VehicleAttribute

חובה. מאפייני הרכב שצריך לעדכן. לא מבצעים שינויים במאפיינים שלא צוינו או מסירים אותם.

UpdateVehicleAttributesResponse

הודעת תגובה אחת (UpdateVehicleAttributes).

שדות
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

הודעת הבקשה UpdateVehicle.

שדות
header

RequestHeader

כותרת הבקשה הרגילה של Fleet Engine.
name

string

חובה. חייב להיות בפורמט providers/{provider}/vehicles/{vehicle}. הספק {provider} חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.
vehicle

Vehicle

חובה. ערכי הישות Vehicle שצריך להחיל. כשמעדכנים Vehicle, ייתכן שהשדות הבאים לא יעודכנו כי הם מנוהלים על ידי השרת.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

אם מעדכנים את השדה attributes, כל מאפייני הרכב מוחלפים במאפיינים שצוינו בבקשה. אם רוצים לעדכן רק חלק מהמאפיינים, אפשר לעיין בשיטה UpdateVehicleAttributes.

בדומה לכך, אפשר לעדכן את השדה waypoints, אבל עליו לכלול את כל ציוני הדרך שנמצאים כרגע ברכב, ולא ציוני דרך אחרים.
update_mask

FieldMask

חובה. מסיכת שדות שמציינת אילו שדות ב-Vehicle צריך לעדכן. יש לספק שם שדה אחד לפחות.

כלי רכב

מטא-נתונים של הרכב.

שדות
name

string

פלט בלבד. השם הייחודי של הרכב הזה. הפורמט הוא providers/{provider}/vehicles/{vehicle}.
vehicle_state

VehicleState

מצב הרכב.
supported_trip_types[]

TripType

סוגי הנסיעות שנתמכים ברכב הזה.
current_trips[]

string

פלט בלבד. רשימת אפליקציות של trip_id לנסיעות שמוקצות כרגע לרכב הזה.
last_location

VehicleLocation

המיקום המדווח האחרון של הרכב.
maximum_capacity

int32

מספר הנוסעים הכולל ברכב הזה. הנהג לא נלקח בחשבון בערך הזה. הערך הזה חייב להיות גדול מ-1 או שווה לו.
attributes[]

VehicleAttribute

רשימת מאפיינים של רכבים. לרכב אפשר להזין עד 100 מאפיינים, ולכל מאפיין צריך להיות מפתח ייחודי.
vehicle_type

VehicleType

חובה. סוג הרכב הזה. אפשר להשתמש באפשרות הזו לסינון רכבים בתוצאות של SearchVehicles. משפיע גם על זמן ההגעה המשוער ועל חישוב המסלולים.
license_plate

LicensePlate

פרטי לוחית הרישוי של הרכב.
route[]
(deprecated)

TerminalLocation

הוצא משימוש: במקומו צריך להשתמש ברכיב Vehicle.waypoints.
current_route_segment

string

הקו הפוליגוני שמציין את המסלול שאפליקציית הנהג מתכוונת לעבור אל ציון הדרך הבא. הרשימה הזו מוחזרת גם בTrip.current_route_segment לכל הנסיעות הפעילות שמוקצות לרכב.

הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK. עדיין אין תמיכה בפענוח קוד.
current_route_segment_traffic

TrafficPolylineData

קלט בלבד. המידע הזה משמש את Fleet Engine כדי לשפר את שיתוף הנסיעות. הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK.
current_route_segment_version

Timestamp

פלט בלבד. השעה שבה הוגדר current_route_segment. הלקוח יכול לאחסן אותו ולהעביר אותו בבקשות עתידיות של GetVehicle כדי למנוע מסלולים חוזרים שלא השתנו.
current_route_segment_end_point

TripWaypoint

ציון הדרך שבו מסתיים current_route_segment. מידע זה יכול להיות מסופק על ידי נהגים בשיחות UpdateVehicle כציון דרך מלא, כציון דרך LatLng או כLatLng האחרון בcurrent_route_segment. לאחר מכן, Fleet Engine יעשה כמיטב יכולתו כדי לבצע אינטרפולציה לציון דרך ממשית, אם הוא לא צוין במלואו. המערכת מתעלמת מהשדה הזה בקריאות UpdateVehicle, אלא אם צוין גם current_route_segment.
remaining_distance_meters

Int32Value

מרחק הנסיעה שנותר עבור current_route_segment. הערך הזה מוחזר גם בTrip.remaining_distance_meters לכל הנסיעות הפעילות שמוקצות לרכב. הערך לא צוין אם השדה current_route_segment ריק.
eta_to_first_waypoint

Timestamp

זמן ההגעה המשוער לרשומה הראשונה בשדה waypoints. הערך לא צוין אם השדה waypoints ריק או שהשדה Vehicle.current_route_segment ריק.

כשמעדכנים רכב, remaining_time_seconds מקבל עדיפות על פני eta_to_first_waypoint באותה בקשה.
remaining_time_seconds

Int32Value

קלט בלבד. זמן הנסיעה שנותר ל-current_route_segment. הערך לא צוין אם השדה waypoints ריק או שהשדה Vehicle.current_route_segment ריק. הערך צריך להתאים ל-eta_to_first_waypoint - current_time אם כל הצדדים משתמשים באותו שעון.

כשמעדכנים רכב, remaining_time_seconds מקבל עדיפות על פני eta_to_first_waypoint באותה בקשה.
waypoints[]

TripWaypoint

שאר נקודות הדרך שהוקצו לרכב הזה.
waypoints_version

Timestamp

פלט בלבד. הפעם האחרונה שהשדה waypoints עודכן. הלקוחות צריכים לשמור את הערך הזה במטמון ולהעביר אותו ב-GetVehicleRequest כדי להבטיח שהשדה waypoints יוחזר רק אם הוא מעודכן.
back_to_back_enabled

bool

השדה הזה מציין אם הנהג/ת מאשר/ת נסיעות הלוך ושוב. אם true, SearchVehicles עשוי לכלול את הרכב, גם אם הוא מוקצה כרגע לנסיעה. ערך ברירת המחדל הוא false.
navigation_status

NavigationStatus

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

DeviceSettings

קלט בלבד. מידע על ההגדרות במכשיר הנייד שמשמש את הנהג/ת.

VehicleType

סוג הרכב.

שדות
category

Category

קטגוריית סוג הרכב

קטגוריה

קטגוריות של סוגי כלי רכב

טיפוסים בני מנייה (enum)
UNKNOWN ברירת מחדל, משמשת לקטגוריות רכב שלא צוינו או לא מזוהות.
AUTO מכונית.
TAXI כל כלי רכב שמשמש כמונית (בדרך כלל ברישיון או בפיקוח).
TRUCK באופן כללי, רכב עם נפח אחסון גדול.
TWO_WHEELER אופנוע, קטנוע או כלי רכב דו-גלגלי אחר
BICYCLE שינוע בני אדם.
PEDESTRIAN כלי רכב בני אדם, שבדרך כלל הולכים או רצים, נעשים לאורך שבילים להולכי רגל.

VehicleAttribute

מיועד לתיאור מאפיין רכב כצמד מפתח/ערך. העמודה "key:value" המחרוזת יכולה להיות באורך של עד 256 תווים.

שדות
key

string

המַּפתח של המאפיין. אסור שמפתחות יכילו את תו הנקודתיים (:).
value

string

ערך המאפיין.
שדה איחוד vehicle_attribute_value. ערך המאפיין יכול להיות מחרוזת, בוליאני או סוג כפול. vehicle_attribute_value יכול להיות רק אחת מהאפשרויות הבאות:
string_value

string

ערך מאפיין שהוקלד במחרוזת.

הערה: השדה הזה זהה לשדה value, שבסופו של דבר יצא משימוש. כדי ליצור או לעדכן שיטות, אפשר להשתמש בכל אחד מהשדות, אבל מומלץ מאוד להשתמש ב-string_value. אם גם string_value וגם value מוגדרים, הם צריכים להיות זהים אחרת תישלח הודעת שגיאה. שני השדות מאוכלסים בתשובות.
bool_value

bool

ערך מאפיין בוליאני.
number_value

double

ערך המאפיין הוקלד פעמיים.

VehicleAttributeList

סוג נתונים של רשימת רשימות למאפייני רכב.

שדות
attributes[]

VehicleAttribute

רשימת מאפיינים באוסף הזה.

VehicleLocation

המיקום, המהירות והכיוון של רכב בנקודת זמן מסוימת.

שדות
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

LocationSensor

ספק של נתוני מיקום (לדוגמה, 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

LocationSensor

המקור של המיקום הגולמי. ברירת המחדל היא GPS.
raw_location_accuracy

DoubleValue

דיוק של raw_location כרדיוס, במטרים.
supplemental_location

LatLng

מיקום נוסף שסופק על ידי האפליקציה המשולבת.
supplemental_location_time

Timestamp

חותמת הזמן שמשויכת למיקום המשלים.
supplemental_location_sensor

LocationSensor

המקור של המיקום המשלים. ברירת המחדל היא CUSTOMER_SUPPLIED_LOCATION.
supplemental_location_accuracy

DoubleValue

דיוק של supplemental_location כרדיוס, במטרים.
road_snapped
(deprecated)

bool

הוצא משימוש: במקומו צריך להשתמש ברכיב is_road_snapped.

VehicleMatch

מכילה את הרכב ואומדנים קשורים לרכב שתואמים לנקודות הנסיעות הפעילות של הרכב SearchVehiclesRequest.

שדות
vehicle

Vehicle

חובה. רכב שתואם לבקשה.
vehicle_pickup_eta

Timestamp

זמן ההגעה המשוער של הרכב לנקודת האיסוף שצוינה בבקשה. ערך ריק מציין כשל בחישוב זמן ההגעה המשוער לרכב. אם בתאריך SearchVehiclesRequest.include_back_to_back היה true וברכב הזה יש נסיעה פעילה, vehicle_pickup_eta יכלול את הזמן שנדרש להשלמת הנסיעה הפעילה הנוכחית.
vehicle_pickup_distance_meters

Int32Value

המרחק מהמיקום הנוכחי של הרכב לנקודת האיסוף שצוינה בבקשה, כולל נקודות ביניים לאיסוף או הורדה בנסיעות קיימות. המרחק הזה כולל את מרחק הנסיעה (המסלול) המחושב ואת מרחק הקו הישר בין נקודת היעד של הניווט לבין נקודת האיסוף המבוקשת. (בדרך כלל המרחק בין נקודת היעד של הניווט לנקודת האיסוף המבוקשת קטן). ערך ריק מציין שגיאה בחישוב המרחק.
vehicle_pickup_straight_line_distance_meters

Int32Value

חובה. המרחק של הקו הישר בין הרכב לנקודת האיסוף שצוינה בבקשה.
vehicle_dropoff_eta

Timestamp

זמן ההגעה המשוער המלא של הרכב לנקודת האיסוף שצוינה בבקשה. זמן ההגעה המשוער כולל עצירה בכל נקודות ציון לפני ה-dropoff_point שצוין בבקשה. הערך יאוכלס רק כשמצוינת נקודת הורדה בבקשה. ערך ריק מציין שגיאה בחישוב זמן ההגעה המשוער.
vehicle_pickup_to_dropoff_distance_meters

Int32Value

מרחק הנסיעה של הרכב (במטרים) מנקודת האיסוף אל נקודת ההורדה שצוינה בבקשה. המרחק הוא רק בין שתי הנקודות, והוא לא כולל את מיקום הרכב או נקודות אחרות שצריך לבקר בהן לפני שהרכב מגיע לנקודת האיסוף או לנקודת ההורדה. הערך יאוכלס רק כשיצוין dropoff_point בבקשה. ערך ריק מציין אי-כשל בחישוב המרחק מנקודת האיסוף לנקודת ההורדה שצוינה בבקשה.
trip_type

TripType

חובה. סוג הנסיעה של הבקשה ששימשה לחישוב זמן ההגעה המשוער לנקודת האיסוף.
vehicle_trips_waypoints[]

Waypoint

רשימה ממוינת של ציוני דרך שמשמשת לחישוב זמן ההגעה המשוער. הרשימה כוללת את מיקום הרכב, את נקודות האיסוף של הנסיעות הפעילות של הרכב ואת נקודות האיסוף שצוינו בבקשה. רשימה ריקה מציינת כשל בחישוב זמן ההגעה המשוער לרכב.
vehicle_match_type

VehicleMatchType

סוג ההתאמה של הרכב.
requested_ordered_by

VehicleMatchOrder

ההזמנה נשלחה למיון התאמות לרכבים.
ordered_by

VehicleMatchOrder

ההזמנה בפועל שבה נעשה שימוש ברכב הזה. בדרך כלל הערך הזה יתאים ל-'order_by' שדה מהבקשה; עם זאת, בנסיבות מסוימות כגון שגיאה פנימית בחיבור לשרת, ניתן להשתמש בשיטה אחרת (למשל PICKUP_POINT_STRAIGHT_DISTANCE).

VehicleMatchType

סוג ההתאמה של הרכב.

טיפוסים בני מנייה (enum)
UNKNOWN סוג ההתאמה של הרכב לא ידוע
EXCLUSIVE לא הוקצתה נסיעה לרכב כרגע, והוא יכול להמשיך אל נקודת האיסוף.
BACK_TO_BACK הרכב מוקצה כרגע לנסיעה, אבל יכול להמשיך אל נקודת האיסוף אחרי השלמת הנסיעה פעילה. זמן ההגעה המשוער וחישובי המרחק מביאים בחשבון את הנסיעה הקיימת.
CARPOOL יש ברכב מספיק קיבולת לנסיעה משותפת.
CARPOOL_BACK_TO_BACK הרכב יסיים את הנסיעה הפעילה הנוכחית לפני שימשיך לנקודת האיסוף. זמן ההגעה המשוער וחישובי המרחק מביאים בחשבון את הנסיעה הקיימת.

VehicleState

המדינה של Vehicle.

טיפוסים בני מנייה (enum)
UNKNOWN_VEHICLE_STATE ברירת מחדל, משמשת למצבים של רכבים שלא צוינו או לא מזוהים.
OFFLINE לא ניתן לאשר נסיעות חדשות ברכב. הערה: יכול להיות שהרכב ימשיך לפעול במצב הזה במהלך נסיעה שהוקצתה לו.
ONLINE ניתן לאשר נסיעות חדשות ברכב.

VisualTrafficReportPolylineRendering

מתאר כיצד לקוחות צריכים לצבוע חלק אחד מהקו הפוליגוני לאורך הנתיב.

שדות
road_stretch[]

RoadStretch

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

בהיעדר קטע דרך לסגנון, הלקוח צריך להחיל את ברירת המחדל של המסלול.

RoadStretch

קטע דרך אחד שאמור להיות רינדור.

שדות
style

Style

חובה. הסגנון שצריך להחיל.
offset_meters

int32

חובה. צריך להחיל את הסגנון בין התאריכים [offset_meters, offset_meters + length_meters).
length_meters

int32

חובה. אורך הנתיב שבו צריך להחיל את הסגנון.

סגנון

סגנון התנועה, שמציין את מהירות התנועה.

טיפוסים בני מנייה (enum)
STYLE_UNSPECIFIED לא נבחר סגנון.
SLOWER_TRAFFIC התנועה מאטה.
TRAFFIC_JAM יש פקק תנועה.

נקודת ציון

מתארת את נקודות הביניים במסלול של VehicleMatch בSearchVehiclesResponse. הקונספט הזה מיוצג בתור TripWaypoint בכל נקודות הקצה האחרות.

שדות
lat_lng

LatLng

המיקום של ציון הדרך הזה.
eta

Timestamp

הזמן המשוער שבו הרכב יגיע לנקודת הציון הזו.

WaypointType

סוג ציון הדרך.

טיפוסים בני מנייה (enum)
UNKNOWN_WAYPOINT_TYPE סוג ציון הדרך לא ידוע או לא מוגדר.
PICKUP_WAYPOINT_TYPE ציוני דרך לאיסוף נוסעים או פריטים.
DROP_OFF_WAYPOINT_TYPE ציוני דרך להורדת נוסעים או פריטים.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE ציוני דרך ליעדי ביניים בנסיעה עם כמה יעדים.