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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion

string (Timestamp format)

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

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

חותמת זמן בפורמט "זולו" 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, התנועה והנתיב תמיד מאוחזרים.

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

גוף הבקשה

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

גוף התגובה

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

PolylineFormatType

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

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