REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

เอาต์พุตเท่านั้น ชื่อที่ไม่ซ้ำกันสำหรับยานพาหนะนี้ รูปแบบคือ providers/{provider}/vehicles/{vehicle}

enum (VehicleState)

สถานะของยานพาหนะ

enum (TripType)

ประเภทการเดินทางที่ยานพาหนะนี้รองรับ

string

เอาต์พุตเท่านั้น รายการ tripId สำหรับการเดินทางที่กำหนดให้กับยานพาหนะนี้ในปัจจุบัน

object (VehicleLocation)

ตำแหน่งล่าสุดของยานพาหนะที่รายงาน

integer

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

object (VehicleAttribute)

รายการแอตทริบิวต์ของยานพาหนะ ยานพาหนะหนึ่งๆ มีแอตทริบิวต์ได้ไม่เกิน 100 รายการ และแอตทริบิวต์แต่ละรายการต้องมีคีย์ที่ไม่ซ้ำกัน

object (VehicleType)

ต้องระบุ ประเภทของยานพาหนะนี้ ใช้เพื่อกรองยานพาหนะในผลลัพธ์ vehicles.search ได้ รวมถึงส่งผลต่อการคำนวณเวลาถึงโดยประมาณและเส้นทางด้วย

object (LicensePlate)

ข้อมูลป้ายทะเบียนของยานพาหนะ

object (TerminalLocation)

เลิกใช้งานแล้ว: ให้ใช้ Vehicle.waypoints แทน

string

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

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

object (TrafficPolylineData)

อินพุตเท่านั้น ฟีเจอร์ Fleet Engine จะใช้ข้อมูลนี้เพื่อปรับปรุงการแชร์เส้นทาง หมายเหตุ: ช่องนี้มีไว้สำหรับ Driver SDK เท่านั้น

string (Timestamp format)

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

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

object (TripWaypoint)

จุดสังเกตที่ currentRouteSegment สิ้นสุด ซึ่งคนขับสามารถระบุในvehicles.update call ได้ทั้งเป็นจุดสังเกตของการเดินทางแบบเต็ม LatLng หรือเป็นLatLngสุดท้ายของcurrentRouteSegment จากนั้น Fleet Engine จะพยายามหาค่าโดยประมาณของจุดอ้างอิงที่แท้จริงหากไม่ได้ระบุอย่างครบถ้วน ระบบจะไม่สนใจช่องนี้ในการเรียกใช้ vehicles.update เว้นแต่จะระบุ currentRouteSegment ด้วย

integer

ระยะทางขับรถที่เหลือสำหรับ currentRouteSegment ค่านี้ส่งคืนในสกุลเงิน Trip.remaining_distance_meters สำหรับการเดินทางที่ใช้งานอยู่ทั้งหมดที่มอบหมายให้กับยานพาหนะด้วย ไม่มีการระบุค่านี้หากช่อง currentRouteSegment ว่างเปล่า

string (Timestamp format)

เวลาถึงจุดหมายโดยประมาณไปยังรายการแรกในช่อง waypoints ระบบจะไม่ระบุค่าหากช่อง waypoints หรือช่อง Vehicle.current_route_segment ว่างเปล่า

เมื่ออัปเดตยานพาหนะ remainingTimeSeconds จะมีความสำคัญเหนือกว่า etaToFirstWaypoint ในคำขอเดียวกัน

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

integer

อินพุตเท่านั้น ระยะเวลาขับรถที่เหลืออยู่สำหรับ currentRouteSegment ระบบจะไม่ระบุค่าหากช่อง waypoints หรือช่อง Vehicle.current_route_segment ว่างเปล่า ค่านี้ควรตรงกับ etaToFirstWaypoint - current_time หากทุกฝ่ายใช้นาฬิกาเดียวกัน

เมื่ออัปเดตยานพาหนะ remainingTimeSeconds จะมีความสำคัญเหนือกว่า etaToFirstWaypoint ในคำขอเดียวกัน

object (TripWaypoint)

จุดแวะพักที่เหลือซึ่งกำหนดให้กับยานพาหนะนี้

