Package maps.fleetengine.v1

ดัชนี

TripService

บริการจัดการการเดินทาง

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

rpc GetTrip(GetTripRequest) returns (Trip)

ดูข้อมูลเกี่ยวกับการเดินทาง 1 ครั้ง
ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

รายงานการใช้งานการเดินทางที่เรียกเก็บเงินได้
SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

ดูการเดินทางทั้งหมดของยานพาหนะหนึ่งๆ
UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

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

VehicleService

บริการจัดการยานพาหนะ

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

สร้างอินสแตนซ์ยานพาหนะใหม่ซึ่งเชื่อมโยงกับผู้ให้บริการขนส่งหรือแชร์รถแบบออนดีมานด์ Vehicle แต่ละรายการต้องมีรหัสยานพาหนะที่ไม่ซ้ำกัน

ต้องกรอกข้อมูลในช่อง Vehicle ต่อไปนี้เมื่อสร้าง Vehicle

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

ระบบจะไม่สนใจฟิลด์ Vehicle ต่อไปนี้เมื่อสร้าง Vehicle

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

ช่องอื่นๆ ทั้งหมดเป็นตัวเลือกและจะใช้ก็ต่อเมื่อมีการให้ข้อมูล
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

แสดงผลยานพาหนะจากเครื่องมือจัดการฟลีต
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

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

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

แสดงรายการยานพาหนะที่ตรงกับตัวเลือกคำขอ
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

เขียนข้อมูลยานพาหนะที่อัปเดตแล้วลงใน Fleet Engine

เมื่ออัปเดต Vehicle คุณจะอัปเดตฟิลด์ต่อไปนี้ไม่ได้เนื่องจากเซิร์ฟเวอร์เป็นผู้จัดการ

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

นอกจากนี้ คุณจะอัปเดตยานพาหนะ name ไม่ได้

หากอัปเดตช่อง attributes ระบบจะแทนที่แอตทริบิวต์ทั้งหมดของยานพาหนะด้วยแอตทริบิวต์ที่ระบุในคำขอ หากต้องการอัปเดตเฉพาะบางแอตทริบิวต์ โปรดดูวิธีการ UpdateVehicleAttributes ในทำนองเดียวกัน ฟิลด์ waypoints ก็สามารถอัปเดตได้ แต่ต้องมีจุดแวะพักทั้งหมดที่อยู่ในยานพาหนะในขณะนั้นและไม่มีจุดแวะพักอื่นๆ
UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

อัปเดตแอตทริบิวต์ของยานพาหนะบางส่วน ระบบจะอัปเดตเฉพาะแอตทริบิวต์ที่ระบุไว้ในคำขอเท่านั้น โดยจะไม่เปลี่ยนแปลงแอตทริบิวต์อื่นๆ หมายเหตุ: การดำเนินการนี้จะแตกต่างออกไปใน UpdateVehicle ซึ่งระบบจะแทนที่ช่อง attributes ทั้งหมดด้วยช่องใน UpdateVehicleRequest และจะนําแอตทริบิวต์ที่ไม่ได้อยู่ในคําขอออก

BatteryInfo

ข้อมูลเกี่ยวกับแบตเตอรี่ของอุปกรณ์

ช่อง
battery_status

BatteryStatus

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

PowerSource

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

float

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

BatteryStatus

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

Enum
UNKNOWN_BATTERY_STATUS ไม่ทราบสถานะแบตเตอรี่
BATTERY_STATUS_CHARGING กำลังชาร์จแบตเตอรี่
BATTERY_STATUS_DISCHARGING แบตเตอรี่กำลังคายประจุ
BATTERY_STATUS_FULL แบตเตอรี่เต็ม
BATTERY_STATUS_NOT_CHARGING แบตเตอรี่ไม่ชาร์จ
BATTERY_STATUS_POWER_LOW แบตเตอรี่เหลือน้อย

BillingPlatformIdentifier

ชุดค่าที่ระบุว่าคำขอมาจากแพลตฟอร์มใด

Enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED ค่าเริ่มต้น ใช้สำหรับแพลตฟอร์มที่ไม่ระบุ
SERVER แพลตฟอร์มนี้เป็นเซิร์ฟเวอร์ไคลเอ็นต์
WEB แพลตฟอร์มคือเว็บเบราว์เซอร์
ANDROID แพลตฟอร์มคืออุปกรณ์เคลื่อนที่ Android
IOS แพลตฟอร์มคืออุปกรณ์เคลื่อนที่ iOS
OTHERS แพลตฟอร์มอื่นๆ ที่ไม่ได้ระบุไว้ในรายการนี้

ConsumableTrafficPolyline

ความหนาแน่นของการจราจรตามเส้นทางของยานพาหนะ

ช่อง
speed_reading_interval[]

SpeedReadingInterval

ความเร็วการจราจรตลอดเส้นทางจากจุดสังเกตก่อนหน้าไปยังจุดสังเกตปัจจุบัน
encoded_path_to_waypoint

string

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

CreateTripRequest

ข้อความคําขอ CreateTrip

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
trip_id

string

ต้องระบุ รหัสการเดินทางที่ไม่ซ้ำกัน โดยมีข้อจํากัดต่อไปนี้

  • ต้องเป็นสตริง Unicode ที่ถูกต้อง
  • จำกัดความยาวสูงสุดไว้ที่ 64 อักขระ
  • แปลงตามรูปแบบการแปลง Unicode C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้ /, :, ?, , หรือ #
trip

Trip

ต้องระบุ เอนทิตีการเดินทางที่จะสร้าง

เมื่อสร้างการเดินทาง คุณจะต้องกรอกข้อมูลในช่องต่อไปนี้

  • trip_type
  • pickup_point

ระบบจะใช้ฟิลด์ต่อไปนี้หากคุณระบุ

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

ระบบจะละเว้นช่องการเดินทางอื่นๆ ทั้งหมด เช่น การเดินทางทั้งหมดเริ่มต้นด้วย trip_status ของ NEW แม้ว่าคุณจะส่ง trip_status ของ CANCELED ในคําขอสร้างก็ตาม

เฉพาะการเดินทาง EXCLUSIVE เท่านั้นที่รองรับ intermediate_destinations

เมื่อตั้งค่า vehicle_id สำหรับการเดินทางที่แชร์ คุณต้องระบุรายการ Trip.vehicle_waypoints เพื่อระบุลำดับของจุดแวะพักที่เหลือสำหรับยานพาหนะ มิเช่นนั้นระบบจะกำหนดลำดับจุดแวะพักไม่ได้

เมื่อคุณระบุ Trip.vehicle_waypoints รายการต้องมีจุดแวะพักที่เหลือทั้งหมดของการเดินทางของยานพาหนะ โดยไม่มีจุดแวะพักเพิ่มเติม คุณต้องจัดลําดับจุดแวะพักเหล่านี้เพื่อให้จุดรับส่งผู้โดยสารอยู่ก่อนจุดหมายพักกลาง และจุดหมายพักกลางทั้งหมดอยู่ก่อนจุดส่งผู้โดยสาร จุดแวะพักของการเดินทาง EXCLUSIVE ต้องไม่ซ้อนทับกับการเดินทางอื่นๆ

ระบบจะใช้ฟิลด์ trip_id, waypoint_type และ location และจะไม่สนใจฟิลด์ TripWaypoint อื่นๆ ทั้งหมดใน vehicle_waypoints

CreateVehicleRequest

CreateVehicle คำขอส่งข้อความ

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
vehicle_id

string

ต้องระบุ รหัสยานพาหนะที่ซ้ำกัน โดยมีข้อจํากัดต่อไปนี้

  • ต้องเป็นสตริง Unicode ที่ถูกต้อง
  • จำกัดความยาวสูงสุดไว้ที่ 64 อักขระ
  • แปลงตามรูปแบบการแปลง Unicode C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้ /, :, ?, , หรือ #
vehicle

