Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

สถานะแหล่งพลังงานแบตเตอรี่

float

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

SpeedReadingInterval

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

string

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

RequestHeader

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

string

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

string

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

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

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

RequestHeader

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

string

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

string

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

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

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

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

RequestHeader

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

string

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

RequestHeader

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

string

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

LocationPowerSaveMode

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

bool

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

bool

อุปกรณ์อยู่ในสถานะโต้ตอบหรือไม่

BatteryInfo

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

RequestHeader

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

string

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

TripView

ฟิลด์การเดินทางที่เป็นเซ็ตย่อยซึ่งควรแสดงผลและการตีความ

Timestamp

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

Timestamp

เลิกใช้งานแล้ว: ระบบจะดึงข้อมูล Trip.remaining_waypoints เสมอ ใช้ remaining_waypoints_route_version เพื่อควบคุมเวลาที่ระบบดึงข้อมูล Trip.remaining_waypoints.traffic_to_waypoint และ Trip.remaining_waypoints.path_to_waypoint

PolylineFormatType

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

Timestamp

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

Timestamp

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

RequestHeader

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

string

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

Timestamp

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

Timestamp

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

string

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

string

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

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

RequestHeader

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

string

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

int32

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

string

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

Int32Value

ระบุความจุขั้นต่ำที่จำเป็นของยานพาหนะ ยานพาหนะทั้งหมดที่แสดงจะมี maximum_capacity มากกว่าหรือเท่ากับค่านี้ หากตั้งค่าไว้ ต้องมากกว่าหรือเท่ากับ 0

TripType

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

Duration

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

Category

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

string

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

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

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

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

string

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

string

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

required_one_of_attribute_sets ใช้ข้อความที่อนุญาตให้มีรายการของรายการ ซึ่งคล้ายกับ required_one_of_attributes ทำให้สามารถใช้การแสดงออกเช่นนี้ได้

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

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

VehicleState

จำกัดการตอบกลับเฉพาะยานพาหนะที่มีสถานะยานพาหนะนี้

bool

แสดงเฉพาะยานพาหนะที่มีการเดินทางปัจจุบัน

string

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

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

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

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

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

Viewport

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

Vehicle

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

string

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

int64

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

string

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

string

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

BillingPlatformIdentifier

แพลตฟอร์มที่ออกคำขอ

string

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

SolutionType

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

string

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

string

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

string

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

string

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

string

รุ่นของอุปกรณ์ที่ SDK การโทรทำงานอยู่ ตัวอย่างค่าฟิลด์: iPhone12,1, SM-G920F

SdkType

ประเภทของ SDK ที่ส่งคำขอ

string

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

string

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

Platform

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

string

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

int32

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

string

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

RequestHeader

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

string

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

string

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

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

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

int32

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

string

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

Duration

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

Trip

รายการการเดินทางสำหรับยานพาหนะที่ขอ

string

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

RequestHeader

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

string

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

TerminalLocation

ต้องระบุ จุดรับสินค้าที่จะค้นหาในบริเวณใกล้เคียง

TerminalLocation

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

int32

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

int32

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

int32

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

TripType

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

Duration

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

VehicleType

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

VehicleAttribute

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

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

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

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

VehicleAttributeList

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

VehicleAttributeList

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

required_one_of_attribute_sets ใช้ข้อความที่อนุญาตให้มีรายการของรายการ ซึ่งคล้ายกับ required_one_of_attributes ทำให้สามารถใช้การแสดงออกเช่นนี้ได้

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

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

VehicleMatchOrder

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

bool

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

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

string

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

CurrentTripsPresent

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

string

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

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

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

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

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

VehicleMatch

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

int32

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

int32

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

Speed

ความเร็วของการจราจรในช่วงเวลานี้

LatLng

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

Timestamp

ระบุเวลาที่หยุด

Timestamp

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

LatLng

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

string

ชื่อทรัพยากรของสถานที่ที่แสดงถึงตำแหน่งนี้ รูปแบบคือ places/{place_id} ต้องระบุ point หรือ place เป็นอินพุต หากระบุทั้ง 2 อย่าง ระบบจะใช้ point สำหรับการกำหนดเส้นทาง และใช้ place สำหรับข้อมูลเมตา place จะรวมอยู่ในเอาต์พุตก็ต่อเมื่อรวมอยู่ในอินพุต ซึ่งหมายความว่าจะไม่มีการค้นหา place จาก LatLng

นี่เป็นฟีเจอร์ทดลองใช้

PointSource

เอาต์พุตเท่านั้น แหล่งที่มาของฟิลด์ point

TerminalPointId

เลิกใช้งานแล้ว: โปรดระบุช่อง place แทน

string

เลิกใช้งานแล้ว: โปรดระบุช่อง place แทน

string

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

WaypointType

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