string (Timestamp format)

เอาต์พุตเท่านั้น ครั้งล่าสุดที่มีการอัปเดตช่อง waypoints ไคลเอ็นต์ควรแคชค่านี้และส่งค่าใน GetVehicleRequest เพื่อให้ระบบแสดงผลเฉพาะช่อง waypoints หากมีการอัปเดตเท่านั้น

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

boolean

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

enum (NavigationStatus)

สถานะการนำทางของยานพาหนะ

object (DeviceSettings)

อินพุตเท่านั้น ข้อมูลเกี่ยวกับการตั้งค่าในอุปกรณ์เคลื่อนที่ที่ผู้ขับขี่ใช้

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

คีย์ของแอตทริบิวต์ คีย์ต้องไม่มีอักขระโคลอน (:)

string

ค่าแอตทริบิวต์

string

ค่าแอตทริบิวต์ที่พิมพ์โดยสตริง

หมายเหตุ: ข้อมูลนี้เหมือนกับช่อง value ซึ่งในที่สุดแล้วจะเลิกใช้งาน สำหรับวิธีการสร้างหรืออัปเดต คุณจะใช้ฟิลด์ใดก็ได้ แต่เราขอแนะนำอย่างยิ่งให้ใช้ stringValue หากตั้งค่าทั้ง stringValue และ value ค่าทั้งสองต้องเหมือนกัน ไม่เช่นนั้นระบบจะแสดงข้อผิดพลาด ระบบจะป้อนข้อมูลทั้ง 2 ช่องไว้ในคำตอบ

boolean

ค่าแอตทริบิวต์ที่พิมพ์ด้วยบูลีน

number

ค่าแอตทริบิวต์ประเภท Double

{
  "category": enum (Category)
}

enum (Category)

หมวดหมู่ประเภทยานพาหนะ

{
  "countryCode": string,
  "lastCharacter": string
}

string

ต้องระบุ รหัสประเทศ/ภูมิภาคของ CLDR เช่น US สำหรับสหรัฐอเมริกา หรือ IN สำหรับอินเดีย

string

ตัวเลขสุดท้ายของป้ายทะเบียนหรือ "-1" เพื่อระบุว่าไม่มีค่าตัวเลขในป้ายทะเบียน

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

การแสดงผลเส้นประกอบของความเร็วการจราจรสำหรับทุกภูมิภาคตลอดเส้นทางการขับขี่ของลูกค้า

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

ไม่บังคับ ส่วนของถนนที่ควรแสดงผลตามเส้นประกอบ เราไม่รับประกันว่าช่วงจะไม่ทับซ้อนกัน และช่วงไม่จำเป็นต้องครอบคลุมทั้งเส้นทาง

หากไม่มีส่วนของถนนที่จะจัดสไตล์ ไคลเอ็นต์ควรใช้ค่าเริ่มต้นสำหรับเส้นทาง

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

ต้องระบุ รูปแบบที่จะใช้

integer

ต้องระบุ ควรใช้สไตล์ระหว่าง [offsetMeters, offsetMeters + lengthMeters)

integer

ต้องระบุ ความยาวของเส้นทางที่จะใช้รูปแบบ

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

การตั้งค่าลักษณะการทำงานของฟีเจอร์ตำแหน่งในอุปกรณ์เมื่อเปิดโหมดประหยัดแบตเตอรี่

boolean

ระบุว่าอุปกรณ์อยู่ในโหมดประหยัดพลังงานหรือไม่

boolean

ระบุว่าอุปกรณ์อยู่ในสถานะอินเทอร์แอกทีฟหรือไม่

object (BatteryInfo)

ข้อมูลเกี่ยวกับสถานะแบตเตอรี่

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

สถานะของแบตเตอรี่ ไม่ว่าจะเต็มหรือชาร์จอยู่ ฯลฯ

enum (PowerSource)

สถานะแหล่งจ่ายไฟจากแบตเตอรี่

number

เปอร์เซ็นต์แบตเตอรี่ปัจจุบัน [0-100]