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)

ส่งคืนยานพาหนะจาก 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
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: '/', ':', '?', ',' หรือ '#'
trip

Trip

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

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

  • trip_type
  • pickup_point

หากคุณระบุข้อมูลไว้ ระบบจะใช้ช่องต่อไปนี้

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

ระบบจะไม่พิจารณาช่อง Trip อื่นๆ ทั้งหมด ตัวอย่างเช่น การเดินทางทั้งหมดขึ้นต้นด้วย 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
  • ต้องไม่มีอักขระ 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 ใช้ข้อความที่อนุญาตชุดรายการ เมื่อใช้ร่วมกัน ฟิลด์สองฟิลด์จะอนุญาตให้มีองค์ประกอบของนิพจน์นี้ได้:

(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 รายการ ซึ่งเท่ากับจำนวนแอตทริบิวต์สูงสุดที่อนุญาตในยานพาหนะ สตริงที่ซ้ำแต่ละรายการควรอยู่ในรูปแบบ "key:value"

required_one_of_attributes[]

string

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

ตัวกรองนี้ทำหน้าที่เป็นอนุประโยค "และ" ที่มีข้อจำกัดอื่นๆ เช่น 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 หรือ GPS ที่ได้รับการสนับสนุน
NETWORK 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 Provider ของ 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 การเรียกใช้ ใช้ได้กับ Android SDK เท่านั้น ตัวอย่างค่าในช่อง: 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 ในการเรียกใช้คือ 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 ประเภท ไม่อนุญาตประเภทยานพาหนะที่มีหมวดหมู่เป็น UNKNOWN

required_attributes[]

VehicleAttribute

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

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

(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 รายการ ซึ่งเท่ากับจำนวนแอตทริบิวต์สูงสุดที่อนุญาตในยานพาหนะ

required_one_of_attributes[]

VehicleAttributeList

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

เลิกใช้งานแล้ว: ไม่รองรับ TerminalPoints ใน Fleet Engine อีกต่อไป โปรดใช้ 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

เอาต์พุตเท่านั้น เส้นทางที่คาดไว้สำหรับการเดินทางนี้ไปยังทางเข้าแรกในfallback_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 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

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

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

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

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

ตำแหน่งของรถดิบ (ไม่ได้ประมวลผลโดยปลากะพงบนท้องถนน)

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

VehicleMatchOrder

ลำดับจริงที่ใช้สำหรับยานพาหนะคันนี้ โดยปกติแล้วค่านี้จะตรงกับแอตทริบิวต์ "order_by" จากคำขอ แต่ในบางกรณี เช่น เกิดข้อผิดพลาดของเซิร์ฟเวอร์ภายใน อาจใช้วิธีการอื่น (เช่น PICKUP_POINT_STRAIGHT_DISTANCE)

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 จุดผ่านสำหรับจุดหมายระดับกลางในการเดินทางหลายจุดหมาย