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

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

RequestHeader

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

string

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

string

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

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

(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"

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 ประเภท ไม่อนุญาตประเภทยานพาหนะที่มีหมวดหมู่เป็น 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
...)

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

VehicleAttributeList

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

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

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

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 จะเป็นจุดอ้างอิงเต็มรูปแบบ จุดอ้างอิง 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

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

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

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