- ทรัพยากร: ยานพาหนะ
- VehicleState
- VehicleAttribute
- VehicleType
- หมวดหมู่
- LicensePlate
- TrafficPolylineData
- VisualTrafficReportPolylineRendering
- RoadStretch
- สไตล์
- NavigationStatus
- DeviceSettings
- LocationPowerSaveMode
- BatteryInfo
- BatteryStatus
- PowerSource
- เมธอด
ทรัพยากร: ยานพาหนะ
ข้อมูลเมตาของรถ
การแสดง JSON |
---|
{ "name": string, "vehicleState": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อที่ไม่ซ้ำกันของยานพาหนะคันนี้ รูปแบบคือ |
vehicleState |
สถานะของรถ |
supportedTripTypes[] |
ประเภทการเดินทางที่ยานพาหนะนี้รองรับ |
currentTrips[] |
เอาต์พุตเท่านั้น รายการ |
lastLocation |
ตำแหน่งที่รายงานล่าสุดของยานพาหนะ |
maximumCapacity |
จำนวนผู้โดยสารทั้งหมดที่ยานพาหนะนี้บรรทุกได้ ผู้ขับจะไม่พิจารณาในค่านี้ ค่านี้ต้องมากกว่าหรือเท่ากับ 1 |
attributes[] |
รายการแอตทริบิวต์ของยานพาหนะ ยานพาหนะมีแอตทริบิวต์ได้สูงสุด 100 รายการและแต่ละแอตทริบิวต์ต้องมีคีย์ที่ไม่ซ้ำกัน |
vehicleType |
ต้องระบุ ประเภทของยานพาหนะนี้ สามารถใช้เพื่อกรองยานพาหนะในผลการค้นหา |
licensePlate |
ข้อมูลป้ายทะเบียนรถ |
route[] |
เลิกใช้งานแล้ว: ใช้ |
currentRouteSegment |
เส้นประกอบที่ระบุเส้นทางที่แอปคนขับต้องการใช้ไปยังจุดอ้างอิงถัดไป รายการนี้จะแสดงใน หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK เท่านั้น ยังไม่รองรับการถอดรหัส |
currentRouteSegmentTraffic |
อินพุตเท่านั้น Fleet Engine ใช้ข้อมูลนี้เพื่อปรับปรุงการแชร์เส้นทาง หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK เท่านั้น |
currentRouteSegmentVersion |
เอาต์พุตเท่านั้น เวลาที่ตั้งไว้ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
currentRouteSegmentEndPoint |
จุดอ้างอิงที่ |
remainingDistanceMeters |
ระยะทางที่เหลือในการขับขี่สำหรับ |
etaToFirstWaypoint |
เวลาถึงโดยประมาณที่รายการแรกในช่อง เมื่ออัปเดตรถ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
remainingTimeSeconds |
อินพุตเท่านั้น เวลาขับรถที่เหลือสำหรับ เมื่ออัปเดตรถ |
waypoints[] |
จุดอ้างอิงที่เหลือที่กำหนดให้กับรถคันนี้ |
waypointsVersion |
เอาต์พุตเท่านั้น ครั้งล่าสุดที่มีการอัปเดตช่อง การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
backToBackEnabled |
ระบุว่าคนขับยอมรับการเดินทางแบบไปกลับหรือไม่ หากอยู่ใน |
navigationStatus |
สถานะการนำทางของรถ |
deviceSettings |
อินพุตเท่านั้น ข้อมูลเกี่ยวกับการตั้งค่าในอุปกรณ์เคลื่อนที่ที่คนขับใช้งาน |
VehicleState
สถานะของ Vehicle
Enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
ค่าเริ่มต้น ใช้สำหรับสถานะของยานพาหนะที่ไม่ได้ระบุหรือไม่รู้จัก |
OFFLINE |
ยานพาหนะนี้ไม่รับการเดินทางใหม่ หมายเหตุ: รถอาจจะยังทำงานต่อไปในสถานะนี้ขณะกำลังเดินทางตามที่กำหนดไว้ |
ONLINE |
ยานพาหนะรับการเดินทางใหม่ |
VehicleAttribute
อธิบายแอตทริบิวต์ของยานพาหนะเป็นคู่คีย์-ค่า สตริง "key:value" ต้องไม่เกิน 256 อักขระ
การแสดง JSON |
---|
{ "key": string, "value": string, // Union field |
ช่อง | |
---|---|
key |
คีย์ของแอตทริบิวต์ คีย์ต้องไม่มีอักขระโคลอน (:) |
value |
ค่าแอตทริบิวต์ |
ฟิลด์สหภาพ vehicle_attribute_value ค่าแอตทริบิวต์อาจเป็นสตริง bool หรือประเภท Double ก็ได้ vehicle_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
stringValue |
ค่าแอตทริบิวต์ที่พิมพ์สตริง หมายเหตุ: ช่องนี้เหมือนกันกับช่อง |
boolValue |
ค่าแอตทริบิวต์ประเภทบูลีน |
numberValue |
ค่าแอตทริบิวต์แบบพิมพ์คู่ |
VehicleType
ประเภทของยานพาหนะ
การแสดง JSON |
---|
{
"category": enum ( |
ช่อง | |
---|---|
category |
หมวดหมู่ประเภทยานพาหนะ |
หมวดหมู่
หมวดหมู่ประเภทยานพาหนะ
Enum | |
---|---|
UNKNOWN |
ค่าเริ่มต้น ใช้สำหรับหมวดหมู่ยานพาหนะที่ไม่ได้ระบุหรือไม่รู้จัก |
AUTO |
รถยนต์ |
TAXI |
ยานพาหนะที่ทำหน้าที่เป็นแท็กซี่ (โดยทั่วไปมีใบอนุญาตหรือได้รับการควบคุม) |
TRUCK |
โดยทั่วไปแล้ว ยานพาหนะที่มีความจุพื้นที่เก็บข้อมูลขนาดใหญ่ |
TWO_WHEELER |
จักรยานยนต์ โมเพ็ด หรือยานพาหนะ 2 ล้ออื่นๆ |
BICYCLE |
การคมนาคมที่ขับเคลื่อนด้วยพลังของมนุษย์ |
PEDESTRIAN |
รถบรรทุกที่เป็นมนุษย์ ปกติแล้วเดินหรือวิ่ง และเดินทางไปตามทางเท้า |
LicensePlate
ข้อมูลป้ายทะเบียนรถ เพื่อหลีกเลี่ยงการจัดเก็บข้อมูลส่วนบุคคลที่สามารถระบุตัวตนได้ มีเพียงข้อมูลขั้นต่ำเกี่ยวกับป้ายทะเบียนรถเท่านั้นที่จะเก็บไว้ในฐานะส่วนหนึ่งของหน่วยงาน
การแสดง JSON |
---|
{ "countryCode": string, "lastCharacter": string } |
ช่อง | |
---|---|
countryCode |
ต้องระบุ รหัสประเทศ/ภูมิภาค CLDR เช่น |
lastCharacter |
ตัวเลขสุดท้ายของป้ายทะเบียนรถหรือ "-1" เพื่อระบุว่าไม่มีค่าตัวเลขอยู่ในป้ายทะเบียน
|
TrafficPolylineData
สภาพการจราจรบนเส้นทางที่ยานพาหนะที่คาดไว้
การแสดง JSON |
---|
{
"trafficRendering": {
object ( |
ช่อง | |
---|---|
trafficRendering |
การแสดงผลแบบเส้นประกอบที่แสดงว่าการจราจรรวดเร็วเพียงใดในทุกภูมิภาคตลอดการเดินทางของลูกค้า 1 ครั้ง |
VisualTrafficReportPolylineRendering
อธิบายวิธีที่ไคลเอ็นต์ควรระบายสีส่วนหนึ่งของเส้นประกอบตามเส้นทาง
การแสดง JSON |
---|
{
"roadStretch": [
{
object ( |
ช่อง | |
---|---|
roadStretch[] |
ไม่บังคับ ถนนทอดยาวที่ควรแสดงผลตามเส้นประกอบ การขยายแผลจะไม่ทับซ้อนกัน และไม่จำเป็นต้องครอบคลุมทั้งเส้นทาง หากไม่มีถนนยืดตามรูปแบบ ลูกค้าควรใช้ค่าเริ่มต้นกับเส้นทาง |
RoadStretch
ถนนหนึ่งเส้นที่ควรแสดง
การแสดง JSON |
---|
{
"style": enum ( |
ช่อง | |
---|---|
style |
ต้องระบุ รูปแบบที่จะใช้ |
offsetMeters |
ต้องระบุ ควรใช้รูปแบบระหว่าง |
lengthMeters |
ต้องระบุ ความยาวของเส้นทางที่จะใช้รูปแบบ |
สไตล์
รูปแบบการจราจร ระบุความเร็วของการจราจร
Enum | |
---|---|
STYLE_UNSPECIFIED |
ไม่ได้เลือกรูปแบบ |
SLOWER_TRAFFIC |
การจราจรหนาแน่นช้าลง |
TRAFFIC_JAM |
มีการจราจรติดขัด |
DeviceSettings
ข้อมูลเกี่ยวกับการตั้งค่าต่างๆ บนอุปกรณ์เคลื่อนที่
การแสดง JSON |
---|
{ "locationPowerSaveMode": enum ( |
ช่อง | |
---|---|
locationPowerSaveMode |
วิธีการตั้งค่าฟีเจอร์ตำแหน่งให้ทํางานในอุปกรณ์เมื่อโหมดประหยัดแบตเตอรี่เปิดอยู่ |
isPowerSaveMode |
ระบุว่าอุปกรณ์อยู่ในโหมดประหยัดพลังงานหรือไม่ |
isInteractive |
ระบุว่าอุปกรณ์อยู่ในสถานะอินเทอร์แอกทีฟหรือไม่ |
batteryInfo |
ข้อมูลเกี่ยวกับสถานะแบตเตอรี่ |
LocationPowerSaveMode
วิธีกำหนดค่าฟีเจอร์ตำแหน่งให้ทำงานบนอุปกรณ์เคลื่อนที่เมื่อฟีเจอร์ "ประหยัดแบตเตอรี่" ของอุปกรณ์เปิดอยู่ (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
โหมด PowerSaveMode ที่ไม่ได้กำหนด |
LOCATION_MODE_NO_CHANGE |
ผู้ให้บริการตำแหน่งไม่ควรได้รับผลกระทบจากโหมดประหยัดแบตเตอรี่หรือโหมดประหยัดแบตเตอรี่ปิดอยู่ |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
ควรปิดใช้ผู้ให้บริการตำแหน่งที่ใช้ GPS เมื่อโหมดประหยัดแบตเตอรี่เปิดอยู่และอุปกรณ์ไม่มีการโต้ตอบ |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
ควรปิดใช้ผู้ให้บริการตำแหน่งทั้งหมดเมื่อโหมดประหยัดแบตเตอรี่เปิดอยู่และอุปกรณ์ไม่มีการโต้ตอบ |
LOCATION_MODE_FOREGROUND_ONLY |
ผู้ให้บริการตำแหน่งทั้งหมดจะยังคงใช้งานได้ แต่ควรแก้ไขตำแหน่งสำหรับแอปที่ทำงานอยู่เบื้องหน้าเท่านั้น |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
ระบบจะไม่ปิดตำแหน่ง แต่ LocationManager จะควบคุมคำขอทั้งหมดที่ส่งถึงผู้ให้บริการเมื่ออุปกรณ์ไม่มีการโต้ตอบ |
BatteryInfo
ข้อมูลเกี่ยวกับแบตเตอรี่ของอุปกรณ์
การแสดง JSON |
---|
{ "batteryStatus": enum ( |
ช่อง | |
---|---|
batteryStatus |
สถานะของแบตเตอรี่ ไม่ว่าจะเต็มหรือชาร์จอยู่ เป็นต้น |
powerSource |
สถานะของแหล่งพลังงานแบตเตอรี่ |
batteryPercentage |
เปอร์เซ็นต์แบตเตอรี่ปัจจุบัน [0-100] |
BatteryStatus
สถานะของแบตเตอรี่ ไม่ว่าจะเต็มหรือชาร์จอยู่ เป็นต้น
Enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
ไม่ทราบสถานะแบตเตอรี่ |
BATTERY_STATUS_CHARGING |
กำลังชาร์จแบตเตอรี่ |
BATTERY_STATUS_DISCHARGING |
แบตเตอรี่กำลังคายประจุ |
BATTERY_STATUS_FULL |
แบตเตอรี่เต็ม |
BATTERY_STATUS_NOT_CHARGING |
แบตเตอรี่ไม่ชาร์จ |
BATTERY_STATUS_POWER_LOW |
แบตเตอรี่เหลือน้อย |
PowerSource
ประเภทของที่ชาร์จที่ใช้ชาร์จแบตเตอรี่
Enum | |
---|---|
UNKNOWN_POWER_SOURCE |
ไม่ทราบแหล่งพลังงาน |
POWER_SOURCE_AC |
แหล่งจ่ายไฟเป็นที่ชาร์จ AC |
POWER_SOURCE_USB |
แหล่งจ่ายไฟเป็นพอร์ต USB |
POWER_SOURCE_WIRELESS |
แหล่งจ่ายไฟเป็นแบบไร้สาย |
POWER_SOURCE_UNPLUGGED |
ไม่ได้เสียบปลั๊กแบตเตอรี่ไว้ |
วิธีการ |
|
---|---|
|
ยกตัวอย่างยานพาหนะคันใหม่ที่เชื่อมโยงกับผู้ให้บริการร่วมเดินทางหรือบริการนำส่งแบบออนดีมานด์ |
|
ส่งคืนยานพาหนะจาก Fleet Engine |
|
ส่งคืนรายการยานพาหนะที่ใส่เลขหน้าซึ่งเชื่อมโยงกับผู้ให้บริการที่ตรงกับตัวเลือกคำขอ |
|
แสดงรายการยานพาหนะที่ตรงกับตัวเลือกคำขอ |
|
เขียนข้อมูลรถที่อัปเดตไปยัง Fleet Engine |
|
อัปเดตแอตทริบิวต์ของยานพาหนะบางส่วน |