Vehicle

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

เมื่อสร้างยานพาหนะ ระบบจะไม่สนใจฟิลด์ต่อไปนี้

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

ช่องอื่นๆ ทั้งหมดเป็นตัวเลือกและจะใช้ก็ต่อเมื่อระบุ

DeviceSettings

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

ช่อง
location_power_save_mode

LocationPowerSaveMode

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

bool

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

bool

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

BatteryInfo

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

GetTripRequest

ข้อความคําขอ GetTrip

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
name

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider}/trips/{trip} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
view

TripView

ชุดย่อยของช่องการเดินทางที่ควรแสดงผลและการตีความ
current_route_segment_version

Timestamp

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

Timestamp

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

PolylineFormatType

รูปแบบเส้นทางปัจจุบันที่แสดงผล LAT_LNG_LIST_TYPE (ใน Trip.route) หรือ ENCODED_POLYLINE_TYPE (ใน Trip.current_route_segment) ค่าเริ่มต้นคือ LAT_LNG_LIST_TYPE
current_route_segment_traffic_version

Timestamp

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

Timestamp

ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่จะดึงข้อมูล Trip.remaining_waypoints.traffic_to_waypoint และ Trip.remaining_waypoints.path_to_waypoint หากข้อมูลไม่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลานี้ ระบบจะไม่ตั้งค่าช่องด้านบนในการตอบกลับ หากไม่ระบุ remaining_waypoints_route_version ระบบจะดึงข้อมูลการเข้าชมและเส้นทางเสมอ

GetVehicleRequest

GetVehicle คำขอส่งข้อความ

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
name

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider}/vehicles/{vehicle} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
current_route_segment_version

Timestamp

ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่ดึงข้อมูล Vehicle.current_route_segment หากเส้นทางไม่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลานี้ ระบบจะไม่ตั้งค่าช่อง current_route_segment ในคำตอบ หากไม่ได้ระบุจำนวนขั้นต่ำ ระบบจะดึงข้อมูล current_route_segment เสมอ
waypoints_version

Timestamp

ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) สำหรับการดึงข้อมูล Vehicle.waypoints หากจุดแวะพักไม่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลานี้ ระบบจะไม่ตั้งค่าข้อมูล vehicle.waypoints ในการตอบกลับ หากไม่ระบุข้อมูลในช่องนี้ ระบบจะดึงข้อมูล vehicle.waypoints เสมอ

LicensePlate

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

ช่อง
country_code

string

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

string

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

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

ListVehiclesRequest

ListVehicles คำขอส่งข้อความ

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
page_size

int32

จำนวนยานพาหนะสูงสุดที่จะแสดง ค่าเริ่มต้น: 100
page_token

string

ค่าของ next_page_token ที่ได้จากคําเรียก ListVehicles ก่อนหน้านี้เพื่อให้คุณแบ่งกลุ่มยานพาหนะเป็นหน้าได้ ค่าจะเป็นค่าที่ไม่ระบุหากเกณฑ์ตัวกรองของคําขอไม่เหมือนกับเกณฑ์ตัวกรองสําหรับการเรียกใช้ ListVehicles ก่อนหน้านี้
minimum_capacity

Int32Value

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

TripType

จำกัดการตอบกลับให้แสดงเฉพาะยานพาหนะที่รองรับประเภทการเดินทางที่ระบุอย่างน้อย 1 ประเภท
maximum_staleness

Duration

จำกัดการตอบกลับไว้สำหรับยานพาหนะที่ส่งการอัปเดตตำแหน่งไปยัง Fleet Engine ภายในระยะเวลาที่ระบุ ยานพาหนะที่หยุดนิ่งแต่ยังส่งตำแหน่งอยู่จะไม่ถือว่าล้าสมัย (หากมี) ต้องเป็นระยะเวลาที่เป็นบวกที่ถูกต้อง
vehicle_type_categories[]

Category

ต้องระบุ จำกัดการตอบสนองให้แสดงเฉพาะยานพาหนะที่ตรงกับหมวดหมู่ประเภทใดประเภทหนึ่งตามที่ระบุ ไม่อนุญาต UNKNOWN
required_attributes[]

string

ผู้เรียกใช้สามารถสร้างการดำเนินการเชิงตรรกะที่ซับซ้อนได้โดยใช้ช่อง required_attributes, required_one_of_attributes และ required_one_of_attribute_sets ร่วมกัน

required_attributes คือรายการ required_one_of_attributes ใช้ข้อความที่อนุญาตรายการรายการ เมื่อใช้ร่วมกัน ช่องทั้ง 2 ช่องจะประกอบกันเป็นนิพจน์นี้

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

จำกัดการตอบกลับไว้สำหรับยานพาหนะที่มีแอตทริบิวต์ที่ระบุ ช่องนี้เป็นการดำเนินการแบบเชื่อม/AND อนุญาต required_attributes ได้สูงสุด 50 รายการ ซึ่งตรงกับจำนวนแอตทริบิวต์สูงสุดที่อนุญาตในยานพาหนะ สตริงที่ซ้ำกันแต่ละรายการควรอยู่ในรูปแบบ "คีย์:ค่า"
required_one_of_attributes[]

string

จำกัดการตอบสนองให้แสดงเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุอย่างน้อย 1 รายการในแต่ละ VehicleAttributeList ยานพาหนะแต่ละคันในรายการต้องตรงกับแอตทริบิวต์อย่างน้อย 1 รายการ ช่องนี้เป็นการดำเนินการแบบรวม/OR ใน VehicleAttributeList แต่ละรายการ และการดำเนินการแบบรวม/AND ในคอลเล็กชัน VehicleAttributeList สตริงที่ซ้ำกันแต่ละรายการควรอยู่ในรูปแบบ "key1:value1|key2:value2|key3:value3"
required_one_of_attribute_sets[]

string

required_one_of_attribute_sets มีฟังก์ชันการทำงานเพิ่มเติม

required_one_of_attribute_sets ใช้ข้อความที่อนุญาตรายการของรายการ ซึ่งคล้ายกับ required_one_of_attributes และอนุญาตให้ใช้นิพจน์อย่างเช่นตัวอย่างนี้

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

จำกัดการตอบกลับเป็นยานพาหนะที่ตรงกับแอตทริบิวต์ทั้งหมดใน VehicleAttributeList ยานพาหนะต้องตรงกับแอตทริบิวต์ทั้งหมดภายในแต่ละรายการ ช่องนี้เป็นการดำเนินการแบบรวม/AND ใน VehicleAttributeList แต่ละรายการและการดำเนินการแบบแยก/OR แบบรวมในคอลเล็กชัน VehicleAttributeList สตริงที่ซ้ำกันแต่ละรายการควรอยู่ในรูปแบบ "key1:value1|key2:value2|key3:value3"
vehicle_state

VehicleState

จำกัดการตอบสนองไว้สำหรับยานพาหนะที่สถานะยานพาหนะเป็นค่านี้
on_trip_only

bool

แสดงเฉพาะยานพาหนะที่อยู่ระหว่างการเดินทาง
filter

string

ไม่บังคับ คําค้นหาตัวกรองที่จะใช้เมื่อแสดงยานพาหนะ ดูตัวอย่างไวยากรณ์ตัวกรองได้ที่ http://aip.dev/160

ฟิลด์นี้ออกแบบมาเพื่อแทนที่ช่อง required_attributes, required_one_of_attributes และ required_one_of_attributes_sets หากระบุค่าที่ไม่ใช่ค่าว่างที่นี่ ช่อง required_attributes, required_one_of_attributes และ required_one_of_attributes_sets ต้องว่างเปล่า

ตัวกรองนี้ทํางานเป็นเงื่อนไข AND ที่มีข้อจํากัดอื่นๆ เช่น vehicle_state หรือ on_trip_only

