Package maps.fleetengine.v1

אינדקס

TripService

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

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

rpc DeleteTrip(DeleteTripRequest) returns (Empty)

מחיקת נסיעה אחת.

הפונקציה מחזירה את הערך FAILED_PRECONDITION אם הנסיעה פעילה ומשויכת לרכב.
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

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

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

מחיקת רכב מ-Fleet Engine.

הפונקציה מחזירה FAILED_PRECONDITION אם לרכב יש נסיעות פעילות שמשויכות אליו.
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

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

שדות
header

RequestHeader

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

string

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

string

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

  • הערך חייב להיות מחרוזת Unicode חוקית.
  • האורך המקסימלי הוא 64 תווים.
  • מנורמלים לפי Unicode Normalization Form 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 Normalization Form 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

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

DeleteTripRequest

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

שדות
header

RequestHeader

אופציונלי. כותרת הבקשה הרגילה של Fleet Engine.
name

string

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

DeleteVehicleRequest

מחיקת הודעת בקשה של כלי רכב.

שדות
header

RequestHeader

אופציונלי. כותרת הבקשה הרגילה של Fleet Engine.
name

string

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

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
(deprecated)

Timestamp

הוצא משימוש: תמיד מתבצעת אחזור של Trip.remaining_waypoints. משתמשים ב-remaining_waypoints_route_version כדי לקבוע מתי יאוחזרו נתונים של Trip.remaining_waypoints.traffic_to_waypoint ושל Trip.remaining_waypoints.path_to_waypoint.
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 או שווה ל-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 מאפיינים נדרשים. זהו המספר המקסימלי של מאפיינים שמותר להוסיף לרכב. כל מחרוזת חוזרת צריכה להיות בפורמט 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())

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

LocationSensor

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

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

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

טיפוסים בני מנייה (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 מקור המתח הוא מטען 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

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

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

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

Platform

הפלטפורמה של ה-SDK שקורא.
manufacturer

string

יצרן מכשיר Android מתוך ה-SDK של השיחות, רלוונטי רק לערכות Android SDK. דוגמה לערך של שדה: 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 לשיחות הוא Consumer.
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

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

VehicleType

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

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

מציין את המיקום המדויק LatLng של ציון הדרך. צריך לציין את point או את place כקלט. אם מציינים את שניהם, המערכת משתמשת ב-point לניתוב וב-place למטא-נתונים. אם רק place מצוין כקלט, המערכת תחשב את point מתוך place ותכלול אותו בפלט.
place

string

שם המשאב של המקום שמייצג את המיקום הזה. הפורמט הוא places/{place_id}. צריך לציין את point או את place כקלט. אם מציינים את שניהם, המערכת משתמשת ב-point לניתוב וב-place למטא-נתונים. הערך place נכלל בפלט רק אם הוא נכלל בקלט, כלומר לא מתבצע חיפוש של place מתוך LatLng.

זוהי תכונה ניסיונית.
point_location_source

PointSource

פלט בלבד. המקור של השדה point.
terminal_point_id
(deprecated)

TerminalPointId

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

string

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

string

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

WaypointType

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

PointSource

מציין את המקור של הערך LatLng.

טיפוסים בני מנייה (enum)
POINT_SOURCE_UNSPECIFIED לא צוין מקור נקודתי.
POINT_SOURCE_DEVELOPER_PROVIDED המידע על LatLng סופק במפורש על ידי המפתח.
POINT_SOURCE_CALCULATED_FROM_PLACE המרחק LatLng חושב מהמקום שצוין.

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

פלט בלבד. המסלול הצפוי לנסיעה הזו עד לנקודת הכניסה הראשונה ב-remaining_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

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

TripAttribute

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

TripAttribute

מתאר מאפיין של נסיעה כצמד מפתח/ערך. האורך של המחרוזת 'מפתח:ערך' לא יכול להיות יותר מ-256 תווים.

שדות
key

string

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

string

ערך מאפיין מסוג מחרוזת.
bool_value

bool

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

double

ערך המאפיין מסוג double.

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

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

שדות
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 passed צריך להיות זהה לגרסה של 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 request message.

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

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

VehicleLocation

קלט בלבד. מיקומים שבהם הרכב הזה היה בעבר, ושעדיין לא דווחו ל-Fleet Engine. המידע הזה משמש ב-UpdateVehicleRequest לרישום מיקומים שלא ניתן היה לשלוח לשרת בעבר. בדרך כלל זה קורה כשהרכב לא מחובר לאינטרנט.
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

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

שדות
key

string

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

string

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

string

ערך מאפיין מסוג מחרוזת.

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

bool

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

double

ערך המאפיין מסוג 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

מיקום גולמי של כלי רכב (לא עבר עיבוד על ידי road-snapper).
raw_location_time

Timestamp

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

LocationSensor

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

DoubleValue

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

LatLng

המיקום מספק המיקום המשולב של Android.
flp_update_time

Timestamp

עדכון חותמת הזמן של flp_location
flp_latlng_accuracy_meters

DoubleValue

רמת הדיוק של flp_location במטרים כרדיוס.
flp_heading_degrees

Int32Value

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

VehicleMatchOrder

הסדר המבוקש למיון התאמות של כלי רכב. שווה ערך ל-requested_ordered_by.

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 נקודות עצירה ליעדים ביניים בנסיעה עם כמה יעדים.