REST Resource: providers.trips

{
  "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)
}

string

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

string

รหัสของพาหนะที่ใช้เดินทางในการเดินทางนี้

enum (TripStatus)

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

enum (TripType)

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

object (TerminalLocation)

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

object (StopLocation)

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

object (StopLocation)

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

string (Timestamp format)

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

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

object (TerminalLocation)

จุดแวะระหว่างทาง (นอกเหนือจากการรับและส่ง) โดยในระยะแรกจะไม่รองรับการเดินทางที่มีการแชร์กัน

string (Timestamp format)

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

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

integer

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

object (StopLocation)

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

object (StopLocation)

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

object (TerminalLocation)

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

object (StopLocation)

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

string (Timestamp format)

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

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

object (TripWaypoint)

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

object (TripWaypoint)

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

object (LatLng)

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

string

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

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

string (Timestamp format)

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

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

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

object (ConsumableTrafficPolyline)

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

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

string (Timestamp format)

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

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

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

object (TripWaypoint)

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

integer

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

string (Timestamp format)

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

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

string (Duration format)

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

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

string (Timestamp format)

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

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

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"

integer

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

object (VehicleLocation)

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

boolean

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

enum (TripView)

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

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

ต้องระบุ ระบุตำแหน่งจริง

string (Timestamp format)

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

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

string (Timestamp format)

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

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