โปรดทราบว่าการค้นหาที่รองรับมีเพียงแอตทริบิวต์ยานพาหนะ (เช่น attributes.<key> = <value> หรือ attributes.<key1> = <value1> AND attributes.<key2> = <value2>) จำนวนข้อจำกัดสูงสุดที่อนุญาตในการค้นหาตัวกรองคือ 50 ข้อ

นอกจากนี้ ระบบจะจัดเก็บแอตทริบิวต์ทั้งหมดเป็นสตริง ดังนั้นการเปรียบเทียบกับแอตทริบิวต์ที่รองรับได้คือ การเปรียบเทียบสตริงเท่านั้น หากต้องการเปรียบเทียบกับค่าตัวเลขหรือบูลีน ค่าดังกล่าวต้องใส่เครื่องหมายคำพูดอย่างชัดเจนเพื่อให้ระบบถือว่าเป็นสตริง (เช่น attributes.<key> = "10" หรือ attributes.<key> = "true")
viewport

Viewport

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

ListVehiclesResponse

ListVehicles ข้อความตอบกลับ

ช่อง
vehicles[]

Vehicle

ยานพาหนะที่ตรงกับเกณฑ์ในคำขอ จํานวนยานพาหนะที่แสดงสูงสุดจะกําหนดโดยช่อง page_size ในคําขอ
next_page_token

string

โทเค็นสำหรับดึงข้อมูลยานพาหนะหน้าถัดไป หรือว่างเปล่าหากไม่มียานพาหนะใดที่ตรงกับเกณฑ์คำขออีก
total_size

int64

ต้องระบุ จำนวนยานพาหนะทั้งหมดที่ตรงกับเกณฑ์คำขอในทุกหน้า

LocationPowerSaveMode

การกำหนดค่าฟีเจอร์ตำแหน่งให้ทำงานในอุปกรณ์เคลื่อนที่เมื่อฟีเจอร์ "โหมดประหยัดแบตเตอรี่" ของอุปกรณ์เปิดอยู่ (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode ไม่ระบุ
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 จะจำกัดคำขอทั้งหมดไปยังผู้ให้บริการเมื่ออุปกรณ์ไม่โต้ตอบ

LocationSensor

เซ็นเซอร์หรือวิธีการที่ใช้ระบุตำแหน่ง

Enum
UNKNOWN_SENSOR ไม่ได้ระบุหรือไม่ทราบเซ็นเซอร์
GPS GPS หรือ Assisted GPS
NETWORK Assisted GPS, รหัสเสาสัญญาณมือถือ หรือจุดเข้าใช้งาน Wi-Fi
PASSIVE รหัสเสาสัญญาณมือถือหรือจุดเข้าใช้งาน Wi-Fi
ROAD_SNAPPED_LOCATION_PROVIDER ตำแหน่งที่อุปกรณ์เคลื่อนที่พิจารณาว่าเป็นตำแหน่งบนถนนที่เป็นไปได้มากที่สุด
CUSTOMER_SUPPLIED_LOCATION สถานที่ตั้งที่ลูกค้าระบุจากแหล่งที่มาอิสระ โดยปกติแล้ว ค่านี้จะใช้สำหรับตำแหน่งที่ระบุจากแหล่งที่มาอื่นนอกเหนือจากอุปกรณ์เคลื่อนที่ที่ใช้ Driver SDK หากแหล่งที่มาเดิมอธิบายด้วยค่า enum อื่น ให้ใช้ค่านั้น โดยปกติแล้ว ตำแหน่งที่มีการทำเครื่องหมาย CUSTOMER_SUPPLIED_LOCATION จะระบุผ่าน last_location.supplemental_location_sensor ของยานพาหนะ
FLEET_ENGINE_LOCATION ตำแหน่งที่ Fleet Engine คำนวณตามสัญญาณที่มีให้ เอาต์พุตเท่านั้น ระบบจะปฏิเสธค่านี้หากได้รับในคำขอ
FUSED_LOCATION_PROVIDER ผู้ให้บริการ Fused Location ของ Android
CORE_LOCATION ผู้ให้บริการตำแหน่งในระบบปฏิบัติการ Apple

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

Enum
UNKNOWN_NAVIGATION_STATUS ไม่ได้ระบุสถานะการนําทาง
NO_GUIDANCE การนําทางของแอปคนขับรถอยู่ในโหมด FREE_NAV
ENROUTE_TO_DESTINATION การนำทางแบบเลี้ยวต่อเลี้ยวพร้อมใช้งานและการนำทางของแอปคนขับเข้าสู่โหมด GUIDED_NAV
OFF_ROUTE ยานพาหนะออกนอกเส้นทางที่แนะนำ
ARRIVED_AT_DESTINATION ยานพาหนะอยู่ห่างจากจุดหมายประมาณ 50 เมตร

PolylineFormatType

ประเภทรูปแบบเส้นประกอบ

Enum
UNKNOWN_FORMAT_TYPE ไม่ได้ระบุหรือไม่ทราบรูปแบบ
LAT_LNG_LIST_TYPE รายการ google.type.LatLng
ENCODED_POLYLINE_TYPE เส้นประกอบที่เข้ารหัสด้วยอัลกอริทึมการบีบอัดเส้นประกอบ ยังไม่รองรับการถอดรหัส

PowerSource

ประเภทที่ชาร์จที่ใช้ชาร์จแบตเตอรี่

Enum
UNKNOWN_POWER_SOURCE ไม่ทราบแหล่งจ่ายไฟ
POWER_SOURCE_AC แหล่งจ่ายไฟคือที่ชาร์จ AC
POWER_SOURCE_USB แหล่งจ่ายไฟคือพอร์ต USB
POWER_SOURCE_WIRELESS แหล่งจ่ายไฟเป็นแบบไร้สาย
POWER_SOURCE_UNPLUGGED ถอดแบตเตอรี่ออกแล้ว

ReportBillableTripRequest

ข้อความคําขอ ReportBillableTrip

ช่อง
name

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider}/billableTrips/{billable_trip} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
country_code

string

ต้องระบุ รหัสประเทศแบบ 2 ตัวอักษรของประเทศที่เดินทาง ราคาจะกำหนดตามรหัสประเทศ
platform

BillingPlatformIdentifier

แพลตฟอร์มที่ส่งคำขอ
related_ids[]

string

ตัวระบุที่เกี่ยวข้องกับการเดินทางที่รายงานโดยตรง โดยปกติแล้วจะเป็นรหัส (เช่น รหัสเซสชัน) ของการดำเนินการก่อนการจองที่ดำเนินการก่อนที่จะมีรหัสการเดินทาง ระบบจำกัดจำนวน related_ids ไว้ที่ 50 รายการ
solution_type

SolutionType

ประเภทโซลูชันผลิตภัณฑ์ GMP (เช่น ON_DEMAND_RIDESHARING_AND_DELIVERIES) ที่ใช้สำหรับการเดินทางที่รายงาน

SolutionType

ตัวเลือกสำหรับประเภทโซลูชันต่างๆ ของการเดินทางที่รายงาน

Enum
SOLUTION_TYPE_UNSPECIFIED ค่าเริ่มต้น API จะใช้ ON_DEMAND_RIDESHARING_AND_DELIVERIES โดยค่าเริ่มต้น ซึ่งเป็นโซลูชันประเภทแรกที่รองรับ เพื่อความเข้ากันได้แบบย้อนหลัง
ON_DEMAND_RIDESHARING_AND_DELIVERIES โซลูชันคือการเดินทางแบบร่วมเดินทางและการนำส่งแบบออนดีมานด์

RequestHeader

RequestHeader มีฟิลด์ที่ใช้ร่วมกันสำหรับคำขอ RPC ทั้งหมดของ Fleet Engine

ช่อง
language_code

string

รหัสภาษา BCP-47 เช่น en-US หรือ sr-Latn ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier หากไม่ระบุ คำตอบอาจเป็นภาษาใดก็ได้ โดยระบบจะแสดงเป็นภาษาอังกฤษหากมีชื่อดังกล่าว ตัวอย่างค่าในฟิลด์: en-US
region_code

