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