string

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

string

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

string

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

VisualTrafficReportPolylineRendering

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

string

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

string

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

TripStatus

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

TripType

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

TerminalLocation

สถานที่ที่ลูกค้าจะรับสินค้า

StopLocation

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

StopLocation

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

Timestamp

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

TerminalLocation

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

Timestamp

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

int32

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

StopLocation

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

StopLocation

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

TerminalLocation

สถานที่ที่ลูกค้าจะลงจากรถ

StopLocation

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

Timestamp

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

TripWaypoint

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

TripWaypoint

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

LatLng

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

TripWaypoint

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

Int32Value

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

Timestamp

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

Duration

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

Timestamp

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

Timestamp

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

int32

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

VehicleLocation

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

bool

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

TripView

ฟิลด์การเดินทางที่เป็นชุดย่อยซึ่งมีการป้อนข้อมูลและวิธีตีความ

TripAttribute

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

string

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

string

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

bool

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

double

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

TerminalLocation

ตำแหน่งของจุดอ้างอิงนี้

string

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

WaypointType

บทบาทของจุดอ้างอิงนี้ในการเดินทาง เช่น จุดรับหรือจุดส่ง

LatLng

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

string

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

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

ConsumableTrafficPolyline

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

Int32Value

ระยะทางของเส้นทางจากจุดพักก่อนหน้าไปยังจุดพักปัจจุบัน หากเป็นจุดแวะพักแรก ระยะทางของเส้นทางจะคำนวณจากตำแหน่งปัจจุบันของยานพาหนะไปยังจุดแวะพัก

Timestamp

เวลาถึงโดยประมาณที่จุดอ้างอิงนี้

Duration

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

RequestHeader

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

string

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

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 หากไม่ตรงกัน คำขอจะไม่สำเร็จ

FieldMask

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

RequestHeader

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

string

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

VehicleAttribute

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

VehicleAttribute

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

RequestHeader

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

string

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

Vehicle

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

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

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

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

FieldMask

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

string

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

VehicleState

สถานะยานพาหนะ

TripType

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

string

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

VehicleLocation

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

VehicleLocation

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

int32

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

VehicleAttribute

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

VehicleType

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

LicensePlate

ข้อมูลป้ายทะเบียนรถ

TerminalLocation

เลิกใช้งานแล้ว: โปรดใช้ Vehicle.waypoints แทน

string

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

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

TrafficPolylineData

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

Timestamp

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

TripWaypoint

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

Int32Value

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

Timestamp

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

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

Int32Value

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

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

TripWaypoint

จุดอ้างอิงที่เหลือที่กำหนดให้กับยานพาหนะนี้

Timestamp

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

bool

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

NavigationStatus

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

DeviceSettings

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

Category

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

string

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

string

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

string

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

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

bool

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

double

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

VehicleAttribute

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

LatLng

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

DoubleValue

เลิกใช้งานแล้ว: โปรดใช้ latlng_accuracy แทน

DoubleValue

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

Int32Value

ทิศทางที่ยานพาหนะเคลื่อนที่ หน่วยเป็นองศา 0 หมายถึงทิศเหนือ ช่วงที่ใช้ได้คือ [0,360)

DoubleValue

เลิกใช้งานแล้ว: โปรดใช้ heading_accuracy แทน

DoubleValue

ความแม่นยำของ heading ในหน่วยองศา

DoubleValue

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

DoubleValue

เลิกใช้งานแล้ว: โปรดใช้ altitude_accuracy แทน

DoubleValue

ความแม่นยำของ altitude ในหน่วยเมตร

Int32Value

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

DoubleValue

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

DoubleValue

ความแม่นยำของ speed ในหน่วยเมตร/วินาที

Timestamp

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

Timestamp

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

LocationSensor

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

BoolValue

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

BoolValue

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

Int32Value

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

Int32Value

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

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

LatLng

ตำแหน่งจาก Fused Location Provider ของ Android

Timestamp

การประทับเวลาของการอัปเดตของ flp_location

DoubleValue

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

Int32Value

ทิศทางที่ยานพาหนะเคลื่อนที่ในหน่วยองศาตามที่กำหนดโดย Fused Location Provider 0 หมายถึงทิศเหนือ ช่วงที่ใช้ได้คือ [0,360)

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

bool

เลิกใช้งานแล้ว: โปรดใช้ is_road_snapped แทน

Vehicle

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

Timestamp

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

Int32Value

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

Int32Value

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

Timestamp

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

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

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

VehicleMatchOrder

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

VehicleMatchOrder

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

RoadStretch

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

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

Style

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

int32

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

int32

ต้องระบุ ความยาวของเส้นทางที่จะใช้สไตล์

LatLng

ตำแหน่งของจุดอ้างอิงนี้

Timestamp

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