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. אם נתוני המסלול לא השתנו מאז חותמת הזמן הזו, שדה המסלול לא מוגדר בתגובה. אם לא צוין ערך מינימלי, נתוני המסלול מאוחזרים תמיד.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion

string (Timestamp format)

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

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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 לא מוגדר בתגובה. אם לא צוין מינימום, נתוני התנועה תמיד מאוחזרים. לתשומת ליבכם: התכונה 'תנועה' זמינה רק ללקוחות עם פתרון לנסיעות ולמשלוחים על פי דרישה.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

גוף הבקשה

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

גוף התשובה

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

PolylineFormatType

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

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