string

ต้องระบุ รหัสภูมิภาค CLDR ของภูมิภาคที่ส่งคำขอ ตัวอย่างค่าในฟิลด์: US
sdk_version

string

เวอร์ชันของ SDK การโทร (หากมี) รูปแบบเวอร์ชันคือ "major.minor.patch" เช่น 1.1.2
os_version

string

เวอร์ชันของระบบปฏิบัติการที่ SDK ที่เรียกใช้ทำงานอยู่ ตัวอย่างค่าฟิลด์: 4.4.1, 12.1
device_model

string

รุ่นของอุปกรณ์ที่เรียกใช้ SDK ตัวอย่างค่าฟิลด์: iPhone12,1, SM-G920F
sdk_type

SdkType

ประเภท SDK ที่ส่งคําขอ
maps_sdk_version

string

เวอร์ชันของ MapSDK ที่ SDK ที่เรียกใช้นั้นใช้อยู่ (หากมี) รูปแบบเวอร์ชันคือ "major.minor.patch" เช่น 5.2.1
nav_sdk_version

string

เวอร์ชันของ NavSDK ที่ SDK ที่เรียกใช้ต้องอาศัย (หากมี) รูปแบบเวอร์ชันคือ "major.minor.patch" เช่น 2.1.0
platform

Platform

แพลตฟอร์มของ SDK ที่เรียกใช้
manufacturer

string

ผู้ผลิตอุปกรณ์ Android จาก SDK ที่เรียกใช้ ซึ่งใช้ได้กับ SDK ของ Android เท่านั้น ตัวอย่างค่าในฟิลด์: Samsung
android_api_level

int32

ระดับ API ของ Android ของ SDK ที่เรียกใช้ ซึ่งใช้ได้กับ SDK ของ Android เท่านั้น ตัวอย่างค่าในฟิลด์: 23
trace_id

string

รหัสที่ไม่บังคับซึ่งระบุได้เพื่อวัตถุประสงค์ในการบันทึกเพื่อระบุคำขอ

แพลตฟอร์ม

แพลตฟอร์มของ SDK ที่เรียกใช้

Enum
PLATFORM_UNSPECIFIED ค่าเริ่มต้น ระบบจะใช้ค่านี้หากละเว้นแพลตฟอร์ม
ANDROID คำขอมาจาก Android
IOS คำขอมาจาก iOS
WEB คำขอมาจากเว็บ

SdkType

ประเภท SDK ที่เป็นไปได้

Enum
SDK_TYPE_UNSPECIFIED ค่าเริ่มต้น ระบบจะใช้ค่านี้หากละเว้น sdk_type
CONSUMER SDK ที่เรียกใช้คือ Consumer
DRIVER SDK ที่เรียกใช้คือ Driver
JAVASCRIPT SDK ที่เรียกใช้คือ JavaScript

SearchTripsRequest

ข้อความคำขอ SearchTrips

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
vehicle_id

string

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

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

หากตั้งค่าเป็น "จริง" การตอบกลับจะมีการเดินทางที่ส่งผลต่อเส้นทางของคนขับ
page_size

int32

หากไม่ได้ตั้งค่า เซิร์ฟเวอร์จะเป็นผู้ตัดสินใจจำนวนผลลัพธ์ที่จะแสดง
page_token

string

ตั้งค่านี้เป็นค่าที่แสดงผลก่อนหน้านี้ใน SearchTripsResponse เพื่อดําเนินการต่อจากผลลัพธ์ก่อนหน้า
minimum_staleness

Duration

หากระบุ จะแสดงผลการเดินทางที่ยังไม่ได้อัปเดตหลังจากเวลา (current - minimum_staleness)

SearchTripsResponse

ข้อความตอบกลับของ SearchTrips

ช่อง
trips[]

Trip

รายการการเดินทางของยานพาหนะที่ขอ
next_page_token

string

ส่งโทเค็นนี้ใน SearchTripsRequest เพื่อเลื่อนดูผลการค้นหารายการ API จะแสดงรายการการเดินทางในการเรียกแต่ละครั้ง และเมื่อไม่มีผลลัพธ์เหลืออยู่อีก รายการการเดินทางจะว่างเปล่า

SearchVehiclesRequest

SearchVehicles คำขอส่งข้อความ

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
parent

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
pickup_point

TerminalLocation

ต้องระบุ จุดรับสินค้าที่จะค้นหาใกล้ๆ
dropoff_point

TerminalLocation

สถานที่ส่งสินค้าที่ต้องการของลูกค้า ต้องระบุข้อมูลในช่องนี้หาก trip_types มี TripType.SHARED
pickup_radius_meters

int32

ต้องระบุ กําหนดรัศมีการค้นหายานพาหนะรอบจุดรับ ระบบจะแสดงเฉพาะยานพาหนะที่อยู่ในรัศมีการค้นหาเท่านั้น ค่าต้องอยู่ระหว่าง 400 ถึง 10,000 เมตร
count

int32

ต้องระบุ ระบุจำนวนยานพาหนะสูงสุดที่จะแสดง ค่าต้องอยู่ระหว่าง 1 ถึง 50 (รวม)
minimum_capacity

int32

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

TripType

ต้องระบุ แสดงประเภทการเดินทางที่เสนอ ต้องมีประเภทเดียว ไม่อนุญาต UNKNOWN_TRIP_TYPE จำกัดการค้นหาให้แสดงเฉพาะยานพาหนะที่รองรับประเภทการเดินทางนั้น
maximum_staleness

Duration

จำกัดการค้นหาเฉพาะยานพาหนะที่ส่งการอัปเดตตำแหน่งไปยัง Fleet Engine ภายในระยะเวลาที่ระบุ ยานพาหนะที่หยุดนิ่งแต่ยังส่งตำแหน่งอยู่จะไม่ถือว่าล้าสมัย หากไม่ได้ตั้งค่าฟิลด์นี้ เซิร์ฟเวอร์จะใช้ 5 นาทีเป็นค่าเริ่มต้น
vehicle_types[]

VehicleType

ต้องระบุ จำกัดการค้นหาเฉพาะยานพาหนะที่ตรงกับประเภทใดประเภทหนึ่งที่กำหนด ต้องระบุประเภทยานพาหนะอย่างน้อย 1 ประเภท ไม่อนุญาตให้ใช้ VehicleTypes ที่มีหมวดหมู่เป็น UNKNOWN
required_attributes[]

VehicleAttribute

ผู้เรียกใช้สามารถสร้างการดำเนินการเชิงตรรกะที่ซับซ้อนได้โดยใช้ช่อง required_attributes, required_one_of_attributes และ required_one_of_attribute_sets ร่วมกัน

required_attributes คือรายการ required_one_of_attributes ใช้ข้อความที่อนุญาตรายการรายการ เมื่อใช้ร่วมกัน ช่องทั้ง 2 ช่องจะประกอบกันเป็นนิพจน์นี้

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุ ช่องนี้เป็นการดำเนินการแบบเชื่อม/AND อนุญาต required_attributes ได้สูงสุด 50 รายการ ซึ่งตรงกับจำนวนแอตทริบิวต์สูงสุดที่อนุญาตในยานพาหนะ
required_one_of_attributes[]

VehicleAttributeList

จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุอย่างน้อย 1 รายการในแต่ละ VehicleAttributeList ยานพาหนะแต่ละคันในรายการต้องตรงกับแอตทริบิวต์อย่างน้อย 1 รายการ ช่องนี้เป็นการดำเนินการแบบรวม/OR ใน VehicleAttributeList แต่ละรายการ และการดำเนินการแบบรวม/AND ในคอลเล็กชัน VehicleAttributeList
required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets มีฟังก์ชันการทำงานเพิ่มเติม

