אינדקס
TripService
(ממשק)VehicleService
(ממשק)BatteryInfo
(הודעה)BatteryStatus
(טיפוס enum)BillingPlatformIdentifier
(טיפוס enum)ConsumableTrafficPolyline
(הודעה)CreateTripRequest
(הודעה)CreateVehicleRequest
(הודעה)DeviceSettings
(הודעה)GetTripRequest
(הודעה)GetVehicleRequest
(הודעה)LicensePlate
(הודעה)ListVehiclesRequest
(הודעה)ListVehiclesResponse
(הודעה)LocationPowerSaveMode
(טיפוס enum)LocationSensor
(טיפוס enum)NavigationStatus
(טיפוס enum)PolylineFormatType
(טיפוס enum)PowerSource
(טיפוס enum)ReportBillableTripRequest
(הודעה)ReportBillableTripRequest.SolutionType
(טיפוס enum)RequestHeader
(הודעה)RequestHeader.Platform
(טיפוס enum)RequestHeader.SdkType
(טיפוס enum)SearchTripsRequest
(הודעה)SearchTripsResponse
(הודעה)SearchVehiclesRequest
(הודעה)SearchVehiclesRequest.CurrentTripsPresent
(טיפוס enum)SearchVehiclesRequest.VehicleMatchOrder
(טיפוס enum)SearchVehiclesResponse
(הודעה)SpeedReadingInterval
(הודעה)SpeedReadingInterval.Speed
(טיפוס enum)StopLocation
(הודעה)TerminalLocation
(הודעה)TerminalPointId
(הודעה) (הוצאה משימוש)TrafficPolylineData
(הודעה)Trip
(הודעה)TripStatus
(טיפוס enum)TripType
(טיפוס enum)TripView
(טיפוס enum)TripWaypoint
(הודעה)UpdateTripRequest
(הודעה)UpdateVehicleAttributesRequest
(הודעה)UpdateVehicleAttributesResponse
(הודעה)UpdateVehicleRequest
(הודעה)Vehicle
(הודעה)Vehicle.VehicleType
(הודעה)Vehicle.VehicleType.Category
(טיפוס enum)VehicleAttribute
(הודעה)VehicleAttributeList
(הודעה)VehicleLocation
(הודעה)VehicleMatch
(הודעה)VehicleMatch.VehicleMatchType
(טיפוס enum)VehicleState
(טיפוס enum)VisualTrafficReportPolylineRendering
(הודעה)VisualTrafficReportPolylineRendering.RoadStretch
(הודעה)VisualTrafficReportPolylineRendering.RoadStretch.Style
(טיפוס enum)Waypoint
(הודעה)WaypointType
(טיפוס enum)
TripService
שירות לניהול נסיעות.
CreateTrip |
---|
יצירת נסיעה ב-Fleet Engine ומחזירה את הנסיעה החדשה. |
GetTrip |
---|
קבלת מידע על נסיעה יחידה. |
ReportBillableTrip |
---|
דיווח על שימוש בתשלום בנסיעה. |
SearchTrips |
---|
הצגת כל הנסיעות ברכב מסוים. |
UpdateTrip |
---|
נתוני הנסיעה מתעדכנים. |
VehicleService
שירות ניהול רכב.
CreateVehicle |
---|
יוצרים כלי רכב חדש שמשויך לספקי משלוחים או נסיעות על פי דרישה. לכל כשיוצרים
כשיוצרים
כל שאר השדות הם אופציונליים ונעשה בהם שימוש אם סופקו. |
GetVehicle |
---|
מחזירה רכב מ-Fleet Engine. |
ListVehicles |
---|
הפונקציה מחזירה רשימה מקטעי של כלי רכב שמשויכים לספק שתואמים לאפשרויות הבקשה. |
SearchVehicles |
---|
הפונקציה מחזירה רשימה של כלי רכב שתואמים לאפשרויות הבקשה. |
UpdateVehicle |
---|
כתיבת נתונים מעודכנים של רכב ב-Fleet Engine. כשמעדכנים
כמו כן, לא ניתן לעדכן את הרכב אם מעדכנים את השדה |
UpdateVehicleAttributes |
---|
עדכון חלקי של מאפייני הרכב. רק המאפיינים שצוינו בבקשה יעודכנו. לא יחולו שינויים במאפיינים אחרים. הערה: המצב הזה שונה ב- |
BatteryInfo
מידע על סוללת המכשיר.
שדות | |
---|---|
battery_status |
סטטוס הסוללה, אם היא מלאה או נטענת וכו'. |
power_source |
הסטטוס של מקור החשמל. |
battery_percentage |
אחוז הסוללה הנוכחי [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[] |
מהירות התנועה לאורך הנתיב מציון הדרך הקודם עד לנקודת הציון הנוכחית. |
encoded_path_to_waypoint |
הנתיב שהנהג עובר מנקודת הציון הקודמת עד לנקודת הציון הנוכחית. הנתיב הזה כולל ציוני דרך כדי שהלקוחות יוכלו להציג סמני תנועה לאורך הנתיב (ראו |
CreateTripRequest
הודעת בקשה ל-CreateTrip.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
parent |
חובה. חייב להיות בפורמט |
trip_id |
חובה. מזהה נסיעה ייחודי. בכפוף להגבלות הבאות:
|
trip |
חובה. ישות בנסיעה כדי ליצור. כשיוצרים נסיעה, חובה למלא את השדות הבאים:
אם תציינו את השדות הבאים, הם יופיעו:
המערכת מתעלמת מכל שאר שדות הנסיעה. לדוגמה, כל הנסיעות מתחילות ב- רק נסיעות של אם מגדירים את כשמציינים את המערכת משתמשת בשדות |
CreateVehicleRequest
הודעה עם בקשת CreateVehicle
.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
parent |
חובה. חייב להיות בפורמט |
vehicle_id |
חובה. מזהה הרכב ייחודי. בכפוף להגבלות הבאות:
|
vehicle |
חובה. ישות הרכב שצריך ליצור. כשיוצרים כלי רכב, חובה למלא את השדות הבאים:
כשיוצרים כלי רכב, המערכת מתעלמת מהשדות הבאים:
כל שאר השדות הם אופציונליים ונעשה בהם שימוש אם סופקו. |
DeviceSettings
מידע על הגדרות שונות במכשיר הנייד.
שדות | |
---|---|
location_power_save_mode |
איך תכונות המיקום מוגדרות לפעול במכשיר כשמצב 'חיסכון בסוללה' פועל. |
is_power_save_mode |
האם המכשיר נמצא כרגע במצב חיסכון בסוללה. |
is_interactive |
האם המכשיר במצב אינטראקטיבי. |
battery_info |
מידע על מצב הסוללה. |
GetTripRequest
הודעת בקשה ל-GetTrip.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
name |
חובה. חייב להיות בפורמט |
view |
קבוצת המשנה של שדות הנסיעה שצריך להחזיר והפרשנות שלהם. |
current_route_segment_version |
מציינת את חותמת הזמן המינימלית (לא כולל) שלגביה אוחזרו נתונים של |
remaining_waypoints_version |
מציינת את חותמת הזמן המינימלית (לא כולל) שעבורה |
route_format_type |
פורמט המסלול הנוכחי שהוחזר, |
current_route_segment_traffic_version |
מציינת את חותמת הזמן המינימלית (לא כולל) שעבורה |
remaining_waypoints_route_version |
מציינת את חותמת הזמן המינימלית (לא כולל) שלגביה אוחזרו נתונים של |
GetVehicleRequest
הודעה עם בקשת GetVehicle
.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
name |
חובה. חייב להיות בפורמט |
current_route_segment_version |
מציינת את חותמת הזמן המינימלית (לא כולל) שעבורה |
waypoints_version |
מציינת את חותמת הזמן המינימלית (לא כולל) שלגביה אוחזרו נתונים של |
LicensePlate
פרטי לוחית הרישוי של הרכב. כדי להימנע מאחסון פרטים אישיים מזהים, רק המידע המינימלי לגבי לוחית הרישוי מאוחסן כחלק מהישות.
שדות | |
---|---|
country_code |
חובה. קוד המדינה או האזור במאגר CLDR. לדוגמה, |
last_character |
הספרה האחרונה של לוחית הרישוי או '1-' כדי לציין שלוחית הרישוי לא מכילה ערך מספרי.
|
ListVehiclesRequest
הודעה עם בקשת ListVehicles
.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
parent |
חובה. חייב להיות בפורמט |
page_size |
המספר המקסימלי של כלי רכב שצריך להחזיר. ערך ברירת המחדל: 100. |
page_token |
הערך של ה |
minimum_capacity |
מציינת את הקיבולת המינימלית הנדרשת של הרכב. הערך של כל כלי הרכב שמוחזרים יהיה |
trip_types[] |
הגבלת התגובה לכלי רכב שתומכים לפחות באחד מסוגי הנסיעה שצוינו. |
maximum_staleness |
הגבלת התגובה לכלי רכב ששלחו עדכוני מיקום ל-Fleet Engine בטווח הזמן שצוין. כלי רכב נייחים שעדיין משדרים את מיקומם לא נחשבים למיושנים. אם השדה הזה קיים, הוא צריך להיות משך זמן תקין תקין. |
vehicle_type_categories[] |
חובה. מגבילה את התגובה לכלי רכב עם אחת מקטגוריות הסוגים שצוינו. לא ניתן להפר את המדיניות: |
required_attributes[] |
מתקשרים יכולים ליצור פעולות לוגיות מורכבות באמצעות כל שילוב של השדות
המדיניות מגבילה את התגובה לכלי רכב עם המאפיינים שצוינו. השדה הזה הוא פעולת חיבור/AND. אפשר להוסיף עד 50 מאפייני required_attribute. הערך הזה תואם למספר המאפיינים המקסימלי שמותר לכלול ברכב. כל מחרוזת חוזרת צריכה להיות בפורמט "key:value". |
required_one_of_attributes[] |
הגבלת התגובה לכלי רכב עם לפחות אחד מהמאפיינים שצוינו בכל |
required_one_of_attribute_sets[] |
האפליקציה בדומה ל-
המדיניות מגבילה את התגובה לכלי רכב שתואמים לכל המאפיינים ב- |
vehicle_state |
הגבלת התגובה לכלי רכב עם מצב הרכב הזה. |
on_trip_only |
החזרת רכבים עם נסיעות נוכחיות בלבד. |
filter |
זה שינוי אופציונלי. שאילתת סינון שצריך להחיל כשמציגים כלי רכב. דוגמאות לתחביר של המסנן: http://aip.dev/160 השדה הזה נועד להחליף את השדות המסנן הזה פועל כתנאי AND עם אילוצים אחרים, כמו לתשומת ליבכם, השאילתות היחידות שנתמכות הן על מאפייני רכב (לדוגמה, בנוסף, כל המאפיינים מאוחסנים כמחרוזות, כך שאפשר להשוות רק בין מחרוזות לבין מאפיינים. כדי להשוות מול ערכים של מספרים או בוליאניים, יש להקיף את הערכים באופן מפורש כך שיטופלו כמחרוזות (לדוגמה, |
viewport |
זה שינוי אופציונלי. מסנן שמגביל את כלי הרכב שמוחזרים בכלי רכב שהמיקום הידוע האחרון שלהם היה באזור המלבני שהוגדר באזור התצוגה. |
ListVehiclesResponse
הודעת תגובה אחת (ListVehicles
).
שדות | |
---|---|
vehicles[] |
כלי רכב שתואמים לקריטריונים של הבקשה. המספר המקסימלי של כלי רכב שהוחזרו נקבע לפי השדה |
next_page_token |
אסימון לשחזור הדף הבא של כלי רכב, או ריק אם אין עוד רכבים שעומדים בקריטריונים של הבקשה. |
total_size |
חובה. המספר הכולל של כלי רכב שתואמים לקריטריוני הבקשה בכל הדפים. |
LocationPowerSaveMode
איך תכונות המיקום מוגדרות כך שיפעלו בנייד כשהמכשירים במצב 'חיסכון בסוללה' התכונה מופעלת. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
LocationPowerSaveMode לא מוגדר |
LOCATION_MODE_NO_CHANGE |
ספקי המיקום לא אמורים להיות מושפעים ממצב 'חיסכון בסוללה' או מ'חיסכון בסוללה'. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
יש להשבית את ספק המיקום המבוסס על GPS כשמצב חיסכון בסוללה מופעל והמכשיר לא אינטראקטיבי. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
יש להשבית את כל ספקי המיקום כשמצב 'חיסכון בסוללה' פועל כשהמכשיר לא אינטראקטיבי. |
LOCATION_MODE_FOREGROUND_ONLY |
כל ספקי המיקום ימשיכו להיות זמינים, אבל יש לספק תיקוני מיקום רק לאפליקציות שפועלות בחזית. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
האפשרות 'מיקום' לא תושבת, אבל מנהל המיקום ויסות את כל הבקשות לספקים כשהמכשיר לא אינטראקטיבי. |
LocationSensor
החיישן או המתודולוגיה ששימשו לקביעת המיקום.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_SENSOR |
החיישן לא מוגדר או לא ידוע. |
GPS |
GPS או Assist GPS. |
NETWORK |
תמיכה ב-GPS, מזהה של מגדל תקשורת או נקודת גישה ל-Wi-Fi. |
PASSIVE |
מזהה מגדל סלולרי או נקודת גישה ל-Wi-Fi. |
ROAD_SNAPPED_LOCATION_PROVIDER |
מיקום שנקבע על ידי המכשיר הנייד הוא המיקום הטוב ביותר בכביש. |
CUSTOMER_SUPPLIED_LOCATION |
מיקום שמסופק על ידי הלקוח ממקור בלתי תלוי. בדרך כלל, הערך הזה משמש למיקום שסופק ממקורות שאינם המכשיר הנייד שבו פועל Driver SDK. אם המקור המקורי מתואר על ידי אחד מערכי ה-enum האחרים, משתמשים בערך הזה. מיקומים שמסומנים כ-CUSTOMER_SUPPLIED_LOCATION מסופקים בדרך כלל דרך last_location.supplemental_location_sensor של רכב. |
FLEET_ENGINE_LOCATION |
המיקום מחושב על ידי Fleet Engine על סמך האותות שזמינים לו. פלט בלבד. הערך הזה יידחה אם הוא יתקבל בבקשה. |
FUSED_LOCATION_PROVIDER |
ספק המיקום המשולב של Android. |
CORE_LOCATION |
ספק המיקום במערכות ההפעלה של Apple. |
PolylineFormatType
סוג הפורמט של קו פוליגוני.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_FORMAT_TYPE |
הפורמט לא צוין או שהוא לא ידוע. |
LAT_LNG_LIST_TYPE |
רשימה של google.type.LatLng . |
ENCODED_POLYLINE_TYPE |
קו פוליגוני שמקודד באמצעות אלגוריתם לדחיסת קו פוליגוני. עדיין אין תמיכה בפענוח קוד. |
PowerSource
סוג המטען שמשמש לטעינת הסוללה.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_POWER_SOURCE |
מקור החשמל לא ידוע. |
POWER_SOURCE_AC |
מקור החשמל הוא מטען לחשמל. |
POWER_SOURCE_USB |
מקור החשמל הוא יציאת USB. |
POWER_SOURCE_WIRELESS |
מקור החשמל הוא אלחוטי. |
POWER_SOURCE_UNPLUGGED |
הסוללה מנותקת. |
ReportBillableTripRequest
הודעת הבקשה ReportBillableTrip.
שדות | |
---|---|
name |
חובה. חייב להיות בפורמט |
country_code |
חובה. קוד מדינה בן 2 אותיות של המדינה שבה הנסיעה מתבצעת. המחיר מוגדר בהתאם לקוד המדינה. |
platform |
הפלטפורמה שאליה נשלחה הבקשה. |
related_ids[] |
המזהים שקשורים ישירות לנסיעה המדווחת. אלה בדרך כלל מזהים (למשל, מזהי סשנים) של פעולות הזמנה מראש שבוצעו לפני שמזהה הנסיעה יהיה זמין. מספר ה |
solution_type |
סוג הפתרון למוצר GMP (לדוגמה, |
SolutionType
בורר לסוגי פתרונות שונים של נסיעה שדווחה.
טיפוסים בני מנייה (enum) | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
ערך ברירת המחדל. לצורך תאימות לאחור, ה-API ישתמש כברירת מחדל ב-ON_DEMAND_RIDESHARING_AND_DELIVERIES , שהוא סוג הפתרון הראשון הנתמך. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
הפתרון הוא נסיעה משותפת ונסיעות על פי דרישה. |
RequestHeader
RequestHeader מכיל שדות משותפים לכל בקשות ה-RPC ב-Fleet Engine.
שדות | |
---|---|
language_code |
קוד השפה BCP-47, כמו en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. אם לא תציינו שם, התשובה יכולה להיות בכל שפה, עם העדפה לאנגלית אם קיים שם כזה. דוגמה לערך בשדה: |
region_code |
חובה. קוד האזור במאגר CLDR של האזור שממנו בוצעה הבקשה. דוגמה לערך בשדה: |
sdk_version |
גרסת ה-SDK לשיחות, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: |
os_version |
הגרסה של מערכת ההפעלה שבה פועל ה-SDK לשיחות. דוגמאות לערכים בשדות: |
device_model |
דגם המכשיר שבו פועל ה-SDK לשיחות. דוגמאות לערכים בשדות: |
sdk_type |
סוג ה-SDK ששולח את הבקשה. |
maps_sdk_version |
גרסת ה-MapSDK שבה ה-SDK של הקריאה תלוי, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: |
nav_sdk_version |
הגרסה של Nav SDK שבה ערכת ה-SDK לשיחות תלויה, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: |
platform |
הפלטפורמה של ה-SDK לשיחות. |
manufacturer |
היצרן של מכשיר Android מה-SDK לשיחות, רלוונטי רק לערכות ה-SDK של Android. דוגמה לערך בשדה: |
android_api_level |
רמת ה-API של Android של ה-SDK לשיחות, רלוונטית רק לערכות ה-SDK ל-Android. דוגמה לערך בשדה: |
trace_id |
מזהה אופציונלי שאפשר לספק למטרות רישום ביומן לצורך זיהוי הבקשה. |
פלטפורמה
הפלטפורמה של ה-SDK לשיחות.
טיפוסים בני מנייה (enum) | |
---|---|
PLATFORM_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה משמש אם הפלטפורמה לא מוצגת. |
ANDROID |
הבקשה מגיעה מ-Android. |
IOS |
הבקשה מגיעה מ-iOS. |
WEB |
הבקשה מגיעה מהאינטרנט. |
SdkType
סוגים אפשריים של SDK.
טיפוסים בני מנייה (enum) | |
---|---|
SDK_TYPE_UNSPECIFIED |
ערך ברירת המחדל. המערכת תשתמש בערך הזה אם לא מציינים את sdk_type . |
CONSUMER |
ה-SDK של הקריאה הוא צרכן. |
DRIVER |
ה-SDK לשיחות הוא של מנהל התקן. |
JAVASCRIPT |
ה-SDK ששולח הוא JavaScript. |
SearchTripsRequest
הודעת הבקשה של SearchTrips.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
parent |
חובה. חייב להיות בפורמט |
vehicle_id |
הרכב שמשויך לנסיעות בבקשה. אם לא צוין, הנסיעות שהוחזרו לא יכללו:
|
active_trips_only |
אם המדיניות מוגדרת כ-True, התגובה כוללת 'נסיעות' שמשפיעות על מסלול הנהג. |
page_size |
אם המדיניות לא מוגדרת, השרת קובע את מספר התוצאות שיוחזרו. |
page_token |
כדי להמשיך מהתוצאות הקודמות, צריך להגדיר את הערך הזה לערך שהוחזר בעבר ב- |
minimum_staleness |
אם צוינה אפשרות, המערכת תחזיר את הנסיעות שלא עודכנו אחרי השעה |
SearchTripsResponse
הודעת תגובה מ-SearchTrips.
שדות | |
---|---|
trips[] |
רשימת הנסיעות של הרכב המבוקש. |
next_page_token |
מעבירים את האסימון הזה ב-SearchTripsRequest לדף דרך תוצאות הרשימה. ה-API מחזיר רשימת נסיעות בכל שיחה, וכשלא נותרו תוצאות נוספות רשימת הנסיעות ריקה. |
SearchVehiclesRequest
הודעה עם בקשת SearchVehicles
.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
parent |
חובה. חייב להיות בפורמט |
pickup_point |
חובה. נקודת האיסוף שבה יש לחפש. |
dropoff_point |
מיקום המסירה המיועד של הלקוח. השדה הזה הוא חובה אם הערך |
pickup_radius_meters |
חובה. הגדרת הרדיוס של חיפוש הרכבים סביב נקודת האיסוף. יוחזרו רק כלי רכב שנמצאים ברדיוס החיפוש. הערך חייב להיות בין 400 ל-10,000 מטרים (כולל). |
count |
חובה. מציינת את מספר הרכבים המקסימלי שצריך להחזיר. הערך חייב להיות בין 1 ל-50 (כולל). |
minimum_capacity |
חובה. מציין את מספר הנוסעים שנכללו בנסיעה. הערך חייב להיות גדול מ-1 או שווה לו. הנהג לא נלקח בחשבון בערך הקיבולת. |
trip_types[] |
חובה. סוג הנסיעה המוצעת. חייב לכלול סוג אחד בלבד. לא ניתן להפר את המדיניות: |
maximum_staleness |
מגביל את החיפוש רק לכלי רכב ששלחו עדכוני מיקום ל-Fleet Engine במשך פרק הזמן שצוין. כלי רכב נייחים שעדיין מעבירים את מיקומם לא נחשבים למיושנים. אם השדה הזה לא מוגדר, השרת ישתמש ב-5 דקות כערך ברירת המחדל. |
vehicle_types[] |
חובה. מגביל את החיפוש לכלי רכב עם אחד מהסוגים שצוינו. יש לציין לפחות סוג רכב אחד. אסור לפרסם סוגי רכב עם קטגוריה של |
required_attributes[] |
מתקשרים יכולים ליצור פעולות לוגיות מורכבות באמצעות כל שילוב של השדות
מגביל את החיפוש רק לרכבים עם המאפיינים שצוינו. השדה הזה הוא פעולת חיבור/AND. אפשר להוסיף עד 50 מאפייני required_attribute. הערך הזה תואם למספר המאפיינים המקסימלי שמותר לכלול ברכב. |
required_one_of_attributes[] |
מגביל את החיפוש רק לרכבים עם לפחות אחד מהמאפיינים שצוינו בכל |
required_one_of_attribute_sets[] |
האפליקציה בדומה ל-
מגביל את החיפוש רק לרכבים עם כל המאפיינים ב |
order_by |
חובה. מציינת את הקריטריון הרצוי לסדר התוצאות. |
include_back_to_back |
האפשרות הזו מציינת אם כלי רכב עם נסיעה פעילה אחת עומדים בדרישות לחיפוש הזה. השדה הזה משמש רק אם לא צוין ערך ברירת המחדל הוא |
trip_id |
מציין את הנסיעה שמשויכת ל |
current_trips_present |
האפשרות מציינת אם כלי רכב עם נסיעות פעילות עומדים בדרישות לחיפוש הזה. הערך הזה צריך להיות מוגדר לערך שאינו |
filter |
זה שינוי אופציונלי. שאילתת סינון שצריך להחיל כשמחפשים כלי רכב. דוגמאות לתחביר של המסנן: http://aip.dev/160 השדה הזה נועד להחליף את השדות המסנן הזה פועל כתנאי AND עם אילוצים אחרים, כמו לתשומת ליבכם, השאילתות היחידות שנתמכות הן על מאפייני רכב (לדוגמה, בנוסף, כל המאפיינים מאוחסנים כמחרוזות, כך שאפשר להשוות רק בין מחרוזות לבין מאפיינים. כדי להשוות מול ערכים של מספרים או בוליאניים, יש להקיף את הערכים באופן מפורש כך שיטופלו כמחרוזות (לדוגמה, |
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[] |
רשימת רכבים שתואמים לקריטריונים של |
SpeedReadingInterval
אינדיקטור של צפיפות התנועה בקטע רציף של נתיב. בהינתן נתיב עם נקודות P_0, P_1, ... , P_N (אינדקס מבוסס אפס), ה- SpeedReadingInterval מגדיר מרווח ומתאר את התנועה באמצעות הקטגוריות הבאות.
שדות | |
---|---|
start_polyline_point_index |
האינדקס ההתחלתי של המרווח הזה בנתיב. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס. |
end_polyline_point_index |
האינדקס האחרון של המרווח הזה בנתיב. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס. |
speed |
מהירות התנועה במרווח הזה. |
מהירות
סיווג מהירות של קו פוליגוני על סמך נתוני תנועה.
טיפוסים בני מנייה (enum) | |
---|---|
SPEED_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
NORMAL |
מהירות רגילה, לא מזוהה האטה. |
SLOW |
זוהתה האטה, אבל לא נוצר עומס תנועה. |
TRAFFIC_JAM |
זוהה עומס תנועה. |
StopLocation
המיקום בפועל שבו התרחשה העצירה (איסוף/הורדה).
שדות | |
---|---|
point |
חובה. מציינת את המיקום בפועל. |
timestamp |
מציין מתי הופסקה העצירה. |
stop_time |
קלט בלבד. הוצא משימוש. משתמשים בשדה של חותמת הזמן. |
TerminalLocation
מתאר את המיקום של ציון דרך.
שדות | |
---|---|
point |
חובה. מציין את המיקום של ציון דרך בנסיעה. |
terminal_point_id |
הוצא משימוש: צריך לציין במקום זאת את השדה |
access_point_id |
הוצא משימוש: צריך לציין במקום זאת את השדה |
trip_id |
הוצא משימוש. |
terminal_location_type |
הוצא משימוש: ל- |
TerminalPointId
הוצא משימוש: אין יותר תמיכה ב-TerminalPoints ב-Fleet Engine. במקום זאת, אתם צריכים להשתמש ב-TerminalLocation.point
.
שדות | |
---|---|
value |
הוצא משימוש. |
שדה איחוד Id . הוצא משימוש. Id יכול להיות רק אחת מהאפשרויות הבאות: |
|
place_id |
הוצא משימוש. |
generated_id |
הוצא משימוש. |
TrafficPolylineData
מצב התנועה לאורך מסלול הרכב הצפוי.
שדות | |
---|---|
traffic_rendering |
רינדור של קו פוליגוני שמציג את מהירות התנועה בכל האזורים במקטע אחד של נסיעה של לקוח. |
נסיעה
המטא-נתונים של הנסיעה.
שדות | |
---|---|
name |
פלט בלבד. בפורמט 'providers/{provider}/trips/{trip}' |
vehicle_id |
המזהה של הרכב בנסיעה הזו. |
trip_status |
הסטטוס הנוכחי של הנסיעה. |
trip_type |
סוג הנסיעה. |
pickup_point |
המיקום שבו הלקוח מציין שהוא יאסוף. |
actual_pickup_point |
קלט בלבד. המיקום בפועל מתי ואיפה הלקוח נאסף. השדה הזה נועד לספק משוב על פרטי האיסוף בפועל. |
actual_pickup_arrival_point |
קלט בלבד. השעה והמיקום בפועל של ההגעה של הנהג לנקודת האיסוף. השדה הזה מיועד לספק משוב לגבי ההגעה בפועל לנקודת האיסוף. |
pickup_time |
פלט בלבד. הזמן המשוער העתידי לאיסוף הנוסעים או השעה בפועל שבה הם נאספו. |
intermediate_destinations[] |
עצירות ביניים לפי סדר בקשת הנסיעה (בנוסף לאיסוף ולהורדה). בשלב הראשון לא תהיה תמיכה באפשרות הזו בנסיעות משותפות. |
intermediate_destinations_version |
מציין את הפעם האחרונה שבה בוצע שינוי ב- |
intermediate_destination_index |
כשהערך בשדה |
actual_intermediate_destination_arrival_points[] |
קלט בלבד. השעה והמיקום בפועל של הגעת הנהג ליעד הביניים. השדה הזה נועד לספק משוב לגבי הגעה בפועל ליעדי הביניים. |
actual_intermediate_destinations[] |
קלט בלבד. השעה והמיקום האמיתיים שבהם בוצע האיסוף של הלקוח מיעד הביניים, ושבו. השדה הזה נועד לספק משוב לגבי המידע על האיסוף בפועל ביעדי הביניים. |
dropoff_point |
המיקום שבו הלקוח מציין שהוא יעזוב. |
actual_dropoff_point |
קלט בלבד. השעה והמיקום בפועל שבהם הלקוח עצר. השדה הזה נועד לספק משוב על מידע בפועל על נשירה. |
dropoff_time |
פלט בלבד. הזמן המשוער העתידי שבו נוסעים יעזבו את היעד הסופי או השעה בפועל שבה הם הושמטו. |
remaining_waypoints[] |
פלט בלבד. הנתיב המלא מהמיקום הנוכחי אל נקודת הירידה, כולל. הנתיב הזה יכול לכלול ציוני דרך מנסיעות אחרות. |
vehicle_waypoints[] |
השדה הזה תומך בסדר ידני של ציוני הדרך בנסיעה. היא מכילה את כל נקודות הדרך הנותרות של הרכב שהוקצה לה, וגם את נקודות הדרך לאיסוף ולהורדה בנסיעה הזו. אם הנסיעה לא הוקצתה לרכב, Fleet Engine מתעלם מהשדה הזה. מטעמי פרטיות, השדה הזה מאוכלס רק על ידי השרת בשיחות |
route[] |
פלט בלבד. המסלול הצפוי לנסיעה הזו אל הכניסה הראשונה ב-נשארו_waypoints. הערה: יכול להיות שציון הדרך הראשון שייך לנסיעה אחרת. |
current_route_segment |
פלט בלבד. נתיב מקודד לנקודת הציון הבאה. הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK וב-Consumer SDK. עדיין אין תמיכה בפענוח קוד. |
current_route_segment_version |
פלט בלבד. מציין את הפעם האחרונה שבה בוצע שינוי במסלול. הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK. |
current_route_segment_traffic |
פלט בלבד. מציין את מצב התנועה לאורך הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK וב-Consumer SDK. |
current_route_segment_traffic_version |
פלט בלבד. מציין את הפעם האחרונה שבה בוצע שינוי ב- הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK וב-Consumer SDK. |
current_route_segment_end_point |
פלט בלבד. ציון הדרך שבו מסתיים |
remaining_distance_meters |
פלט בלבד. מרחק הנסיעה שנותר בשדה |
eta_to_first_waypoint |
פלט בלבד. זמן ההגעה המשוער לציון הדרך הבא (הרשומה הראשונה בשדה |
remaining_time_to_first_waypoint |
פלט בלבד. משך הזמן שממנו מוחזרים נתוני הנסיעה לזמן ב- |
remaining_waypoints_version |
פלט בלבד. מציין את הפעם האחרונה שבה בוצע שינוי של |
remaining_waypoints_route_version |
פלט בלבד. זוהי הפעם האחרונה שבה בוצע שינוי ב- |
number_of_passengers |
בלתי ניתן לשינוי. מציין את מספר הנוסעים בנסיעה הזו ולא כולל את הנהג. כדי להחזיר רכב בתגובה |
last_location |
פלט בלבד. מציינת את המיקום האחרון שדווחו על ידי הרכב לאורך המסלול. |
last_location_snappable |
פלט בלבד. מציינת אם ניתן להצמיד את |
view |
קבוצת המשנה של שדות הנסיעה שאוכלסו ואיך צריך לפרש אותם. |
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 |
המיקום של ציון הדרך הזה. |
trip_id |
הנסיעה שמשויכת לנקודת הציון הזו. |
waypoint_type |
התפקיד שציון הדרך הזה ממלא בנסיעה הזו, למשל איסוף או החזרה. |
path_to_waypoint[] |
הנתיב מציון הדרך הקודם עד לנקודת הציון הנוכחית. לא מוגדר לציון הדרך הראשון ברשימה. השדה הזה יאוכלס רק כשנשלחת בקשה לכך. |
encoded_path_to_waypoint |
הנתיב המקודד מציון הדרך הקודם עד לנקודת הציון הנוכחית. הערה: השדה הזה מיועד לשימוש רק עבור Driver SDK ו-Consumer SDK. עדיין אין תמיכה בפענוח קוד. |
traffic_to_waypoint |
מצב התנועה לאורך הנתיב לנקודת הציון הזו. לתשומת ליבכם: התנועה זמינה רק ללקוחות של הפתרון 'נסיעות ומשלוחים' בפלטפורמה של מפות Google. |
distance_meters |
המרחק של הדרך מציון הדרך הקודם עד לנקודת הציון הנוכחית. לא מוגדר לציון הדרך הראשון ברשימה. |
eta |
זמן ההגעה המשוער לנקודת הציון הזו. לא מוגדר לציון הדרך הראשון ברשימה. |
duration |
זמן הנסיעה מנקודת הציון הקודמת עד לנקודה הזו. לא מוגדר לציון הדרך הראשון ברשימה. |
UpdateTripRequest
הודעת בקשה ל-UpdateTrip.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
name |
חובה. חייב להיות בפורמט |
trip |
חובה. הנסיעה שמשויכת לעדכון. השדות הבאים מתוחזקים על ידי Fleet Engine. אין לעדכן אותן באמצעות Trip.update.
כשמעדכנים את כשמציינים את כדי להימנע ממרוץ תהליכים בנסיעות עם מספר יעדים, צריך לספק |
update_mask |
חובה. מסכת השדות שמציינת אילו שדות ב'נסיעה' לעדכן. השדה |
UpdateVehicleAttributesRequest
הודעה עם בקשת UpdateVehicleAttributes
.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
name |
חובה. חייב להיות בפורמט |
attributes[] |
חובה. מאפייני הרכב שצריך לעדכן. לא מבצעים שינויים במאפיינים שלא צוינו או מסירים אותם. |
UpdateVehicleAttributesResponse
הודעת תגובה אחת (UpdateVehicleAttributes
).
שדות | |
---|---|
attributes[] |
חובה. הרשימה המלאה של מאפייני הרכבים המעודכנים, כולל מאפיינים חדשים, מאפיינים שהשתנו ומאפיינים שלא בוצעו בהם שינויים. |
UpdateVehicleRequest
הודעת הבקשה UpdateVehicle.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של Fleet Engine. |
name |
חובה. חייב להיות בפורמט |
vehicle |
חובה. ערכי הישות
אם מעדכנים את השדה בדומה לכך, אפשר לעדכן את השדה |
update_mask |
חובה. מסיכת שדות שמציינת אילו שדות ב- |
כלי רכב
מטא-נתונים של הרכב.
שדות | |
---|---|
name |
פלט בלבד. השם הייחודי של הרכב הזה. הפורמט הוא |
vehicle_state |
מצב הרכב. |
supported_trip_types[] |
סוגי הנסיעות שנתמכים ברכב הזה. |
current_trips[] |
פלט בלבד. רשימת אפליקציות של |
last_location |
המיקום המדווח האחרון של הרכב. |
maximum_capacity |
מספר הנוסעים הכולל ברכב הזה. הנהג לא נלקח בחשבון בערך הזה. הערך הזה חייב להיות גדול מ-1 או שווה לו. |
attributes[] |
רשימת מאפיינים של רכבים. לרכב אפשר להזין עד 100 מאפיינים, ולכל מאפיין צריך להיות מפתח ייחודי. |
vehicle_type |
חובה. סוג הרכב הזה. אפשר להשתמש באפשרות הזו לסינון רכבים בתוצאות של |
license_plate |
פרטי לוחית הרישוי של הרכב. |
route[] |
הוצא משימוש: במקומו צריך להשתמש ברכיב |
current_route_segment |
הקו הפוליגוני שמציין את המסלול שאפליקציית הנהג מתכוונת לעבור אל ציון הדרך הבא. הרשימה הזו מוחזרת גם ב הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK. עדיין אין תמיכה בפענוח קוד. |
current_route_segment_traffic |
קלט בלבד. המידע הזה משמש את Fleet Engine כדי לשפר את שיתוף הנסיעות. הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK. |
current_route_segment_version |
פלט בלבד. השעה שבה הוגדר |
current_route_segment_end_point |
ציון הדרך שבו מסתיים |
remaining_distance_meters |
מרחק הנסיעה שנותר עבור |
eta_to_first_waypoint |
זמן ההגעה המשוער לרשומה הראשונה בשדה כשמעדכנים רכב, |
remaining_time_seconds |
קלט בלבד. זמן הנסיעה שנותר ל- כשמעדכנים רכב, |
waypoints[] |
שאר נקודות הדרך שהוקצו לרכב הזה. |
waypoints_version |
פלט בלבד. הפעם האחרונה שהשדה |
back_to_back_enabled |
השדה הזה מציין אם הנהג/ת מאשר/ת נסיעות הלוך ושוב. אם |
navigation_status |
סטטוס הניווט של הרכב. |
device_settings |
קלט בלבד. מידע על ההגדרות במכשיר הנייד שמשמש את הנהג/ת. |
VehicleType
סוג הרכב.
שדות | |
---|---|
category |
קטגוריית סוג הרכב |
קטגוריה
קטגוריות של סוגי כלי רכב
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN |
ברירת מחדל, משמשת לקטגוריות רכב שלא צוינו או לא מזוהות. |
AUTO |
מכונית. |
TAXI |
כל כלי רכב שמשמש כמונית (בדרך כלל ברישיון או בפיקוח). |
TRUCK |
באופן כללי, רכב עם נפח אחסון גדול. |
TWO_WHEELER |
אופנוע, קטנוע או כלי רכב דו-גלגלי אחר |
BICYCLE |
שינוע בני אדם. |
PEDESTRIAN |
כלי רכב בני אדם, שבדרך כלל הולכים או רצים, נעשים לאורך שבילים להולכי רגל. |
VehicleAttribute
מיועד לתיאור מאפיין רכב כצמד מפתח/ערך. העמודה "key:value" המחרוזת יכולה להיות באורך של עד 256 תווים.
שדות | |
---|---|
key |
המַּפתח של המאפיין. אסור שמפתחות יכילו את תו הנקודתיים (:). |
value |
ערך המאפיין. |
שדה איחוד vehicle_attribute_value . ערך המאפיין יכול להיות מחרוזת, בוליאני או סוג כפול. vehicle_attribute_value יכול להיות רק אחת מהאפשרויות הבאות: |
|
string_value |
ערך מאפיין שהוקלד במחרוזת. הערה: השדה הזה זהה לשדה |
bool_value |
ערך מאפיין בוליאני. |
number_value |
ערך המאפיין הוקלד פעמיים. |
VehicleAttributeList
סוג נתונים של רשימת רשימות למאפייני רכב.
שדות | |
---|---|
attributes[] |
רשימת מאפיינים באוסף הזה. |
VehicleLocation
המיקום, המהירות והכיוון של רכב בנקודת זמן מסוימת.
שדות | |
---|---|
location |
המיקום של הרכב. כשהרכב נשלח אל Fleet Engine, מיקום הרכב הוא מיקום לפי GPS. כשאתם מקבלים אותו בתגובה, מיקום הרכב יכול להיות מיקום GPS, מיקום משלים או מיקום משוער אחר. המקור מצוין ב- |
horizontal_accuracy |
הוצא משימוש: במקומו צריך להשתמש ברכיב |
latlng_accuracy |
דיוק של |
heading |
כיוון שהרכב נע במעלות. 0 מייצג את הצפון. הטווח החוקי הוא [0,360). |
bearing_accuracy |
הוצא משימוש: במקומו צריך להשתמש ברכיב |
heading_accuracy |
דיוק של |
altitude |
גובה במטרים מעל WGS84. |
vertical_accuracy |
הוצא משימוש: במקומו צריך להשתמש ברכיב |
altitude_accuracy |
דיוק של |
speed_kmph |
מהירות הרכב בקילומטרים לשעה. הוצא משימוש: במקומו צריך להשתמש ברכיב |
speed |
מהירות הרכב במטרים לשנייה |
speed_accuracy |
דיוק של |
update_time |
השעה שבה דווח על |
server_time |
פלט בלבד. השעה שבה השרת קיבל את פרטי המיקום. |
location_sensor |
ספק של נתוני מיקום (לדוגמה, |
is_road_snapped |
האם |
is_gps_sensor_enabled |
קלט בלבד. מציינת אם חיישן ה-GPS מופעל במכשיר הנייד. |
time_since_update |
קלט בלבד. הזמן (בשניות) שעבר מאז שהמיקום הזה נשלח לראשונה לשרת. בעדכון הראשון הערך יהיה אפס. אם השעה לא ידועה (לדוגמה, כשהאפליקציה מופעלת מחדש), הערך הזה מתאפס. |
num_stale_updates |
קלט בלבד. הוצא משימוש: אותות אחרים משמשים עכשיו כדי לקבוע אם מיקום מיושן. |
raw_location |
מיקום הרכב הגולמי (לא עבר עיבוד על ידי מתקן חירום). |
raw_location_time |
חותמת הזמן שמשויכת למיקום הגולמי. |
raw_location_sensor |
המקור של המיקום הגולמי. ברירת המחדל היא |
raw_location_accuracy |
דיוק של |
supplemental_location |
מיקום נוסף שסופק על ידי האפליקציה המשולבת. |
supplemental_location_time |
חותמת הזמן שמשויכת למיקום המשלים. |
supplemental_location_sensor |
המקור של המיקום המשלים. ברירת המחדל היא |
supplemental_location_accuracy |
דיוק של |
road_snapped |
הוצא משימוש: במקומו צריך להשתמש ברכיב |
VehicleMatch
מכילה את הרכב ואומדנים קשורים לרכב שתואמים לנקודות הנסיעות הפעילות של הרכב SearchVehiclesRequest
.
שדות | |
---|---|
vehicle |
חובה. רכב שתואם לבקשה. |
vehicle_pickup_eta |
זמן ההגעה המשוער של הרכב לנקודת האיסוף שצוינה בבקשה. ערך ריק מציין כשל בחישוב זמן ההגעה המשוער לרכב. אם בתאריך |
vehicle_pickup_distance_meters |
המרחק מהמיקום הנוכחי של הרכב לנקודת האיסוף שצוינה בבקשה, כולל נקודות ביניים לאיסוף או הורדה בנסיעות קיימות. המרחק הזה כולל את מרחק הנסיעה (המסלול) המחושב ואת מרחק הקו הישר בין נקודת היעד של הניווט לבין נקודת האיסוף המבוקשת. (בדרך כלל המרחק בין נקודת היעד של הניווט לנקודת האיסוף המבוקשת קטן). ערך ריק מציין שגיאה בחישוב המרחק. |
vehicle_pickup_straight_line_distance_meters |
חובה. מרחק הקו הישר בין הרכב לנקודת האיסוף שצוינה בבקשה. |
vehicle_dropoff_eta |
זמן ההגעה המשוער המלא של הרכב לנקודת האיסוף שצוינה בבקשה. זמן ההגעה המשוער כולל עצירה בכל נקודות ציון לפני ה- |
vehicle_pickup_to_dropoff_distance_meters |
מרחק הנסיעה של הרכב (במטרים) מנקודת האיסוף אל נקודת ההורדה שצוינה בבקשה. המרחק הוא רק בין שתי הנקודות, והוא לא כולל את מיקום הרכב או נקודות אחרות שצריך לבקר בהן לפני שהרכב מגיע לנקודת האיסוף או לנקודת ההורדה. הערך יאוכלס רק כשיצוין |
trip_type |
חובה. סוג הנסיעה של הבקשה ששימשה לחישוב זמן ההגעה המשוער לנקודת האיסוף. |
vehicle_trips_waypoints[] |
רשימה ממוינת של ציוני דרך שמשמשת לחישוב זמן ההגעה המשוער. הרשימה כוללת את מיקום הרכב, את נקודות האיסוף של הנסיעות הפעילות של הרכב ואת נקודות האיסוף שצוינו בבקשה. רשימה ריקה מציינת כשל בחישוב זמן ההגעה המשוער לרכב. |
vehicle_match_type |
סוג ההתאמה של הרכב. |
requested_ordered_by |
ההזמנה נשלחה למיון התאמות לרכבים. |
ordered_by |
ההזמנה בפועל שבה נעשה שימוש ברכב הזה. בדרך כלל הערך הזה יתאים ל-'order_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
קטע דרך אחד שאמור להיות רינדור.
שדות | |
---|---|
style |
חובה. הסגנון שצריך להחיל. |
offset_meters |
חובה. צריך להחיל את הסגנון בין התאריכים |
length_meters |
חובה. אורך הנתיב שבו צריך להחיל את הסגנון. |
סגנון
סגנון התנועה, שמציין את מהירות התנועה.
טיפוסים בני מנייה (enum) | |
---|---|
STYLE_UNSPECIFIED |
לא נבחר סגנון. |
SLOWER_TRAFFIC |
התנועה מאטה. |
TRAFFIC_JAM |
יש פקק תנועה. |
נקודת ציון
מתארת את נקודות הביניים במסלול של VehicleMatch
בSearchVehiclesResponse
. הקונספט הזה מיוצג בתור TripWaypoint
בכל שאר נקודות הקצה.
שדות | |
---|---|
lat_lng |
המיקום של ציון הדרך הזה. |
eta |
הזמן המשוער שבו הרכב יגיע לנקודת הציון הזו. |
WaypointType
סוג ציון הדרך.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
סוג ציון הדרך לא ידוע או לא מוגדר. |
PICKUP_WAYPOINT_TYPE |
ציוני דרך לאיסוף נוסעים או פריטים. |
DROP_OFF_WAYPOINT_TYPE |
ציוני דרך להורדת נוסעים או פריטים. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
ציוני דרך ליעדי ביניים בנסיעה עם כמה יעדים. |