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 จะเป็นจุดอ้างอิงเต็มรูปแบบ จุดอ้างอิง 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

ค่าแอตทริบิวต์ที่พิมพ์คู่

{
  "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]