required_one_of_attribute_sets ใช้ข้อความที่อนุญาตรายการของรายการ ซึ่งคล้ายกับ required_one_of_attributes และอนุญาตให้ใช้นิพจน์อย่างเช่นตัวอย่างนี้

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ทั้งหมดใน VehicleAttributeList ยานพาหนะต้องตรงกับแอตทริบิวต์ทั้งหมดภายในแต่ละรายการ ช่องนี้เป็นการดำเนินการแบบรวม/AND ใน VehicleAttributeList แต่ละรายการและการดำเนินการแบบรวม/OR ที่ไม่รวมในคอลเล็กชัน VehicleAttributeList
order_by

VehicleMatchOrder

ต้องระบุ ระบุเกณฑ์การจัดเรียงที่ต้องการสําหรับผลลัพธ์
include_back_to_back

bool

ข้อมูลนี้ระบุว่ายานพาหนะที่เดินทางอยู่ 1 เที่ยวมีสิทธิ์สำหรับการค้นหานี้หรือไม่ ระบบจะใช้ช่องนี้เฉพาะในกรณีที่ไม่ได้ระบุ current_trips_present เมื่อไม่ได้ระบุ current_trips_present และช่องนี้เป็น false ระบบจะไม่รวมยานพาหนะที่มอบหมายการเดินทางไว้ไว้ในผลการค้นหา เมื่อไม่ได้ระบุ current_trips_present และช่องนี้เป็น true ผลการค้นหาอาจรวมยานพาหนะที่อยู่ระหว่างการเดินทาง 1 รายการซึ่งมีสถานะเป็น ENROUTE_TO_DROPOFF เมื่อระบุ current_trips_present คุณจะตั้งค่าช่องนี้เป็น "จริง" ไม่ได้

ค่าเริ่มต้นคือ false
trip_id

string

ระบุการเดินทางที่เชื่อมโยงกับ SearchVehicleRequest นี้
current_trips_present

CurrentTripsPresent

ข้อมูลนี้ระบุว่ายานพาหนะที่อยู่ระหว่างการเดินทางมีสิทธิ์สำหรับการค้นหานี้หรือไม่ ต้องตั้งค่าเป็นอย่างอื่นที่ไม่ใช่ CURRENT_TRIPS_PRESENT_UNSPECIFIED หาก trip_type รวม SHARED
filter

string

ไม่บังคับ คําค้นหาตัวกรองที่จะใช้เมื่อค้นหายานพาหนะ ดูตัวอย่างไวยากรณ์ของตัวกรองได้ที่ http://aip.dev/160

ฟิลด์นี้ออกแบบมาเพื่อแทนที่ช่อง required_attributes, required_one_of_attributes และ required_one_of_attributes_sets หากระบุค่าที่ไม่ใช่ค่าว่างที่นี่ ช่อง required_attributes, required_one_of_attributes และ required_one_of_attributes_sets ต้องว่างเปล่า

ตัวกรองนี้ทํางานเป็นเงื่อนไข AND ที่มีข้อจํากัดอื่นๆ เช่น minimum_capacity หรือ vehicle_types

โปรดทราบว่าการค้นหาที่รองรับมีเพียงแอตทริบิวต์ยานพาหนะ (เช่น attributes.<key> = <value> หรือ attributes.<key1> = <value1> AND attributes.<key2> = <value2>) จำนวนข้อจำกัดสูงสุดที่อนุญาตในการค้นหาตัวกรองคือ 50 ข้อ

นอกจากนี้ ระบบจะจัดเก็บแอตทริบิวต์ทั้งหมดเป็นสตริง ดังนั้นการเปรียบเทียบกับแอตทริบิวต์ที่รองรับได้คือ การเปรียบเทียบสตริงเท่านั้น หากต้องการเปรียบเทียบกับค่าตัวเลขหรือบูลีน ค่าดังกล่าวต้องใส่เครื่องหมายคำพูดอย่างชัดเจนเพื่อให้ระบบถือว่าเป็นสตริง (เช่น attributes.<key> = "10" หรือ attributes.<key> = "true")

CurrentTripsPresent

ระบุประเภทข้อจำกัดในการเดินทางปัจจุบันของยานพาหนะ

Enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED ความพร้อมให้บริการของยานพาหนะที่อยู่ระหว่างการเดินทางจะขึ้นอยู่กับช่อง include_back_to_back
NONE ยานพาหนะที่ไม่มีการเดินทางอาจปรากฏในผลการค้นหา เมื่อใช้ค่านี้ include_back_to_back ต้องไม่เป็น true
ANY ยานพาหนะที่อยู่ระหว่างการเดินทางไม่เกิน 5 เที่ยวและมีจุดแวะพัก 10 จุดจะรวมอยู่ในผลการค้นหา เมื่อใช้ค่านี้ include_back_to_back ต้องไม่เป็น true

VehicleMatchOrder

ระบุลำดับของยานพาหนะที่ตรงกันในคำตอบ

Enum
UNKNOWN_VEHICLE_MATCH_ORDER ค่าเริ่มต้นที่ใช้สำหรับยานพาหนะที่ตรงกันซึ่งไม่ระบุหรือไม่รู้จัก
PICKUP_POINT_ETA เรียงจากน้อยไปมากตามเวลาขับรถของยานพาหนะไปยังจุดรับสินค้า
PICKUP_POINT_DISTANCE เรียงจากน้อยไปมากตามระยะทางที่ยานพาหนะต้องขับไปยังจุดรับ
DROPOFF_POINT_ETA เรียงจากน้อยไปมากตามเวลาขับรถของยานพาหนะไปยังจุดส่งสินค้า คำสั่งซื้อนี้ใช้ได้ก็ต่อเมื่อมีระบุจุดส่งสินค้าในคำขอเท่านั้น
PICKUP_POINT_STRAIGHT_DISTANCE เรียงจากน้อยไปมากตามระยะทางตรงจากตำแหน่งที่รายงานล่าสุดของยานพาหนะไปยังจุดรับ
COST เรียงจากน้อยไปมากตามต้นทุนการจับคู่ที่กำหนดค่าไว้ ต้นทุนการจับคู่หมายถึงการคำนวณที่มีน้ำหนักระหว่างระยะทางตรงกับเวลาถึงโดยประมาณ น้ำหนักจะตั้งค่าด้วยค่าเริ่มต้นและสามารถแก้ไขได้ต่อลูกค้า โปรดติดต่อทีมสนับสนุนของ Google หากต้องแก้ไขน้ำหนักเหล่านี้สำหรับโปรเจ็กต์

SearchVehiclesResponse

SearchVehicles ข้อความตอบกลับ

ช่อง
matches[]

VehicleMatch

รายการยานพาหนะที่ตรงกับเกณฑ์ SearchVehiclesRequest โดยจัดเรียงตามฟิลด์ SearchVehiclesRequest.order_by

SpeedReadingInterval

ตัวบ่งชี้ความหนาแน่นของการเข้าชมในเส้นทางที่ต่อเนื่องกัน เมื่อพิจารณาเส้นทางที่มีจุด P_0, P_1, ... , P_N (ดัชนีฐาน 0) SpeedReadingInterval จะกําหนดช่วงเวลาและอธิบายการเข้าชมโดยใช้หมวดหมู่ต่อไปนี้

ช่อง
start_polyline_point_index

int32

ดัชนีเริ่มต้นของช่วงเวลานี้ในเส้นทาง ใน JSON เมื่อดัชนีเป็น 0 ช่องจะดูเหมือนว่าไม่มีข้อมูล
end_polyline_point_index

int32

ดัชนีสิ้นสุดของช่วงเวลานี้ในเส้นทาง ใน JSON เมื่อดัชนีเป็น 0 ช่องจะดูเหมือนว่าไม่มีข้อมูล
speed

Speed

ความเร็วในการรับส่งข้อมูลในช่วงนี้

ความเร็ว

