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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
remainingWaypointsVersion

string (Timestamp format)

ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่เรียกข้อมูล Trip.remaining_waypoints หากไม่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลานี้ ระบบจะไม่ได้ตั้งค่า remainingWaypoints ในการตอบกลับ หากไม่ระบุช่องนี้ ระบบจะเรียกข้อมูล remainingWaypoints เสมอ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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 โพลีไลน์ที่เข้ารหัสด้วยอัลกอริทึมการบีบอัดโพลีไลน์ ยังไม่รองรับการถอดรหัส