Method: providers.trips.get

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

בקשת HTTP

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

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

פרמטרים של שאילתה

פרמטרים
header

object (RequestHeader)

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

enum (TripView)

קבוצת המשנה של שדות הנסיעה שצריך להחזיר והפרשנות שלהם.
currentRouteSegmentVersion

string (Timestamp format)

מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצעת אחזור של נתוני Trip.route או Trip.current_route_segment. אם נתוני המסלול לא השתנו מאז חותמת הזמן הזו, שדה המסלול לא מוגדר בתגובה. אם לא צוין ערך מינימלי, נתוני המסלול מאוחזרים תמיד.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
remainingWaypointsVersion

string (Timestamp format)

מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצעת אחזור של Trip.remaining_waypoints. אם הם לא השתנו מאז חותמת הזמן הזו, השדות remainingWaypoints לא מוגדרים בתגובה. אם לא מציינים את השדה הזה, תמיד מתבצע אחזור של remainingWaypoints.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
routeFormatType

enum (PolylineFormatType)

הפורמט של המסלול הנוכחי שמוחזר, LAT_LNG_LIST_TYPE (ב-Trip.route) או ENCODED_POLYLINE_TYPE (ב-Trip.current_route_segment). ברירת המחדל היא LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של Trip.current_route_segment_traffic. אם נתוני התנועה לא השתנו מאז חותמת הזמן הזו, השדה currentRouteSegmentTraffic לא מוגדר בתגובה. אם לא צוין מינימום, נתוני התנועה תמיד מאוחזרים. לתשומת ליבכם: התכונה 'תנועה' זמינה רק ללקוחות עם פתרון לנסיעות ולמשלוחים על פי דרישה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
remainingWaypointsRouteVersion

string (Timestamp format)

מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצעת אחזור של נתוני Trip.remaining_waypoints.traffic_to_waypoint ו-Trip.remaining_waypoints.path_to_waypoint. אם הנתונים לא השתנו מאז חותמת הזמן הזו, השדות שלמעלה לא מוגדרים בתגובה. אם לא מציינים את remainingWaypointsRouteVersion, תמיד מתבצעת אחזור של התנועה והנתיב.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Trip.

PolylineFormatType

סוג הפורמט של קווים פוליגונליים.

טיפוסים בני מנייה (enum)
UNKNOWN_FORMAT_TYPE הפורמט לא צוין או שהוא לא ידוע.
LAT_LNG_LIST_TYPE רשימה של google.type.LatLng.
ENCODED_POLYLINE_TYPE קו פוליגוני המקודד באמצעות אלגוריתם דחיסת קו פוליגוני. עדיין אין תמיכה בפענוח.