การจัดประเภทความเร็วของเส้นประกอบตามข้อมูลการเข้าชม

Enum
SPEED_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้งาน
NORMAL ความเร็วปกติ ไม่พบการชะลอ
SLOW ตรวจพบการชะลอตัว แต่ไม่มีรถติด
TRAFFIC_JAM ตรวจพบการจราจรติดขัด

StopLocation

ตำแหน่งจริงที่หยุด (รับ/ส่ง)

ช่อง
point

LatLng

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

Timestamp

ระบุเวลาที่หยุด
stop_time
(deprecated)

Timestamp

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

TerminalLocation

อธิบายตำแหน่งของจุดสังเกต

ช่อง
point

LatLng

ต้องระบุ ระบุตำแหน่งของจุดแวะพักระหว่างการเดินทาง
terminal_point_id
(deprecated)

TerminalPointId

เลิกใช้งานแล้ว: โปรดระบุช่อง point แทน
access_point_id
(deprecated)

string

เลิกใช้งานแล้ว: โปรดระบุช่อง point แทน
trip_id
(deprecated)

string

เลิกใช้งานแล้ว
terminal_location_type
(deprecated)

WaypointType

เลิกใช้งานแล้ว: Vehicle.waypoint จะมีข้อมูลนี้

TerminalPointId

เลิกใช้งานแล้ว: Fleet Engine ไม่รองรับ TerminalPoints อีกต่อไป ให้ใช้ TerminalLocation.point แทน

ช่อง
value
(deprecated)

string

เลิกใช้งานแล้ว
ฟิลด์สหภาพ Id เลิกใช้งานแล้ว Id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
place_id
(deprecated)

string

เลิกใช้งานแล้ว
generated_id
(deprecated)

string

เลิกใช้งานแล้ว

TrafficPolylineData

สภาพการจราจรตามเส้นทางที่ยานพาหนะคาดว่าจะวิ่ง

ช่อง
traffic_rendering

VisualTrafficReportPolylineRendering

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

การเดินทาง

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

ช่อง
name

string

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

string

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

TripStatus

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

TripType

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

TerminalLocation

สถานที่ที่ลูกค้าระบุว่าจะให้ไปรับ
actual_pickup_point

StopLocation

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

StopLocation

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

Timestamp

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

TerminalLocation

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

Timestamp

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

int32

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

StopLocation

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

StopLocation

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

TerminalLocation

สถานที่ที่ลูกค้าระบุว่าจะให้ส่งสินค้า
actual_dropoff_point

StopLocation

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

Timestamp

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

TripWaypoint

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

TripWaypoint

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

LatLng

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

TripWaypoint

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

Int32Value

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

Timestamp

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

Duration

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

Timestamp

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

Timestamp

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

int32

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

VehicleLocation

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

bool

เอาต์พุตเท่านั้น บ่งบอกว่า last_location ของยานพาหนะจะยึดกับ current_route_segment ได้หรือไม่ เท็จหากไม่มี last_location หรือ current_route_segment ซึ่งคำนวณโดย Fleet Engine ระบบจะละเว้นการอัปเดตจากไคลเอ็นต์
view

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 การเดินทางถูกยกเลิกก่อนที่คนขับ ผู้ขับขี่ หรือผู้ให้บริการร่วมเดินทางจะเข้าไปรับ

TripType

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

Enum
UNKNOWN_TRIP_TYPE ค่าเริ่มต้นที่ใช้สำหรับประเภทการเดินทางที่ไม่ระบุหรือไม่รู้จัก
SHARED การเดินทางอาจใช้ยานพาหนะร่วมกับการเดินทางอื่นๆ
EXCLUSIVE การเดินทางมีไว้สำหรับยานพาหนะเท่านั้น

TripView

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

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

TripWaypoint

อธิบายจุดจอดบนเส้นทางของยานพาหนะหรือจุดสิ้นสุดของการเดินทางของยานพาหนะ

ช่อง
location

TerminalLocation

ตำแหน่งของจุดแวะพักนี้
trip_id

string

การเดินทางที่เชื่อมโยงกับจุดสังเกตนี้
waypoint_type

WaypointType

บทบาทของจุดแวะพักนี้ในการเดินทาง เช่น การรับหรือส่ง
path_to_waypoint[]

LatLng

เส้นทางจากจุดสังเกตก่อนหน้าไปยังจุดสังเกตปัจจุบัน ไม่มีการกําหนดค่าสําหรับจุดแวะพักแรกในรายการ ช่องนี้จะสร้างขึ้นเมื่อมีการขอเท่านั้น
encoded_path_to_waypoint

string

เส้นทางที่เข้ารหัสจากจุดสังเกตก่อนหน้าไปยังจุดสังเกตปัจจุบัน

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

ConsumableTrafficPolyline

สภาพการจราจรตลอดเส้นทางไปยังจุดสังเกตนี้ โปรดทราบว่าข้อมูลการเข้าชมมีให้บริการสำหรับลูกค้าโซลูชันการเดินทางและการนำส่งของแพลตฟอร์ม Google Maps เท่านั้น
distance_meters

Int32Value

ระยะทางของเส้นทางจากจุดสังเกตก่อนหน้าไปยังจุดสังเกตปัจจุบัน ไม่มีการกําหนดค่าสําหรับจุดแวะพักแรกในรายการ
eta

Timestamp

เวลาถึงโดยประมาณที่จุดสังเกตนี้ ไม่มีการกําหนดค่าสําหรับจุดแวะพักแรกในรายการ
duration

Duration

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

UpdateTripRequest

ข้อความคําขอ UpdateTrip

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
name

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider}/trips/{trip} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-consumer-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
trip

Trip

ต้องระบุ การเดินทางที่เชื่อมโยงกับการอัปเดต

ฟิลด์ต่อไปนี้จะได้รับการบำรุงรักษาโดย Fleet Engine อย่าอัปเดตโดยใช้ Trip.update

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

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

เมื่อคุณระบุ Trip.vehicle_waypoints รายการต้องมีจุดแวะพักที่เหลือทั้งหมดของการเดินทางของยานพาหนะ โดยไม่มีจุดแวะพักเพิ่มเติม คุณต้องจัดลําดับจุดแวะพักเหล่านี้เพื่อให้จุดรับส่งผู้โดยสารอยู่ก่อนจุดหมายพักกลาง และจุดหมายพักกลางทั้งหมดอยู่ก่อนจุดส่งผู้โดยสาร จุดแวะพักของการเดินทาง EXCLUSIVE ต้องไม่ซ้อนทับกับการเดินทางอื่นๆ ระบบจะใช้ฟิลด์ trip_id, waypoint_type และ location และจะไม่สนใจฟิลด์ TripWaypoint อื่นๆ ทั้งหมดใน vehicle_waypoints

คุณควรระบุ Trip.intermediate_destinations_version เมื่ออัปเดตสถานะการเดินทางเป็น ENROUTE_TO_INTERMEDIATE_DESTINATION เพื่อหลีกเลี่ยงเงื่อนไขการแข่งขันสำหรับการเดินทางที่มีปลายทางหลายแห่ง Trip.intermediate_destinations_version ที่ส่งต้องสอดคล้องกับเวอร์ชันของ Fleet Engine หากไม่ แสดงว่าคำขอไม่สำเร็จ
update_mask

FieldMask

ต้องระบุ ฟิลด์มาสก์ที่ระบุช่องในการเดินทางที่จะอัปเดต update_mask ต้องมีฟิลด์อย่างน้อย 1 ฟิลด์

UpdateVehicleAttributesRequest

UpdateVehicleAttributes คำขอส่งข้อความ

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
name

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider}/vehicles/{vehicle} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

UpdateVehicleAttributes ข้อความตอบกลับ

ช่อง
attributes[]

VehicleAttribute

