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

การประทับเวลาเป็น 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 โพลีไลน์ที่เข้ารหัสด้วยอัลกอริทึมการบีบอัดโพลีไลน์ ยังไม่รองรับการถอดรหัส