REST Resource: providers.trips

แหล่งข้อมูล: การเดินทาง

ข้อมูลเมตาของการเดินทาง

การแสดง JSON 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
ช่อง
name

string

เอาต์พุตเท่านั้น ในรูปแบบ "providers/{provider}/trips/{trip}"
vehicleId

string

รหัสยานพาหนะที่เดินทางครั้งนี้
tripStatus

enum (TripStatus)

สถานะปัจจุบันของการเดินทาง
tripType

enum (TripType)

ประเภทของการเดินทาง
pickupPoint

object (TerminalLocation)

สถานที่ที่ลูกค้าระบุว่าจะมารับ
actualPickupPoint

object (StopLocation)

อินพุตเท่านั้น สถานที่จริงเวลาและสถานที่ที่ลูกค้ามารับ ช่องนี้มีไว้สําหรับผู้ให้บริการเพื่อแสดงความคิดเห็นเกี่ยวกับข้อมูลการรับสินค้าจริง
actualPickupArrivalPoint

object (StopLocation)

อินพุตเท่านั้น เวลาและสถานที่จริงที่คนขับมาถึงจุดรับ ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการมาถึงจริง ณ จุดรับรถ
pickupTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาในอนาคตโดยประมาณที่จะมารับผู้โดยสารหรือเวลาจริงที่ไปรับผู้โดยสาร

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
intermediateDestinations[]

object (TerminalLocation)

จุดแวะระหว่างกลางเพื่อให้คำขอการเดินทาง (นอกเหนือจากบริการไปรับและส่งคืน) ในช่วงแรก ระบบจะไม่รองรับการเดินทางที่แชร์ร่วมกัน
intermediateDestinationsVersion

string (Timestamp format)

ระบุเวลาที่แก้ไข intermediateDestinations ครั้งล่าสุด เซิร์ฟเวอร์ของคุณควรแคชค่านี้และส่งไปยัง UpdateTripRequest เมื่ออัปเดต intermediateDestinationIndex เพื่อให้มั่นใจว่า intermediateDestinations จะไม่เปลี่ยนแปลง

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
intermediateDestinationIndex

integer

เมื่อ TripStatus คือ ENROUTE_TO_INTERMEDIATE_DESTINATION ตัวเลขระหว่าง [0..N-1] แสดงให้เห็นว่ารถจะข้ามจุดหมายกลางถัดไป เมื่อ TripStatus คือ ARRIVED_AT_INTERMEDIATE_DESTINATION ตัวเลขระหว่าง [0..N-1] แสดงให้เห็นว่ารถอยู่ตรงปลายทางใด ซึ่งผู้ให้บริการเป็นผู้กำหนดค่านี้ หากไม่มี intermediateDestinations ระบบจะไม่สนใจช่องนี้
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

อินพุตเท่านั้น เวลาและตำแหน่งจริงที่คนขับมาถึงจุดหมายระดับกลาง ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการมาถึงที่จุดหมายระดับกลาง
actualIntermediateDestinations[]

object (StopLocation)

อินพุตเท่านั้น เวลาและสถานที่จริงเวลาและสถานที่ที่ลูกค้าไปรับจากปลายทางกลาง ช่องนี้มีไว้สําหรับผู้ให้บริการเพื่อแสดงความคิดเห็นเกี่ยวกับข้อมูลการรับสินค้าที่ปลายทางขั้นกลาง
dropoffPoint

object (TerminalLocation)

สถานที่ที่ลูกค้าระบุว่าจะไปส่ง
actualDropoffPoint

object (StopLocation)

อินพุตเท่านั้น เวลาและสถานที่จริงเวลาและสถานที่ส่งลูกค้า ช่องนี้มีไว้สําหรับผู้ให้บริการเพื่อให้ความคิดเห็นเกี่ยวกับข้อมูลการออกจากไซต์จริง
dropoffTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาในอนาคตโดยประมาณที่ผู้โดยสารจะลงจอดที่จุดหมายสุดท้าย หรือเวลาจริงที่ลงจอดที่จุดหมาย

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
remainingWaypoints[]

object (TripWaypoint)

เอาต์พุตเท่านั้น เส้นทางเต็มจากตำแหน่งปัจจุบันไปยังจุดส่ง รวมวันที่แล้ว เส้นทางนี้อาจมีจุดอ้างอิงจากการเดินทางอื่นๆ
vehicleWaypoints[]

object (TripWaypoint)

ฟิลด์นี้รองรับการจัดลำดับจุดอ้างอิงสำหรับการเดินทางด้วยตนเอง ซึ่งประกอบด้วยจุดอ้างอิงที่เหลืออยู่ทั้งหมดสำหรับยานพาหนะที่กำหนด รวมถึงจุดอ้างอิงจุดรับและส่งของสำหรับการเดินทางนี้ หากไม่ได้กำหนดการเดินทางให้กับยานพาหนะ Fleet Engine จะไม่สนใจช่องนี้ เพื่อความเป็นส่วนตัว ช่องนี้จะเติมข้อมูลโดยเซิร์ฟเวอร์ในการเรียก trips.update และ trips.create เท่านั้น ไม่ใช่ในการเรียก trips.get
route[]

object (LatLng)

เอาต์พุตเท่านั้น เส้นทางที่คาดไว้สำหรับการเดินทางนี้ไปยังรายการแรกใน Waypoints ที่เหลือ โปรดทราบว่าจุดอ้างอิงแรกอาจเป็นของการเดินทางอื่น
currentRouteSegment

string

เอาต์พุตเท่านั้น เส้นทางที่เข้ารหัสไปยังจุดอ้างอิงถัดไป

หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น ยังไม่รองรับการถอดรหัส
currentRouteSegmentVersion

string (Timestamp format)

เอาต์พุตเท่านั้น ระบุเวลาล่าสุดที่เส้นทางได้รับการแก้ไข

หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

เอาต์พุตเท่านั้น ระบุสภาพการจราจรตาม currentRouteSegment เมื่อมีข้อมูล

หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น
currentRouteSegmentTrafficVersion

string (Timestamp format)

เอาต์พุตเท่านั้น ระบุเวลาที่แก้ไข currentRouteSegmentTraffic ครั้งล่าสุด

หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
currentRouteSegmentEndPoint

object (TripWaypoint)

เอาต์พุตเท่านั้น จุดอ้างอิงที่ currentRouteSegment สิ้นสุด
remainingDistanceMeters

integer

เอาต์พุตเท่านั้น ระยะทางขับรถที่เหลือในช่อง currentRouteSegment ไม่ได้ระบุค่าหากการเดินทางไม่ได้ให้กับยานพาหนะ หรือการเดินทางเสร็จสมบูรณ์หรือยกเลิกแล้ว
etaToFirstWaypoint

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาถึงโดยประมาณที่จะถึงจุดอ้างอิงถัดไป (รายการแรกในช่อง remainingWaypoints) ไม่มีการระบุค่านี้หากการเดินทางไม่ได้ให้กับยานพาหนะ หรือการเดินทางไม่มีการใช้งาน (เสร็จสมบูรณ์หรือยกเลิก)

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
remainingTimeToFirstWaypoint

string (Duration format)

เอาต์พุตเท่านั้น ระยะเวลาจากการส่งข้อมูลการเดินทางกลับไปยังเวลาใน Trip.eta_to_first_waypoint ไม่มีการระบุค่านี้หากการเดินทางไม่ได้ให้กับยานพาหนะ หรือการเดินทางไม่มีการใช้งาน (เสร็จสมบูรณ์หรือยกเลิก)

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"
remainingWaypointsVersion

string (Timestamp format)

เอาต์พุตเท่านั้น ระบุเวลาล่าสุดที่มีการเปลี่ยนแปลง remainingWaypoints (มีการเพิ่ม นำออก หรือเปลี่ยนแปลงจุดอ้างอิง)

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
remainingWaypointsRouteVersion

string (Timestamp format)

เอาต์พุตเท่านั้น ระบุเวลาที่แก้ไข remainingWaypoints.path_to_waypoint และ remainingWaypoints.traffic_to_waypoint ครั้งล่าสุด แอปไคลเอ็นต์ควรแคชค่านี้และส่งผ่านค่าใน GetTripRequest เพื่อให้มั่นใจว่าระบบจะส่งคืนเส้นทางและการเข้าชมของ remainingWaypoints ในกรณีที่มีการอัปเดตเท่านั้น

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
numberOfPassengers

integer

เปลี่ยนแปลงไม่ได้ ระบุจำนวนผู้โดยสารในการเดินทางครั้งนี้และไม่รวมคนขับ ยานพาหนะต้องมีความจุจึงจะส่งคืนได้ในการตอบกลับvehicles.search
lastLocation

object (VehicleLocation)

เอาต์พุตเท่านั้น ระบุตำแหน่งล่าสุดที่รายงานของยานพาหนะตลอดเส้นทาง
lastLocationSnappable

boolean

เอาต์พุตเท่านั้น ระบุว่าสามารถจัด lastLocation ของพาหนะกับ CurrentRouteSegment ได้หรือไม่ เท็จ หากไม่มี lastLocation หรือ currentRouteSegment คำนวณโดย Fleet Engine ระบบจะไม่สนใจการอัปเดตใดๆ จากลูกค้า
view

enum (TripView)

เซ็ตย่อยของช่องการเดินทางที่มีการป้อนข้อมูล และวิธีการแปลค่า

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 (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
ช่อง
point

object (LatLng)

ต้องระบุ แสดงถึงตำแหน่งจริง
timestamp

string (Timestamp format)

ระบุเวลาที่หยุด

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
stopTime
(deprecated)

string (Timestamp format)

อินพุตเท่านั้น เลิกใช้งานแล้ว ใช้ช่องการประทับเวลา

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

TripView

ตัวเลือกสำหรับช่องการเดินทางชุดต่างๆ ในการตอบกลับจาก trips.get โปรดดู AIP-157 สำหรับบริบท มีแนวโน้มที่จะเพิ่มการแสดงผลเพิ่มเติม

Enum
TRIP_VIEW_UNSPECIFIED ค่าเริ่มต้น สำหรับความเข้ากันได้แบบย้อนหลัง API จะตั้งค่าเป็นมุมมอง SDK โดยค่าเริ่มต้น เราขอแนะนำให้ลูกค้าเลือก TripView ที่ไม่ใช่ SDK เพื่อความเสถียรและการสนับสนุน
SDK รวมฟิลด์ที่อาจตีความไม่ได้หรือไม่รองรับเมื่อใช้ไลบรารีที่เผยแพร่ต่อสาธารณะ
JOURNEY_SHARING_V1S ระบบจะป้อนข้อมูลในช่องการเดินทางสําหรับ Use Case การแชร์เส้นทางการท่องเว็บ มุมมองนี้มีไว้สำหรับการสื่อสารระหว่างเซิร์ฟเวอร์

เมธอด

create

 สร้างการเดินทางใน Fleet Engine และส่งกลับการเดินทางใหม่

get

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

update

 อัปเดตข้อมูลการเดินทาง