แหล่งข้อมูล: การเดินทาง
ข้อมูลเมตาของการเดินทาง
การแสดง 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[] |
เอาต์พุตเท่านั้น เส้นทางที่คาดไว้สำหรับการเดินทางนี้ไปยังรายการแรกใน Waypoints ที่เหลือ โปรดทราบว่าจุดอ้างอิงแรกอาจเป็นของการเดินทางอื่น |
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 |
ระบบจะป้อนข้อมูลในช่องการเดินทางสําหรับ Use Case การแชร์เส้นทางการท่องเว็บ มุมมองนี้มีไว้สำหรับการสื่อสารระหว่างเซิร์ฟเวอร์ |
เมธอด |
|
---|---|
|
สร้างการเดินทางใน Fleet Engine และส่งกลับการเดินทางใหม่ |
|
รับข้อมูลเกี่ยวกับการเดินทาง 1 ครั้ง |
|
รับข้อมูลการเดินทางทั้งหมดของยานพาหนะหนึ่งๆ |
|
อัปเดตข้อมูลการเดินทาง |