אינדקס
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 |
---|
יצירת נסיעה ב-Flet Engine והחזרת הנסיעה החדשה. |
GetTrip |
---|
לקבל מידע על נסיעה בודדת. |
ReportBillableTrip |
---|
דיווח על שימוש בנסיעה בתשלום. |
SearchTrips |
---|
הצגת כל הנסיעות ברכב ספציפי. |
UpdateTrip |
---|
נתוני הנסיעה מתעדכנים. |
VehicleService
שירות ניהול רכב.
CreateVehicle |
---|
יצירת גרסה של רכב חדש שמשויך לספק נסיעות או משלוחים על פי דרישה. לכל כשיוצרים
כשיוצרים
כל שאר השדות הם אופציונליים ונעשה בהם שימוש אם ציינתם אותם. |
GetVehicle |
---|
מחזיר רכב ממנוע ה-Flet. |
ListVehicles |
---|
הפונקציה מחזירה רשימה מעומדת של כלי הרכב שמשויכים לספק שתואם לאפשרויות הבקשה. |
SearchVehicles |
---|
מחזירה רשימה של כלי רכב שתואמים לאפשרויות הבקשה. |
UpdateVehicle |
---|
כתיבת נתוני רכב מעודכנים אל Fleet Engine. כשמעדכנים
גם אי אפשר לעדכן את הרכב אם מעדכנים את השדה |
UpdateVehicleAttributes |
---|
מעדכנים באופן חלקי את מאפייני הרכב. רק המאפיינים המוזכרים בבקשה יעודכנו, מאפיינים אחרים לא ישתנו. הערה: המדיניות הזו שונה ב- |
BatteryInfo
מידע על סוללת המכשיר.
שדות | |
---|---|
battery_status |
סטטוס הסוללה, בין אם היא מלאה, נטענת וכו'. |
power_source |
הסטטוס של מקור הסוללה. |
battery_percentage |
אחוז הטעינה הנוכחי של הסוללה [0-100]. |
BatteryStatus
סטטוס הסוללה, בין אם היא מלאה, נטענת וכו'.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_BATTERY_STATUS |
מצב הסוללה לא ידוע. |
BATTERY_STATUS_CHARGING |
הסוללה בטעינה. |
BATTERY_STATUS_DISCHARGING |
הסוללה מתרוקנת. |
BATTERY_STATUS_FULL |
הסוללה טעונה במלואה. |
BATTERY_STATUS_NOT_CHARGING |
הסוללה לא נטענת. |
BATTERY_STATUS_POWER_LOW |
הסוללה חלשה. |
BillingPlatformIdentifier
קבוצת ערכים שמציינים באיזו פלטפורמה נשלחה הבקשה.
טיפוסים בני מנייה (enums) | |
---|---|
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED |
ברירת מחדל. משמש לפלטפורמות שלא צוינו. |
SERVER |
הפלטפורמה היא שרת לקוח. |
WEB |
הפלטפורמה היא דפדפן אינטרנט. |
ANDROID |
הפלטפורמה היא מכשיר נייד עם Android. |
IOS |
הפלטפורמה היא מכשיר נייד ל-iOS. |
OTHERS |
פלטפורמות אחרות שלא מופיעות במספור הזה. |
ConsumableTrafficPolyline
צפיפות התנועה לאורך הנתיב של כלי הרכב.
שדות | |
---|---|
speed_reading_interval[] |
מהירות התנועה לאורך הנתיב מציון הדרך הקודם עד לנקודת הדרך הנוכחית. |
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 |
הגבלת התגובה לרכבים ששלחו עדכוני מיקום ל-Feet Engine במהלך משך הזמן שצוין. רכבים נייחים שעדיין משדרים את המיקומים שלהם לא נחשבים למיושנים. אם הוא קיים, הערך חייב להיות משך זמן חיובי. |
vehicle_type_categories[] |
חובה. מגביל את התגובה לרכבים עם אחת מהקטגוריות שצוינו. לא ניתן להפר את המדיניות: |
required_attributes[] |
מתקשרים יכולים ליצור פעולות לוגיות מורכבות באמצעות כל שילוב של השדות
מגבילים את התגובה לרכבים עם המאפיינים שצוינו. השדה הזה הוא פעולת חיבור/AND. אפשר להוסיף עד 50 מאפייני חובה. הערך הזה תואם למספר המקסימלי של מאפיינים שמותר להוסיף לרכב. כל מחרוזת חוזרת צריכה להיות בפורמט "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())
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
מיקום PowerSaveMode לא מוגדר |
LOCATION_MODE_NO_CHANGE |
מצב 'חיסכון בסוללה' לא אמור להשפיע על ספקי המיקום, או שמצב החיסכון בסוללה כבוי. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
יש להשבית את ספק המיקום שמבוסס על GPS כשמצב 'חיסכון בסוללה' פועל והמכשיר לא אינטראקטיבי. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
צריך להשבית את כל ספקי המיקום כשמצב 'חיסכון בסוללה' פועל והמכשיר לא אינטראקטיבי. |
LOCATION_MODE_FOREGROUND_ONLY |
כל ספקי המיקום יישארו זמינים, אבל תיקוני מיקום צריכים להיות זמינים רק לאפליקציות שפועלות בחזית. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
המיקום לא יושבת, אבל LocationManager יווסת את כל הבקשות לספקים כשהמכשיר לא אינטראקטיבי. |
LocationSensor
החיישן או המתודולוגיה ששימשה לקביעת המיקום.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_SENSOR |
החיישן לא צוין או לא ידוע. |
GPS |
GPS או GPS בסיוע. |
NETWORK |
GPS בסיוע, מזהה מגדל סלולרי או נקודת גישה ל-Wi-Fi. |
PASSIVE |
מזהה אנטנה סלולרית או נקודת גישה ל-Wi-Fi. |
ROAD_SNAPPED_LOCATION_PROVIDER |
מיקום שנקבע על ידי המכשיר הנייד כמיקום הצפוי ביותר בכביש. |
CUSTOMER_SUPPLIED_LOCATION |
מיקום שסופק על ידי הלקוח ממקור בלתי תלוי. בדרך כלל, הערך הזה משמש עבור מיקום שסופק ממקורות אחרים שאינם המכשיר הנייד שמריץ את Driver SDK. אם המקור המקורי מתואר על ידי אחד מהערכים האחרים של 'טיפוסים בני מנייה (enum)', צריך להשתמש בערך הזה. מיקומים המסומנים ב-CUSTOMER_SUPPLIED_LOCATION מסופקים בדרך כלל באמצעות last_location.supplemental_location_sensor של כלי רכב. |
FLEET_ENGINE_LOCATION |
מיקום שמחושב על ידי Fleet Engine על סמך האותות הזמינים עבורו. פלט בלבד. הערך הזה יידחה אם הוא יתקבל במסגרת בקשה. |
FUSED_LOCATION_PROVIDER |
ספק המיקום המשולב של Android. |
CORE_LOCATION |
ספק המיקום במערכות ההפעלה של Apple. |
PolylineFormatType
הסוג של הפורמט של קו פוליגוני.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_FORMAT_TYPE |
הפורמט לא צוין או לא ידוע. |
LAT_LNG_LIST_TYPE |
רשימה של google.type.LatLng . |
ENCODED_POLYLINE_TYPE |
קו פוליגוני המקודד באמצעות אלגוריתם דחיסה של קו פוליגוני. עדיין אין תמיכה בפענוח. |
PowerSource
סוג המטען שמשמש לטעינת הסוללה.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_POWER_SOURCE |
מקור הכוח לא ידוע. |
POWER_SOURCE_AC |
מקור הכוח הוא מטען AC. |
POWER_SOURCE_USB |
מקור הכוח הוא יציאת USB. |
POWER_SOURCE_WIRELESS |
מקור הכוח הוא אלחוטי. |
POWER_SOURCE_UNPLUGGED |
הסוללה מנותקת. |
ReportBillableTripRequest
הודעת בקשה של ReportBillableTrip.
שדות | |
---|---|
name |
חובה. חייב להיות בפורמט |
country_code |
חובה. קוד מדינה בן שתי אותיות של המדינה שבה הנסיעה מתבצעת. המחיר מוגדר בהתאם לקוד המדינה. |
platform |
הפלטפורמה שבה נשלחה הבקשה. |
related_ids[] |
המזהים שקשורים ישירות לנסיעה המדווחת. בדרך כלל מדובר במזהים (למשל, מזהי סשנים) של פעולות הזמנה מראש שבוצעו לפני שמזהה הנסיעה היה זמין. מספר ה |
solution_type |
סוג הפתרון למוצר GMP (לדוגמה, |
SolutionType
בורר לסוגי פתרונות שונים של נסיעה שמדווחת.
טיפוסים בני מנייה (enums) | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
ערך ברירת המחדל. לצורך תאימות לאחור, ה-API ישתמש ב-ON_DEMAND_RIDESHARING_AND_DELIVERIES כברירת מחדל, שהוא סוג הפתרון הראשון שנתמך. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
הפתרון הוא נסיעה משותפת על פי דרישה עם משלוחים. |
RequestHeader
כותרת RequestHeader מכילה שדות שמשותפים לכל הבקשות של Fleet Engine RPC.
שדות | |
---|---|
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 |
גרסת ה-NavSDK שעליה תלוי ה-SDK לשיחות, אם רלוונטי. פורמט הגרסה הוא 'major.minor.patch', לדוגמה: |
platform |
הפלטפורמה של ה-SDK לשיחות. |
manufacturer |
היצרן של מכשיר Android מה-SDK לשיחות. רלוונטי רק לערכות ה-SDK ל-Android. דוגמה לערך בשדה: |
android_api_level |
רמת ה-API של Android של ה-SDK לשיחות. רלוונטית רק לערכות ה-SDK ל-Android. דוגמה לערך בשדה: |
trace_id |
מזהה אופציונלי שאפשר לספק למטרות רישום ביומן כדי לזהות את הבקשה. |
פלטפורמה
הפלטפורמה של ה-SDK לשיחות.
טיפוסים בני מנייה (enums) | |
---|---|
PLATFORM_UNSPECIFIED |
ערך ברירת המחדל. ייעשה שימוש בערך הזה אם לא תציינו את הפלטפורמה. |
ANDROID |
הבקשה מגיעה מ-Android. |
IOS |
הבקשה מגיעה מ-iOS. |
WEB |
הבקשה מגיעה מהאינטרנט. |
SdkType
סוגים אפשריים של SDK.
טיפוסים בני מנייה (enums) | |
---|---|
SDK_TYPE_UNSPECIFIED |
ערך ברירת המחדל. נעשה שימוש בערך הזה אם לא מזינים את הערך sdk_type . |
CONSUMER |
ה-SDK לשיחות הוא 'צרכן'. |
DRIVER |
ה-SDK לשיחות הוא Driver. |
JAVASCRIPT |
ה-SDK המפעיל הוא JavaScript. |
SearchTripsRequest
הודעת הבקשה של SearchTrips.
שדות | |
---|---|
header |
כותרת הבקשה הרגילה של 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 |
מגביל את החיפוש רק לכלי הרכב ששלחו עדכוני מיקום ל-Feet Engine במהלך פרק הזמן שצוין. רכבים נייחים שעדיין משדרים את המיקומים שלהם לא נחשבים למיושנים. אם שדה זה לא מוגדר, השרת ישתמש בחמש דקות כערך ברירת המחדל. |
vehicle_types[] |
חובה. מגביל את החיפוש לרכבים עם אחד מהסוגים שצוינו. צריך לציין לפחות סוג אחד של רכב. אסור להשתמש בסוגי רכב עם הקטגוריה |
required_attributes[] |
מתקשרים יכולים ליצור פעולות לוגיות מורכבות באמצעות כל שילוב של השדות
החיפוש יוגבל רק לכלי רכב עם המאפיינים שצוינו. השדה הזה הוא פעולת חיבור/AND. אפשר להוסיף עד 50 מאפייני חובה. הערך הזה תואם למספר המקסימלי של מאפיינים שמותר להוסיף לרכב. |
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
ההגדרה הזו מציינת את סוגי ההגבלות על הנסיעות הנוכחיות של הרכב.
טיפוסים בני מנייה (enums) | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
הזמינות של כלי רכב שיש בהם נסיעות נקבעת לפי השדה include_back_to_back . |
NONE |
כלי רכב ללא נסיעות יכולים להופיע בתוצאות החיפוש. כשמשתמשים בערך הזה, include_back_to_back לא יכול להיות true . |
ANY |
כלי רכב עם 5 נסיעות עדכניות ו-10 ציוני דרך לכל היותר נכללים בתוצאות החיפוש. כשמשתמשים בערך הזה, include_back_to_back לא יכול להיות true . |
VehicleMatchOrder
מציין את סדר ההתאמות של הרכב בתשובה.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
ברירת המחדל, משמשת להזמנה של התאמת רכבים שלא צוינה או לא מזוהה. |
PICKUP_POINT_ETA |
בסדר עולה לפי זמן הנסיעה של הרכב אל נקודת האיסוף. |
PICKUP_POINT_DISTANCE |
סדר עולה לפי מרחק הנסיעה של כלי הרכב אל נקודת האיסוף. |
DROPOFF_POINT_ETA |
סדר עולה לפי זמן הנסיעה של כלי הרכב אל נקודת ההורדה. אפשר להשתמש בהזמנה הזו רק אם נקודת ההורדה צוינה בבקשה. |
PICKUP_POINT_STRAIGHT_DISTANCE |
סדר עולה לפי המרחק בקו הישר מהמיקום האחרון שדווח ברכב עד לנקודת האיסוף. |
COST |
סדר עולה לפי עלות ההתאמה שהוגדרה. עלות ההתאמה מוגדרת כחישוב משוקלל בין המרחק בקו ישר לבין זמן ההגעה המשוער. המשקלים מוגדרים עם ערכי ברירת מחדל ואפשר לשנות אותם לפי לקוח. אם צריך לשנות את המשקולות האלה בפרויקט, יש לפנות לתמיכה של Google. |
SearchVehiclesResponse
הודעת תגובה אחת (SearchVehicles
).
שדות | |
---|---|
matches[] |
רשימה של רכבים שתואמים לקריטריונים של |
SpeedReadingInterval
אינדיקטור של צפיפות תנועה בקטע רציף של נתיב. בהינתן נתיב עם נקודות P_0, P_1, ... , P_N (אינדקס מבוסס אפס), ה-SpeedReadingInterval מגדיר מרווח ומתאר את התנועה שלו באמצעות הקטגוריות הבאות.
שדות | |
---|---|
start_polyline_point_index |
האינדקס ההתחלתי של המרווח הזה בנתיב. ב-JSON, כשהאינדקס הוא 0, ייראה שהשדה לא מאוכלס. |
end_polyline_point_index |
אינדקס הסיום של המרווח הזה בנתיב. ב-JSON, כשהאינדקס הוא 0, ייראה שהשדה לא מאוכלס. |
speed |
מהירות התנועה במרווח הזמן הזה. |
מהירות
הסיווג של מהירות פוליגונים על סמך נתוני תנועה.
טיפוסים בני מנייה (enums) | |
---|---|
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
הוצא משימוש: נקודות TerminalPoint לא נתמכות יותר ב-Flet 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
הסטטוס של נסיעה שמציינת את ההתקדמות שלה.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_TRIP_STATUS |
ברירת מחדל, משמשת לסטטוס נסיעה שלא צוין או לא מזוהה. |
NEW |
נסיעה חדשה שנוצרה. |
ENROUTE_TO_PICKUP |
הנהג/ת בדרכו לנקודת האיסוף. |
ARRIVED_AT_PICKUP |
הנהג הגיע לנקודת האיסוף. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
הנהג הגיע ליעד ביניים וממתין לנוסע. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
הנהג/ת בדרכו ליעד ביניים (לא לנקודת ההורדה). |
ENROUTE_TO_DROPOFF |
הנהג/ת אוסף/ה את הנוסע/ת והוא בדרך ליעד הבא. |
COMPLETE |
הנוסע/ת הוסר/ה והנסיעה הושלמה. |
CANCELED |
הנסיעה בוטלה לפני האיסוף על ידי הנהג, הנוסע או הספק של שיתוף הנסיעה. |
TripType
סוג הנסיעה.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_TRIP_TYPE |
ברירת המחדל, משמשת לסוגי נסיעות שלא צוינו או לא מזוהים. |
SHARED |
יכול להיות שבנסיעה משותפת כלי רכב עם נסיעות אחרות. |
EXCLUSIVE |
הנסיעה מוגבלת לרכב. |
TripView
בורר לקבוצות שונות של שדות נסיעה בתשובה של GetTrip
. למידע על הקשר, אפשר לעיין ב-AIP-157. סביר להניח שיתווספו צפיות נוספות.
טיפוסים בני מנייה (enums) | |
---|---|
TRIP_VIEW_UNSPECIFIED |
ערך ברירת המחדל. במקרה של תאימות לאחור, ה-API ישמש כברירת מחדל בתצוגת SDK. כדי לשמור על יציבות ותמיכה, אנחנו ממליצים ללקוחות לבחור TripView שאינו SDK . |
SDK |
כולל שדות שייתכן שלא תהיה אפשרות לפרש או לתמוך בהם באמצעות ספריות ציבוריות. |
JOURNEY_SHARING_V1S |
שדות הנסיעה מאוכלסים בתרחיש לדוגמה של שיתוף תהליך. התצוגה הזו מיועדת לתקשורת בין שרתים. |
TripWaypoint
מתאר נקודת עצירה במסלול של כלי רכב או נקודת סיום בנסיעה של רכב.
שדות | |
---|---|
location |
המיקום של ציון הדרך הזה. |
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 |
קטגוריית סוג הרכב |
קטגוריה
קטגוריות של סוגי רכבים
טיפוסים בני מנייה (enums) | |
---|---|
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
סוג ההתאמה לרכב.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN |
סוג התאמה לא ידוע של רכב |
EXCLUSIVE |
כרגע לא הוקצתה נסיעה לרכב, והוא יכול להמשיך לנקודת האיסוף. |
BACK_TO_BACK |
הרכב מוקצה כרגע לנסיעה, אבל הוא יכול להמשיך לנקודת האיסוף אחרי השלמת הנסיעה. בחישובי זמן ההגעה המשוער והמרחק, הנסיעה הנוכחית נלקחת בחשבון. |
CARPOOL |
יש ברכב מספיק קיבולת לנסיעה משותפת. |
CARPOOL_BACK_TO_BACK |
הרכב יסיים את הנסיעה הפעילה הנוכחית לפני שימשיך לנקודת האיסוף. בחישובי זמן ההגעה המשוער והמרחק, הנסיעה הנוכחית נלקחת בחשבון. |
VehicleState
המצב של Vehicle
.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_VEHICLE_STATE |
ברירת המחדל, משמשת למצבי רכב לא מזוהים או לא מזוהים. |
OFFLINE |
הרכב לא מקבל נסיעות חדשות. הערה: יכול להיות שהרכב ימשיך לפעול במצב הזה בזמן השלמת הנסיעה שהוקצתה לו. |
ONLINE |
הרכב מקבל נסיעות חדשות. |
VisualTrafficReportPolylineRendering
תיאור האופן שבו לקוחות צריכים לצבוע חלק אחד של הקו הפוליגוני לאורך המסלול.
שדות | |
---|---|
road_stretch[] |
זה שינוי אופציונלי. מתחמי דרך שאמורים להיות מוצגים לאורך קו פוליגוני. מובטח שלא יהיו מתיחות חופפות, והן לא בהכרח יתפרסו על כל המסלול. בהיעדר קטע דרך לסגנון, הלקוח צריך להחיל את ברירת המחדל עבור המסלול. |
RoadStretch
קטע דרך אחד שצריך להציג.
שדות | |
---|---|
style |
חובה. הסגנון שצריך להחיל. |
offset_meters |
חובה. הסגנון צריך לחול בין |
length_meters |
חובה. אורך הנתיב שעליו יש להחיל את הסגנון. |
סגנון
סגנון התנועה, שמציין את מהירות התנועה.
טיפוסים בני מנייה (enums) | |
---|---|
STYLE_UNSPECIFIED |
לא נבחר סגנון. |
SLOWER_TRAFFIC |
התנועה מאטה. |
TRAFFIC_JAM |
יש פקק תנועה. |
נקודת ציון
מתאר נקודות ביניים לאורך מסלול של VehicleMatch
בSearchVehiclesResponse
. הקונספט הזה מיוצג בתור TripWaypoint
בכל נקודות הקצה האחרות.
שדות | |
---|---|
lat_lng |
המיקום של ציון הדרך הזה. |
eta |
הזמן המשוער שהרכב יגיע לנקודת הדרך הזו. |
WaypointType
הסוג של ציון הדרך.
טיפוסים בני מנייה (enums) | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
סוג ציון הדרך לא ידוע או לא צוין. |
PICKUP_WAYPOINT_TYPE |
ציוני דרך לאיסוף נוסעים או פריטים. |
DROP_OFF_WAYPOINT_TYPE |
ציוני דרך להורדת נוסעים או פריטים. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
ציוני דרך ליעדי ביניים בנסיעה עם כמה יעדים. |