แหล่งข้อมูล: การเดินทาง
ข้อมูลเมตาของการเดินทาง
การแสดง JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ในรูปแบบ "providers/{provider}/trips/{trip}" |
vehicleId |
รหัสของพาหนะที่ใช้เดินทางในการเดินทางนี้ |
tripStatus |
สถานะปัจจุบันของการเดินทาง |
tripType |
ประเภทของการเดินทาง |
pickupPoint |
สถานที่ที่ลูกค้าระบุว่าจะมารับ |
actualPickupPoint |
อินพุตเท่านั้น ตำแหน่งจริงเวลาและรับลูกค้า ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการรับสินค้าจริง |
actualPickupArrivalPoint |
อินพุตเท่านั้น เวลาและสถานที่จริงของคนขับรถมาถึงจุดรับสินค้า ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการมาถึงจริง ณ จุดรับ |
pickupTime |
เอาต์พุตเท่านั้น เวลาที่คาดว่าจะมารับผู้โดยสาร หรือเวลาจริงที่ไปรับผู้โดยสาร การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
intermediateDestinations[] |
จุดแวะระหว่างทาง (นอกเหนือจากการรับและส่ง) โดยในระยะแรกจะไม่รองรับการเดินทางที่มีการแชร์กัน |
intermediateDestinationsVersion |
ระบุครั้งล่าสุดที่แก้ไข การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
intermediateDestinationIndex |
เมื่อ |
actualIntermediateDestinationArrivalPoints[] |
อินพุตเท่านั้น เวลาและสถานที่จริงที่จะไปถึงคนขับที่ปลายทางระดับกลาง ช่องนี้มีไว้สำหรับผู้ให้บริการเพื่อให้ความคิดเห็นเกี่ยวกับข้อมูลการมาถึงจริงของปลายทางตัวกลาง |
actualIntermediateDestinations[] |
อินพุตเท่านั้น เวลาและสถานที่จริงเวลาและสถานที่ที่ลูกค้ามารับลูกค้าจากปลายทางระดับกลาง ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการรับสินค้าจริงที่ปลายทางระดับกลาง |
dropoffPoint |
สถานที่ที่ลูกค้าระบุว่าจะออกจากร้าน |
actualDropoffPoint |
อินพุตเท่านั้น เวลาและสถานที่จริงเวลาและสถานที่ที่ลูกค้าออกจากร้าน ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการออกตามจริง |
dropoffTime |
เอาต์พุตเท่านั้น ไม่ว่าจะเป็นเวลาในอนาคตโดยประมาณที่จะลงจอดที่จุดหมายของคนขับหรือเวลาจริงที่ลงจากเรือ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
remainingWaypoints[] |
เอาต์พุตเท่านั้น เส้นทางแบบเต็มจากตำแหน่งปัจจุบันไปยังจุดส่ง (รวม) เส้นทางนี้อาจมีจุดอ้างอิงจากการเดินทางอื่นๆ |
vehicleWaypoints[] |
ฟิลด์นี้รองรับการเรียงลำดับจุดอ้างอิงสำหรับการเดินทางด้วยตัวเอง โดยจะมีจุดระหว่างทางที่เหลือทั้งหมดสำหรับรถที่กำหนดไว้ ตลอดจนจุดจอดรับและส่งรถสำหรับการเดินทางครั้งนี้ หากไม่มีการกำหนดการเดินทางให้กับรถ Fleet Engine จะไม่สนใจช่องนี้ เพื่อความเป็นส่วนตัว ฟิลด์นี้จะป้อนข้อมูลโดยเซิร์ฟเวอร์ในการเรียก |
route[] |
เอาต์พุตเท่านั้น เส้นทางที่คาดไว้สำหรับการเดินทางนี้ไปยังทางเข้าแรกในจุดที่เหลือ โปรดทราบว่าการชี้ทางแรกอาจเป็นของการเดินทางอื่น |
currentRouteSegment |
เอาต์พุตเท่านั้น เส้นทางที่เข้ารหัสไปยังจุดอ้างอิงถัดไป หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น ยังไม่รองรับการถอดรหัส |
currentRouteSegmentVersion |
เอาต์พุตเท่านั้น ระบุเวลาล่าสุดที่มีการแก้ไขเส้นทาง หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
currentRouteSegmentTraffic |
เอาต์พุตเท่านั้น ระบุสภาพการจราจรบน หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น |
currentRouteSegmentTrafficVersion |
เอาต์พุตเท่านั้น ระบุครั้งล่าสุดที่แก้ไข หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
currentRouteSegmentEndPoint |
เอาต์พุตเท่านั้น จุดอ้างอิงที่ |
remainingDistanceMeters |
เอาต์พุตเท่านั้น ระยะทางการขับขี่ที่เหลืออยู่ในช่อง |
etaToFirstWaypoint |
เอาต์พุตเท่านั้น เวลาถึงโดยประมาณไปยังจุดอ้างอิงถัดไป (รายการแรกในช่อง การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
remainingTimeToFirstWaypoint |
เอาต์พุตเท่านั้น ระยะเวลาตั้งแต่ที่ระบบส่งข้อมูลการเดินทางกลับไปที่เวลาใน ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
remainingWaypointsVersion |
เอาต์พุตเท่านั้น ระบุครั้งสุดท้ายที่มีการเปลี่ยนแปลง การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
remainingWaypointsRouteVersion |
เอาต์พุตเท่านั้น ระบุเวลาล่าสุดที่แก้ไข การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
numberOfPassengers |
เปลี่ยนแปลงไม่ได้ ระบุจำนวนผู้โดยสารในการเดินทางครั้งนี้และไม่รวมคนขับ ยานพาหนะต้องมีความจุที่ว่างอยู่เพื่อส่งคืนในการตอบกลับจาก |
lastLocation |
เอาต์พุตเท่านั้น ระบุตำแหน่งที่รายงานล่าสุดของยานพาหนะในเส้นทาง |
lastLocationSnappable |
เอาต์พุตเท่านั้น ระบุว่าสามารถสแนป |
view |
ข้อมูลย่อยของช่องการเดินทางที่มีการเติมข้อมูลและวิธีที่ระบบควรตีความ |
TripStatus
สถานะของการเดินทางที่แสดงความคืบหน้า
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
ค่าเริ่มต้น ใช้สำหรับสถานะการเดินทางที่ไม่ระบุหรือไม่รู้จัก |
NEW |
การเดินทางที่สร้างขึ้นใหม่ |
ENROUTE_TO_PICKUP |
คนขับกำลังอยู่ระหว่างทางไปยังจุดรับสินค้า |
ARRIVED_AT_PICKUP |
คนขับได้มาถึงจุดรับสินค้าแล้ว |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
คนขับได้มาถึงปลายทางระดับกลางและกำลังรอคนขับอยู่ |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
คนขับกำลังอยู่ระหว่างทางไปยังจุดหมายกลาง (ไม่ใช่จุดส่ง) |
ENROUTE_TO_DROPOFF |
คนขับมารับผู้โดยสารแล้วและอยู่ระหว่างทางไปยังจุดหมายถัดไป |
COMPLETE |
ผู้โดยสารลงจากรถและการเดินทางเสร็จสมบูรณ์แล้ว |
CANCELED |
การเดินทางถูกยกเลิกก่อนที่คนขับ ผู้โดยสาร หรือผู้ให้บริการร่วมเดินทางจะมารับ |
StopLocation
ตำแหน่งจริงที่จุดแวะ (รับสินค้า/คืน)
การแสดง JSON |
---|
{
"point": {
object ( |
ช่อง | |
---|---|
point |
ต้องระบุ ระบุตำแหน่งจริง |
timestamp |
ระบุเวลาที่หยุด การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
stopTime |
อินพุตเท่านั้น เลิกใช้งานแล้ว ใช้ช่องการประทับเวลา การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
TripView
ตัวเลือกสำหรับชุดช่องการเดินทางต่างๆ ในการตอบกลับจาก trips.get
โปรดดู AIP-157 สำหรับบริบท ระบบมีแนวโน้มที่จะเพิ่มยอดดูอื่นๆ เข้ามาด้วย
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
ค่าเริ่มต้น API จะตั้งค่าเริ่มต้นเป็นข้อมูลพร็อพเพอร์ตี้ SDK สําหรับความเข้ากันได้แบบย้อนหลัง เราขอแนะนำให้ลูกค้าเลือก TripView ที่ไม่ใช่ SDK เพื่อความเสถียรและให้การสนับสนุน |
SDK |
รวมถึงฟิลด์ที่อาจตีความไม่ได้หรือรองรับการใช้ไลบรารีที่เผยแพร่ต่อสาธารณะ |
JOURNEY_SHARING_V1S |
ระบบจะสร้างช่องการเดินทางสำหรับกรณีการใช้งานการแชร์เส้นทางการท่องเว็บ ข้อมูลพร็อพเพอร์ตี้นี้มีไว้สำหรับการสื่อสารแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ |
วิธีการ |
|
---|---|
|
สร้างการเดินทางใน Fleet Engine และส่งคืนการเดินทางใหม่ |
|
ดูข้อมูลเกี่ยวกับการเดินทางครั้งเดียว |
|
รับข้อมูลการเดินทางทั้งหมดสำหรับรถคันใดคันหนึ่ง |
|
อัปเดตข้อมูลการเดินทาง |