Method: providers.trips.get

ดูข้อมูลเกี่ยวกับการเดินทาง 1 ครั้ง

คำขอ 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 หากข้อมูลเส้นทางไม่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลานี้ ระบบจะไม่ตั้งค่าช่องเส้นทางในการตอบกลับ หากไม่ระบุจำนวนขั้นต่ำ ระบบจะดึงข้อมูลเส้นทางเสมอ

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
remainingWaypointsVersion
(deprecated)

string (Timestamp format)

เลิกใช้งานแล้ว: ระบบจะดึงข้อมูล Trip.remaining_waypoints เสมอ ใช้ remainingWaypointsRouteVersion เพื่อควบคุมเวลาในการดึงข้อมูล Trip.remaining_waypoints.traffic_to_waypoint และ Trip.remaining_waypoints.path_to_waypoint

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "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-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "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-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "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 เส้นประกอบที่เข้ารหัสด้วยอัลกอริทึมการบีบอัดเส้นประกอบ ยังไม่รองรับการถอดรหัส