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

(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 รายการในแต่ละรายการ ช่องนี้เป็นการดำเนินการแบบรวม/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 ที่เรียกใช้ ซึ่งใช้ได้กับ SDK ของ Android เท่านั้น ตัวอย่างค่าในช่อง: 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 ใช้ข้อความที่อนุญาตรายการ เมื่อใช้ร่วมกัน ช่องทั้ง 2 ช่องจะประกอบกันเป็นนิพจน์นี้

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

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

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

ข้อมูลนี้ระบุว่ายานพาหนะที่เดินทางอยู่ 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

ตัวกรองนี้ทํางานเป็นเงื่อนไข 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

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

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

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