Package maps.fleetengine.v1

ดัชนี

TripService

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

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

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

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)

ส่งคืนยานพาหนะจาก Fleet Engine

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
...)

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

required_one_of_attributes[]

string

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

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets มีฟังก์ชันเพิ่มเติม

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

(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 ยานพาหนะต้องตรงกับแอตทริบิวต์ทั้งหมดภายในแต่ละรายการ ช่องนี้เป็นการดำเนินการเชื่อม/และใน VehicleAttributeList แต่ละรายการและการดำเนินงานแบบ Disjunction/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

ตัวกรองนี้จะทำหน้าที่เป็นคำสั่ง "และ" ที่มีข้อจำกัดอื่นๆ เช่น 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 โหมด 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 จะควบคุมคำขอทั้งหมดที่ส่งถึงผู้ให้บริการเมื่ออุปกรณ์ไม่มีการโต้ตอบ

LocationSensor

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

Enum
UNKNOWN_SENSOR ไม่ระบุหรือไม่ทราบเซ็นเซอร์
GPS GPS หรือ Assist
NETWORK GPS ที่ได้รับการสนับสนุน, ID เสาสัญญาณมือถือ หรือจุดเข้าใช้งาน WiFi
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

ส่วนหัวของคำขอมีช่องที่ใช้ร่วมกันกับคำขอ 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 การโทร ซึ่งใช้ได้กับ Android SDK เท่านั้น ตัวอย่างค่าในช่อง 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 ที่เรียกใช้คือผู้ใช้ทั่วไป
DRIVER SDK การเรียกคือไดรเวอร์
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 ประเภท ไม่อนุญาตให้ใช้ยานพาหนะประเภท 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
...)

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

required_one_of_attributes[]

VehicleAttributeList

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

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets มีฟังก์ชันเพิ่มเติม

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

(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 ยานพาหนะต้องตรงกับแอตทริบิวต์ทั้งหมดภายในแต่ละรายการ ช่องนี้เป็นการดำเนินการเชื่อม/และใน VehicleAttributeList แต่ละรายการและการดำเนินงานแบบ Disjunction/OR ทั้งหมดในคอลเล็กชันของ VehicleAttributeList

order_by

VehicleMatchOrder

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

include_back_to_back

bool

ข้อมูลนี้บ่งชี้ว่ายานพาหนะที่มีการเดินทางเพียงครั้งเดียวมีสิทธิ์สำหรับการค้นหานี้หรือไม่ ระบบจะใช้ช่องนี้เมื่อไม่ได้ระบุ 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

ตัวกรองนี้จะทำหน้าที่เป็นคำสั่ง "และ" ที่มีข้อจำกัดอื่นๆ เช่น 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 เรียงลำดับจากน้อยไปมากตามค่าใช้จ่ายการจับคู่ที่กำหนดค่าไว้ การจับคู่ต้นทุนหมายถึงการคำนวณแบบถ่วงน้ำหนักระหว่างระยะทางเส้นตรงกับเวลาถึงโดยประมาณ น้ำหนักมีการตั้งค่าด้วยค่าเริ่มต้น และสามารถแก้ไขได้ต่อลูกค้า 1 ราย โปรดติดต่อทีมสนับสนุนของ Google หากจำเป็นต้องแก้ไขน้ำหนักเหล่านี้สำหรับโปรเจ็กต์ของคุณ

SearchVehiclesResponse

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

ช่อง
matches[]

VehicleMatch

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

SpeedReadingInterval

ตัวบ่งชี้ความหนาแน่นของการจราจรบนส่วนที่อยู่ติดกันของเส้นทาง บนเส้นทางที่มีจุด P_0, P_1, ... , P_N (ดัชนีแบบศูนย์) 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

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

การเดินทาง

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

ช่อง
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

เอาต์พุตเท่านั้น เส้นทางที่คาดไว้สำหรับการเดินทางนี้ไปยังรายการแรกใน left_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_redirect_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 ระบบจะป้อนข้อมูลในช่องการเดินทางสำหรับกรณีการใช้งานของการแชร์เส้นทางการท่องเว็บ มุมมองนี้มีไว้สำหรับการสื่อสารแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์

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 Platform เท่านั้น

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

"ข้อความคำขออัปเดตยานพาหนะ

ช่อง
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 โดยจะเป็นจุดอ้างอิงตลอดเส้นทาง, จุดอ้างอิง 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

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

ช่อง
key

string

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

value

string

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

ฟิลด์สหภาพ vehicle_attribute_value ค่าแอตทริบิวต์อาจเป็นสตริง bool หรือประเภท Double ก็ได้ vehicle_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
string_value

string

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

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

bool_value

bool

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

number_value

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 กับถนนหรือไม่