ต้องระบุ รายการแอตทริบิวต์ยานพาหนะทั้งหมดที่อัปเดตแล้ว ซึ่งรวมถึงแอตทริบิวต์ใหม่ แอตทริบิวต์ที่เปลี่ยนแปลง และแอตทริบิวต์ที่ไม่มีการเปลี่ยนแปลง

UpdateVehicleRequest

`ข้อความคําขอ UpdateVehicle

ช่อง
header

RequestHeader

ส่วนหัวคำขอของ Fleet Engine มาตรฐาน
name

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider}/vehicles/{vehicle} {provider} ต้องเป็นรหัสโปรเจ็กต์ (เช่น sample-cloud-project) ของโปรเจ็กต์ Google Cloud ที่บัญชีบริการที่เรียกใช้นี้เป็นสมาชิก
vehicle

Vehicle

ต้องระบุ ค่าเอนทิตี Vehicle ที่จะนําไปใช้ เมื่ออัปเดต Vehicle ระบบอาจไม่อัปเดตช่องต่อไปนี้เนื่องจากมีการจัดการโดยเซิร์ฟเวอร์

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

หากอัปเดตช่อง attributes ระบบจะแทนที่แอตทริบิวต์ทั้งหมดของยานพาหนะด้วยแอตทริบิวต์ที่ระบุในคำขอ หากต้องการอัปเดตเฉพาะบางแอตทริบิวต์ โปรดดูวิธีการ UpdateVehicleAttributes

ในทำนองเดียวกัน ฟิลด์ waypoints สามารถอัปเดตได้ แต่ต้องมีจุดแวะพักทั้งหมดที่อยู่ในยานพาหนะในขณะนั้นและไม่มีจุดแวะพักอื่นๆ
update_mask

FieldMask

ต้องระบุ ฟิลด์มาสก์ที่ระบุช่องของ Vehicle ที่จะอัปเดต ต้องระบุชื่อฟิลด์อย่างน้อย 1 ชื่อ

ยานพาหนะ

ข้อมูลเมตาของยานพาหนะ

ช่อง
name

string

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

VehicleState

สถานะยานพาหนะ
supported_trip_types[]

TripType

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

string

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

VehicleLocation

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

int32

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

VehicleAttribute

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

VehicleType

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

LicensePlate

ข้อมูลป้ายทะเบียนของยานพาหนะ
route[]
(deprecated)

TerminalLocation

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

string

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

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

TrafficPolylineData

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

Timestamp

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

TripWaypoint

จุดสังเกตที่ current_route_segment สิ้นสุด ซึ่งคนขับสามารถระบุในUpdateVehicle call ได้ทั้งเป็นจุดแวะพักตลอดการเดินทาง LatLng หรือเป็นLatLngสุดท้ายของcurrent_route_segment จากนั้น Fleet Engine จะพยายามอย่างเต็มที่เพื่อหาค่าที่อยู่ระหว่างจุดแวะพักจริงหากไม่ได้ระบุไว้อย่างสมบูรณ์ ระบบจะไม่สนใจฟิลด์นี้ในการเรียกใช้ UpdateVehicle เว้นแต่จะมีการระบุ current_route_segment ด้วย
remaining_distance_meters

Int32Value

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

Timestamp

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

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

Int32Value

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

เมื่ออัปเดตยานพาหนะ remaining_time_seconds จะมีความสำคัญเหนือกว่า eta_to_first_waypoint ในคำขอเดียวกัน
waypoints[]

TripWaypoint

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

Timestamp

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

bool

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

NavigationStatus

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

DeviceSettings

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

VehicleType

ประเภทยานพาหนะ

ช่อง
category

Category

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

หมวดหมู่

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

Enum
UNKNOWN ค่าเริ่มต้นที่ใช้สำหรับหมวดหมู่ยานพาหนะที่ระบุหรือไม่รู้จัก
AUTO รถยนต์
TAXI ยานพาหนะที่ทำหน้าที่เป็นแท็กซี่ (โดยทั่วไปแล้วจะได้รับอนุญาตหรือควบคุมดูแล)
TRUCK โดยทั่วไปแล้วหมายถึงยานพาหนะที่มีพื้นที่เก็บสัมภาระขนาดใหญ่
TWO_WHEELER รถจักรยานยนต์ โมเพด หรือยานพาหนะ 2 ล้ออื่นๆ
BICYCLE ยานพาหนะที่ขับเคลื่อนด้วยคน
PEDESTRIAN ยานพาหนะขนส่งคน ซึ่งมักเดินหรือวิ่งไปตามทางเท้า

VehicleAttribute

อธิบายแอตทริบิวต์ยานพาหนะเป็นคู่คีย์-ค่า ความยาวสตริง "คีย์:ค่า" ต้องไม่เกิน 256 อักขระ

ช่อง
key

string

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

string

ค่าของแอตทริบิวต์
ฟิลด์สหภาพ vehicle_attribute_value ค่าของแอตทริบิวต์อาจเป็นสตริง บูลีน หรือเลขทศนิยม vehicle_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
string_value

string

ค่าแอตทริบิวต์ที่เป็นสตริง

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

bool

ค่าแอตทริบิวต์ประเภทบูลีน
number_value

double

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

VehicleAttributeList

ประเภทข้อมูลลิสต์ของลิสต์สำหรับแอตทริบิวต์ยานพาหนะ

ช่อง
attributes[]

VehicleAttribute

รายการแอตทริบิวต์ในคอลเล็กชันนี้

VehicleLocation

ตำแหน่ง ความเร็ว และทิศทางของยานพาหนะ ณ ขณะหนึ่ง

ช่อง
location

LatLng

ตำแหน่งของยานพาหนะ เมื่อส่งไปยัง Fleet Engine ตำแหน่งของยานพาหนะจะเป็นตำแหน่ง GPS เมื่อคุณได้รับคำตอบ ตำแหน่งของยานพาหนะอาจเป็นตำแหน่ง GPS, ตำแหน่งเสริม หรือตำแหน่งโดยประมาณอื่นๆ แหล่งที่มาระบุไว้ใน location_sensor
horizontal_accuracy
(deprecated)

DoubleValue

เลิกใช้งานแล้ว: ให้ใช้ latlng_accuracy แทน
latlng_accuracy

DoubleValue

ความแม่นยำ location เมตรเป็นรัศมี
heading

Int32Value

ทิศทางที่ยานพาหนะเคลื่อนที่เป็นองศา 0 หมายถึงทิศเหนือ ช่วงที่ถูกต้องคือ [0,360)
bearing_accuracy
(deprecated)

DoubleValue

เลิกใช้งานแล้ว: ให้ใช้ heading_accuracy แทน
heading_accuracy

DoubleValue

ความแม่นยำ heading องศา
altitude

DoubleValue

ระดับความสูงเป็นเมตรเหนือ WGS84
vertical_accuracy
(deprecated)

DoubleValue

เลิกใช้งานแล้ว: ให้ใช้ altitude_accuracy แทน
altitude_accuracy

DoubleValue

ความแม่นยำ altitude เมตร
speed_kmph
(deprecated)

Int32Value

ความเร็วของยานพาหนะเป็นกิโลเมตรต่อชั่วโมง เลิกใช้งานแล้ว: ให้ใช้ speed แทน
speed

DoubleValue

ความเร็วของยานพาหนะเป็นเมตร/วินาที
speed_accuracy

DoubleValue

ความแม่นยำ speed เมตร/วินาที
update_time

Timestamp

เวลาเมื่อเซ็นเซอร์รายงาน location ตามนาฬิกาของเซ็นเซอร์
server_time

Timestamp

เอาต์พุตเท่านั้น เวลาที่เซิร์ฟเวอร์ได้รับข้อมูลตำแหน่ง
location_sensor

LocationSensor

ผู้ให้บริการข้อมูลตำแหน่ง (เช่น GPS)
is_road_snapped

BoolValue

location มีการปักหมุดกับถนนหรือไม่
is_gps_sensor_enabled

BoolValue

อินพุตเท่านั้น บ่งบอกว่าเซ็นเซอร์ GPS เปิดใช้ในอุปกรณ์เคลื่อนที่หรือไม่
time_since_update

Int32Value

อินพุตเท่านั้น เวลา (เป็นวินาที) นับตั้งแต่มีการส่งตำแหน่งนี้ไปยังเซิร์ฟเวอร์เป็นครั้งแรก ค่านี้จะเท่ากับ 0 สำหรับการอัปเดตครั้งแรก หากไม่ทราบเวลา (เช่น เมื่อแอปรีสตาร์ท) ค่านี้จะรีเซ็ตเป็น 0
num_stale_updates
(deprecated)

Int32Value

อินพุตเท่านั้น เลิกใช้งานแล้ว: ตอนนี้ระบบใช้สัญญาณอื่นๆ เพื่อระบุว่าตำแหน่งล้าสมัยหรือไม่
raw_location

LatLng

ตำแหน่งยานพาหนะดิบ (Road-Snapper ไม่ได้ประมวลผล)
raw_location_time

Timestamp

การประทับเวลาที่เชื่อมโยงกับตำแหน่งดิบ
raw_location_sensor

LocationSensor

แหล่งที่มาของตำแหน่งดิบ ค่าเริ่มต้นคือ GPS
raw_location_accuracy

DoubleValue

ความแม่นยำของ raw_location เป็นรัศมีเป็นเมตร
supplemental_location

LatLng

ตำแหน่งเสริมที่แอปที่ผสานรวมให้ไว้
supplemental_location_time

Timestamp

การประทับเวลาที่เชื่อมโยงกับสถานที่เสริม
supplemental_location_sensor

LocationSensor

แหล่งที่มาของสถานที่ตั้งเสริม ค่าเริ่มต้นคือ CUSTOMER_SUPPLIED_LOCATION
supplemental_location_accuracy

DoubleValue

ความแม่นยำของ supplemental_location เป็นรัศมีเป็นเมตร
road_snapped
(deprecated)

bool

เลิกใช้งานแล้ว: ให้ใช้ is_road_snapped แทน

VehicleMatch

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

ช่อง
vehicle

Vehicle

ต้องระบุ ยานพาหนะที่ตรงกับคำขอ
vehicle_pickup_eta

Timestamp

เวลาถึงโดยประมาณของยานพาหนะในการขับรถไปยังจุดรับที่ระบุในคำขอ ค่าว่างบ่งบอกว่าคำนวณเวลาถึงโดยประมาณสำหรับยานพาหนะไม่สำเร็จ หาก SearchVehiclesRequest.include_back_to_back เป็น true และยานพาหนะนี้มีการเดินทางที่ใช้งานอยู่ vehicle_pickup_eta จะรวมเวลาที่ใช้ในการเดินทางที่ใช้งานอยู่ในปัจจุบัน
vehicle_pickup_distance_meters

Int32Value

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

Int32Value

ต้องระบุ ระยะทางตรงระหว่างยานพาหนะกับจุดรับพัสดุที่ระบุในคำขอ
vehicle_dropoff_eta

Timestamp

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

Int32Value

ระยะทางขับรถ (เป็นเมตร) ของยานพาหนะจากจุดรับส่งที่ระบุในคำขอ ระยะทางคือระยะทางระหว่างจุด 2 จุดเท่านั้น โดยไม่รวมตำแหน่งของยานพาหนะหรือจุดอื่นๆ ที่ต้องแวะไปก่อนเพื่อให้ยานพาหนะไปที่จุดรับหรือจุดส่ง ระบบจะป้อนค่าก็ต่อเมื่อมีระบุ dropoff_point ในคําขอเท่านั้น ค่าว่างบ่งบอกว่าคำนวณระยะทางจากจุดรับส่งที่ระบุในคำขอไม่สำเร็จ
trip_type

TripType

ต้องระบุ ประเภทการเดินทางของคำขอที่ใช้คำนวณเวลาถึงจุดรับ
vehicle_trips_waypoints[]

Waypoint

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

VehicleMatchType

ประเภทการจับคู่ยานพาหนะ
requested_ordered_by

VehicleMatchOrder

ลำดับที่ขอสำหรับการจัดเรียงการจับคู่ยานพาหนะ เทียบเท่ากับ ordered_by
ordered_by

VehicleMatchOrder

ลำดับที่ขอสำหรับการจัดเรียงการจับคู่ยานพาหนะ เทียบเท่ากับ requested_ordered_by

VehicleMatchType

ประเภทการจับคู่ยานพาหนะ

Enum
UNKNOWN ประเภทการจับคู่ยานพาหนะที่ไม่รู้จัก
EXCLUSIVE ขณะนี้ยานพาหนะไม่มีการกำหนดการเดินทางและสามารถไปยังจุดรับได้
BACK_TO_BACK ขณะนี้ระบบได้กำหนดยานพาหนะให้การเดินทางหนึ่งๆ แล้ว แต่สามารถไปยังจุดรับหลังจากการเดินทางที่กำลังดำเนินอยู่เสร็จสิ้น การคำนวณเวลาถึงโดยประมาณและระยะทางจะพิจารณาการเดินทางที่มีอยู่
CARPOOL ยานพาหนะมีความจุเพียงพอสำหรับการแชร์การเดินทาง
CARPOOL_BACK_TO_BACK ยานพาหนะจะขับขี่ให้เสร็จสิ้นก่อนไปยังจุดรับ การคำนวณเวลาถึงโดยประมาณและระยะทางจะพิจารณาการเดินทางที่มีอยู่

VehicleState

สถานะของ Vehicle

Enum
UNKNOWN_VEHICLE_STATE ค่าเริ่มต้นที่ใช้สำหรับสถานะยานพาหนะที่ระบุหรือไม่รู้จัก
OFFLINE ยานพาหนะไม่รับการเดินทางใหม่ หมายเหตุ: ยานพาหนะอาจทำงานต่อไปในสถานะนี้ขณะทำการเดินทางที่ได้รับมอบหมายให้เสร็จสมบูรณ์
ONLINE ยานพาหนะพร้อมรับคำขอเดินทางใหม่

VisualTrafficReportPolylineRendering

อธิบายวิธีที่ไคลเอ็นต์ควรระบายสีส่วนหนึ่งของเส้นประกอบตามเส้นทาง

ช่อง
road_stretch[]

RoadStretch

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

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

RoadStretch

ถนน 1 เส้นที่ควรแสดงผล

ช่อง
style

Style

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

int32

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

int32

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

รูปแบบ

รูปแบบการจราจรที่แสดงความเร็วการจราจร

Enum
STYLE_UNSPECIFIED ไม่ได้เลือกรูปแบบ
SLOWER_TRAFFIC การจราจรเริ่มช้าลง
TRAFFIC_JAM มีการจราจรติดขัด

จุดบอกทาง

อธิบายจุดพักระหว่างทางในเส้นทางของ VehicleMatch ใน SearchVehiclesResponse แนวคิดนี้จะแสดงเป็น TripWaypoint ในปลายทางอื่นๆ ทั้งหมด

ช่อง
lat_lng

LatLng

ตำแหน่งของจุดแวะพักนี้
eta

Timestamp

เวลาโดยประมาณที่ยานพาหนะจะมาถึงจุดสังเกตนี้

WaypointType

ประเภทของจุดสังเกต

Enum
UNKNOWN_WAYPOINT_TYPE ประเภทจุดสังเกตที่ไม่รู้จักหรือไม่ระบุ
PICKUP_WAYPOINT_TYPE จุดแวะรับผู้โดยสารหรือสินค้า
DROP_OFF_WAYPOINT_TYPE จุดแวะส่งผู้โดยสารหรือสินค้า
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE จุดแวะพักสำหรับจุดหมายระหว่างทางในการเดินทางหลายจุดหมาย