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

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

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 ในการตอบกลับ หากไม่ระบุช่องนี้ ระบบจะดึงข้อมูล remaining_waypoints เสมอ

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

string

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

ตัวกรองนี้ทำหน้าที่เป็นอนุประโยค "และ" ที่มีข้อจำกัดอื่นๆ เช่น 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

เวอร์ชันของ 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 ที่เรียกใช้ ซึ่งใช้ได้กับ SDK ของ Android เท่านั้น ตัวอย่างค่าในช่อง: 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

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

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

VehicleMatchOrder

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

bool

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

ตัวกรองนี้ทำหน้าที่เป็นอนุประโยค "และ" ที่มีข้อจำกัดอื่นๆ เช่น 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

ต้องระบุ แสดงตำแหน่งของจุดอ้างอิงของการเดินทาง

TerminalPointId

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

string

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

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

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

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

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

FieldMask

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

string

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

VehicleState

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

TripType

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

string

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

VehicleLocation

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

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 call ได้ทั้งเป็นจุดสังเกตของการเดินทางแบบเต็ม 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 ช่องไว้ในคำตอบ

bool

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

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

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

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

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

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

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

VehicleMatchOrder

คำสั่งซื้อที่ขอในการจัดเรียงยานพาหนะที่ตรงกัน

VehicleMatchOrder

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

RoadStretch

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

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

Style

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

int32

ต้องระบุ ควรใช้รูปแบบระหว่างวันที่ [offset_meters, offset_meters + length_meters)

int32

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

LatLng

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

Timestamp

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