Package maps.fleetengine.v1

אינדקס

TripService

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

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

יצירת נסיעה ב-Flet 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)

מחזיר רכב ממנוע ה-Flet.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

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

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

הוצא משימוש: יש להשתמש במקום זאת ב-SearchVehicles.
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

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

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

BillingPlatformIdentifier

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
UNKNOWN_LOCATION_POWER_SAVE_MODE מיקום PowerSaveMode לא מוגדר
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 המיקום לא יושבת, אבל LocationManager יווסת את כל הבקשות לספקים כשהמכשיר לא אינטראקטיבי.

LocationSensor

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

טיפוסים בני מנייה (enums)
UNKNOWN_SENSOR החיישן לא צוין או לא ידוע.
GPS GPS או 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.

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

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

PolylineFormatType

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

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

PowerSource

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

טיפוסים בני מנייה (enums)
UNKNOWN_POWER_SOURCE מקור הכוח לא ידוע.
POWER_SOURCE_AC מקור הכוח הוא מטען 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

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

BillingPlatformIdentifier

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

string

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

SolutionType

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

SolutionType

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

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

RequestHeader

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

שדות
language_code

string

קוד השפה BCP-47, למשל en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. אם לא מציינים אף שפה, התשובה יכולה להיות בכל שפה, עם עדיפות לאנגלית, אם קיים. דוגמה לערך בשדה: en-US.
region_code

string

חובה. קוד האזור במאגר CLDR של האזור שבו נשלחה הבקשה. דוגמה לערך בשדה: US.
sdk_version

string

גרסת ה-SDK לשיחות, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: 1.1.2.
os_version

string

גרסת מערכת ההפעלה שבה פועל ה-SDK לשיחות. דוגמאות לערכי שדה: 4.4.1, 12.1.
device_model

string

דגם המכשיר שבו פועל ה-SDK לשיחות. דוגמאות לערכי שדה: iPhone12,1, SM-G920F.
sdk_type

SdkType

סוג ה-SDK ששולח את הבקשה.
maps_sdk_version

string

גרסת MapSDK שה-SDK להתקשרות תלוי בה, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: 5.2.1.
nav_sdk_version

string

גרסת ה-NavSDK שעליה תלוי ה-SDK לשיחות, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: 2.1.0.
platform

Platform

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

string

היצרן של מכשיר Android מה-SDK לשיחות. רלוונטי רק לערכות ה-SDK ל-Android. דוגמה לערך בשדה: Samsung.
android_api_level

int32

רמת ה-API של Android של ה-SDK לשיחות. רלוונטית רק לערכות ה-SDK ל-Android. דוגמה לערך בשדה: 23.
trace_id

string

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

פלטפורמה

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

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

SdkType

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

טיפוסים בני מנייה (enums)
SDK_TYPE_UNSPECIFIED ערך ברירת המחדל. נעשה שימוש בערך הזה אם לא מזינים את הערך sdk_type.
CONSUMER ה-SDK לשיחות הוא 'צרכן'.
DRIVER ה-SDK לשיחות הוא Driver.
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

מגביל את החיפוש רק לכלי הרכב ששלחו עדכוני מיקום ל-Feet Engine במהלך פרק הזמן שצוין. רכבים נייחים שעדיין משדרים את המיקומים שלהם לא נחשבים למיושנים. אם שדה זה לא מוגדר, השרת ישתמש בחמש דקות כערך ברירת המחדל.
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_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 ופעולת ניתוק/OR כוללת באוסף של 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

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

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

VehicleMatchOrder

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

טיפוסים בני מנייה (enums)
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

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

מהירות

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

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

StopLocation

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

שדות
point

LatLng

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

Timestamp

מציין מתי העצירה התרחשה.
stop_time
(deprecated)

Timestamp

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

TerminalLocation

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

שדות
point

LatLng

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

TerminalPointId

המזהה של נקודת הטרמינל.
access_point_id
(deprecated)

string

הוּצא משימוש.
trip_id
(deprecated)

string

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

WaypointType

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

TerminalPointId

מאפשרת לזהות נקודה סופית.

שדות
value

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 של הרכב למקטע current_route_segment. הערך False אם last_location או current_route_segment לא קיימים. הוא מחושב על ידי Fleet Engine. המערכת תתעלם מעדכונים מלקוחות.
view

TripView

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

TripStatus

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

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

TripType

סוג הנסיעה.

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

TripView

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

טיפוסים בני מנייה (enums)
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

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

קטגוריה

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

טיפוסים בני מנייה (enums)
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

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

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

VehicleState

המצב של Vehicle.

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

VisualTrafficReportPolylineRendering

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

שדות
road_stretch[]

RoadStretch

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

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

RoadStretch

קטע דרך אחד שצריך להציג.

שדות
style

Style

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

int32

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

int32

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

סגנון

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

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

נקודת ציון

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

שדות
lat_lng

LatLng

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

Timestamp

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

WaypointType

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

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