Method: providers.trips.get

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

בקשת HTTP

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

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

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

string (Timestamp format)

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

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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, התנועה והנתיב תמיד מאוחזרים.

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