משאב: נסיעה
מטא-נתונים של נסיעה.
ייצוג JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
שדות | |
---|---|
name |
פלט בלבד. בפורמט "providers/{provider}/trips/{trip}" |
vehicleId |
מזהה הרכב שמבצע את הנסיעה הזו. |
tripStatus |
הסטטוס הנוכחי של הנסיעה. |
tripType |
סוג הנסיעה. |
pickupPoint |
המיקום שבו הלקוח מציין שהוא יאסוף אותו. |
actualPickupPoint |
קלט בלבד. המיקום בפועל של האיסוף של הלקוח. השדה הזה מיועד לספק משוב על פרטי האיסוף בפועל. |
actualPickupArrivalPoint |
קלט בלבד. השעה והמיקום בפועל של הגעת הנהג לנקודת האיסוף. השדה הזה מיועד לספק משוב על פרטי ההגעה בפועל בנקודת האיסוף. |
pickupTime |
פלט בלבד. השעה המשוערת בעתיד שבה יאספו את הנוסעים או השעה שבה הם נאספו בפועל. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
intermediateDestinations[] |
אמצעי ההגעה לאתר עוצר לפי הסדר שבו תישלח בקשת הנסיעה (בנוסף לאיסוף ולהחזרה). בשלב הראשון, האפשרות הזו לא תיתמך בנסיעות משותפות. |
intermediateDestinationsVersion |
מציין את הפעם האחרונה שבה חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
intermediateDestinationIndex |
כשהערך בשדה |
actualIntermediateDestinationArrivalPoints[] |
קלט בלבד. השעה והמיקום בפועל של הגעת הנהג ליעד ביניים. השדה הזה מיועד לספק משוב לגבי מידע על הגעה בפועל ליעדי הביניים. |
actualIntermediateDestinations[] |
קלט בלבד. השעה והמיקום בפועל שבהם הלקוח נאסף מיעד ביניים ושבו הוא ייאסף. השדה הזה מיועד לספק משוב לגבי מידע על איסוף בפועל ביעדי הביניים. |
dropoffPoint |
המיקום שבו הלקוח מציין שהוא יוסר. |
actualDropoffPoint |
קלט בלבד. השעה והמיקום בפועל שבהם הלקוח הפסיק והמקום שבו. השדה הזה מיועד לספק משוב על המידע בפועל על ההפסקה. |
dropoffTime |
פלט בלבד. הערכה של הזמן העתידי המשוער שבו נוסעים יושמטו ביעד הסופי או השעה בפועל שבה הסירו אותם. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
remainingWaypoints[] |
פלט בלבד. הנתיב המלא מהמיקום הנוכחי לנקודת ההורדה, כולל. הנתיב הזה יכול לכלול ציוני דרך מנסיעות אחרות. |
vehicleWaypoints[] |
השדה הזה תומך בסדר ידני של ציוני הדרך בנסיעה. הכרטיס כולל את כל ציוני הדרך הנותרים ברכב שהוקצה, וכן את ציוני הדרך של האיסוף וההורדה בנסיעה הזו. אם הנסיעה לא הוקצתה לרכב, Fleet Engine מתעלם משדה זה. מטעמי פרטיות, השדה הזה מאוכלס רק על ידי השרת בשיחות |
route[] |
פלט בלבד. המסלול הצפוי לנסיעה זו אל הכניסה הראשונה ב-AdditionalWaypointspoints. שימו לב: ייתכן שציון הדרך הראשון שייך לנסיעה אחרת. |
currentRouteSegment |
פלט בלבד. נתיב מקודד לנקודת הדרך הבאה. הערה: השדה הזה מיועד לשימוש ב-SDK של הנהג וב-SDK לצרכן בלבד. עדיין אין תמיכה בפענוח. |
currentRouteSegmentVersion |
פלט בלבד. מציין את הפעם האחרונה שהמסלול השתנה. הערה: השדה הזה מיועד לשימוש ב-SDK של הנהג וב-SDK לצרכן בלבד. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
currentRouteSegmentTraffic |
פלט בלבד. מצב התנועה לאורך הערה: השדה הזה מיועד לשימוש ב-SDK של הנהג וב-SDK לצרכן בלבד. |
currentRouteSegmentTrafficVersion |
פלט בלבד. מציין את הפעם האחרונה שבה הערה: השדה הזה מיועד לשימוש ב-SDK של הנהג וב-SDK לצרכן בלבד. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
currentRouteSegmentEndPoint |
פלט בלבד. ציון הדרך שבו |
remainingDistanceMeters |
פלט בלבד. מרחק הנסיעה שנותר בשדה |
etaToFirstWaypoint |
פלט בלבד. זמן ההגעה המשוער עד לנקודת הדרך הבאה (הרשומה הראשונה בשדה חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
remainingTimeToFirstWaypoint |
פלט בלבד. משך הזמן מהרגע שבו נתוני הנסיעה מוחזרים לשעה ב משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
remainingWaypointsVersion |
פלט בלבד. מציין את הפעם האחרונה שבה חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
remainingWaypointsRouteVersion |
פלט בלבד. מציין את הפעם האחרונה שבה בוצעו שינויים ב- חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
numberOfPassengers |
לא משתנה. מציין את מספר הנוסעים בנסיעה הזו, לא כולל את הנהג. חובה שיהיה אפשר להחזיר רכב מסוים בתגובה של |
lastLocation |
פלט בלבד. מציין את המיקום המדווח האחרון של הרכב לאורך המסלול. |
lastLocationSnappable |
פלט בלבד. השדה הזה מציין אם אפשר להצמיד את |
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 |
הנסיעה בוטלה לפני האיסוף על ידי הנהג, הנוסע או ספק שיתוף הנסיעה. |
StopLocation
המיקום בפועל שבו התרחשה עצירה (איסוף/הורדה).
ייצוג JSON |
---|
{
"point": {
object ( |
שדות | |
---|---|
point |
חובה. שדה זה מציין את המיקום בפועל. |
timestamp |
שדה זה מציין מתי התרחשה העצירה. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
stopTime |
קלט בלבד. הוּצא משימוש. יש להשתמש בשדה חותמת זמן. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
TripView
בורר לקבוצות שונות של שדות נסיעה בתגובת trips.get
. למידע נוסף על ההקשר, אפשר לעיין ב-AIP-157. סביר להניח שיתווספו צפיות נוספות.
טיפוסים בני מנייה (enums) | |
---|---|
TRIP_VIEW_UNSPECIFIED |
ערך ברירת המחדל. בתאימות לאחור, ה-API יוגדר כברירת מחדל לתצוגת SDK. כדי להבטיח יציבות ותמיכה, מומלץ ללקוחות לבחור TripView (לא כולל SDK ). |
SDK |
נכללים שדות שייתכן שלא ניתן לפרש או לתמוך בהם באמצעות ספריות זמינות לציבור. |
JOURNEY_SHARING_V1S |
שדות הנסיעה מאוכלסים בתרחיש לדוגמה של שיתוף נסיעה. התצוגה הזו מיועדת לתקשורת בין שרתים. |
שיטות |
|
---|---|
|
יצירת נסיעה ב-Flet Engine והחזרת הנסיעה החדשה. |
|
קבלת מידע על נסיעה בודדת. |
|
הצגת כל הנסיעות של רכב מסוים. |
|
מתבצע עדכון של נתוני הנסיעה. |