ดัชนี
TripService
(อินเทอร์เฟซ)VehicleService
(อินเทอร์เฟซ)BatteryInfo
(ข้อความ)BatteryStatus
(enum)BillingPlatformIdentifier
(enum)ConsumableTrafficPolyline
(ข้อความ)CreateTripRequest
(ข้อความ)CreateVehicleRequest
(ข้อความ)DeviceSettings
(ข้อความ)GetTripRequest
(ข้อความ)GetVehicleRequest
(ข้อความ)LicensePlate
(ข้อความ)ListVehiclesRequest
(ข้อความ)ListVehiclesResponse
(ข้อความ)LocationPowerSaveMode
(enum)LocationSensor
(enum)NavigationStatus
(enum)PolylineFormatType
(enum)PowerSource
(enum)ReportBillableTripRequest
(ข้อความ)ReportBillableTripRequest.SolutionType
(enum)RequestHeader
(ข้อความ)RequestHeader.Platform
(enum)RequestHeader.SdkType
(enum)SearchTripsRequest
(ข้อความ)SearchTripsResponse
(ข้อความ)SearchVehiclesRequest
(ข้อความ)SearchVehiclesRequest.CurrentTripsPresent
(enum)SearchVehiclesRequest.VehicleMatchOrder
(enum)SearchVehiclesResponse
(ข้อความ)SpeedReadingInterval
(ข้อความ)SpeedReadingInterval.Speed
(enum)StopLocation
(ข้อความ)TerminalLocation
(ข้อความ)TerminalPointId
(ข้อความ) (เลิกใช้งานแล้ว)TrafficPolylineData
(ข้อความ)Trip
(ข้อความ)TripStatus
(enum)TripType
(enum)TripView
(enum)TripWaypoint
(ข้อความ)UpdateTripRequest
(ข้อความ)UpdateVehicleAttributesRequest
(ข้อความ)UpdateVehicleAttributesResponse
(ข้อความ)UpdateVehicleRequest
(ข้อความ)Vehicle
(ข้อความ)Vehicle.VehicleType
(ข้อความ)Vehicle.VehicleType.Category
(enum)VehicleAttribute
(ข้อความ)VehicleAttributeList
(ข้อความ)VehicleLocation
(ข้อความ)VehicleMatch
(ข้อความ)VehicleMatch.VehicleMatchType
(enum)VehicleState
(enum)VisualTrafficReportPolylineRendering
(ข้อความ)VisualTrafficReportPolylineRendering.RoadStretch
(ข้อความ)VisualTrafficReportPolylineRendering.RoadStretch.Style
(enum)Waypoint
(ข้อความ)WaypointType
(enum)
TripService
บริการจัดการการเดินทาง
CreateTrip |
---|
สร้างการเดินทางใน Fleet Engine และส่งคืนการเดินทางใหม่ |
GetTrip |
---|
ดูข้อมูลเกี่ยวกับการเดินทางครั้งเดียว |
ReportBillableTrip |
---|
รายงานการใช้งานการเดินทางที่เรียกเก็บเงินได้ |
SearchTrips |
---|
รับข้อมูลการเดินทางทั้งหมดสำหรับยานพาหนะคันใดคันหนึ่ง |
UpdateTrip |
---|
อัปเดตข้อมูลการเดินทาง |
VehicleService
บริการจัดการยานพาหนะ
CreateVehicle |
---|
ยกตัวอย่างยานพาหนะคันใหม่ที่เชื่อมโยงกับผู้ให้บริการร่วมเดินทางหรือบริการนำส่งแบบออนดีมานด์ ต้องระบุช่อง
ระบบจะไม่สนใจช่อง
ช่องอื่นๆ ทั้งหมดเป็นตัวเลือกและจะใช้ (หากมี) |
GetVehicle |
---|
ส่งคืนยานพาหนะจาก Fleet Engine |
ListVehicles |
---|
ส่งคืนรายการยานพาหนะที่ใส่เลขหน้าซึ่งเชื่อมโยงกับผู้ให้บริการที่ตรงกับตัวเลือกคำขอ |
SearchVehicles |
---|
แสดงรายการยานพาหนะที่ตรงกับตัวเลือกคำขอ |
UpdateVehicle |
---|
เขียนข้อมูลรถที่อัปเดตไปยัง Fleet Engine เมื่ออัปเดต
นอกจากนี้ยานพาหนะ หากอัปเดตช่อง |
UpdateVehicleAttributes |
---|
อัปเดตแอตทริบิวต์ของยานพาหนะบางส่วน ระบบจะอัปเดตเฉพาะแอตทริบิวต์ที่กล่าวถึงในคำขอ แอตทริบิวต์อื่นๆ จะไม่เปลี่ยนแปลง หมายเหตุ: ความแตกต่างใน |
BatteryInfo
ข้อมูลเกี่ยวกับแบตเตอรี่ของอุปกรณ์
ช่อง | |
---|---|
battery_status |
สถานะของแบตเตอรี่ ไม่ว่าจะเต็มหรือชาร์จอยู่ เป็นต้น |
power_source |
สถานะของแหล่งพลังงานแบตเตอรี่ |
battery_percentage |
เปอร์เซ็นต์แบตเตอรี่ปัจจุบัน [0-100] |
BatteryStatus
สถานะของแบตเตอรี่ ไม่ว่าจะเต็มหรือชาร์จอยู่ เป็นต้น
Enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
ไม่ทราบสถานะแบตเตอรี่ |
BATTERY_STATUS_CHARGING |
กำลังชาร์จแบตเตอรี่ |
BATTERY_STATUS_DISCHARGING |
แบตเตอรี่กำลังคายประจุ |
BATTERY_STATUS_FULL |
แบตเตอรี่เต็ม |
BATTERY_STATUS_NOT_CHARGING |
แบตเตอรี่ไม่ชาร์จ |
BATTERY_STATUS_POWER_LOW |
แบตเตอรี่เหลือน้อย |
BillingPlatformIdentifier
ชุดของค่าที่ระบุว่าเป็นแพลตฟอร์มที่ออกคำขอ
Enum | |
---|---|
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED |
ค่าเริ่มต้น ใช้สำหรับแพลตฟอร์มที่ไม่ระบุ |
SERVER |
แพลตฟอร์มนี้เป็นเซิร์ฟเวอร์ไคลเอ็นต์ |
WEB |
แพลตฟอร์มนี้เป็นเว็บเบราว์เซอร์ |
ANDROID |
แพลตฟอร์มนี้เป็นอุปกรณ์เคลื่อนที่ Android |
IOS |
แพลตฟอร์มดังกล่าวเป็นอุปกรณ์เคลื่อนที่ iOS |
OTHERS |
แพลตฟอร์มอื่นๆ ที่ไม่ได้ระบุในการแจงนับนี้ |
ConsumableTrafficPolyline
ความหนาแน่นของการจราจรตามเส้นทางของยานพาหนะ
ช่อง | |
---|---|
speed_reading_interval[] |
ความเร็วของการจราจรตามเส้นทางจากจุดอ้างอิงก่อนหน้าไปยังจุดอ้างอิงปัจจุบัน |
encoded_path_to_waypoint |
เส้นทางที่คนขับใช้จากจุดอ้างอิงก่อนหน้าไปยังจุดอ้างอิงปัจจุบัน เส้นทางนี้มีจุดสังเกตเพื่อให้ลูกค้าสามารถแสดงเครื่องหมายจราจรตลอดเส้นทาง (ดู |
CreateTripRequest
ข้อความคำขอ CreateTrip
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
parent |
ต้องระบุ ต้องอยู่ในรูปแบบ |
trip_id |
ต้องระบุ รหัสการเดินทางที่ไม่ซ้ำกัน อยู่ภายใต้ข้อจำกัดต่อไปนี้
|
trip |
ต้องระบุ เอนทิตีการเดินทางที่จะสร้าง เมื่อสร้างทริป คุณต้องระบุข้อมูลในช่องต่อไปนี้
หากระบุข้อมูลในช่องต่อไปนี้ ระบบจะใช้ช่องต่อไปนี้
ระบบจะไม่สนใจช่องการเดินทางอื่นๆ ทั้งหมด ตัวอย่างเช่น การเดินทางทั้งหมดเริ่มต้นด้วย มีเพียง เมื่อตั้งค่า เมื่อคุณระบุ ระบบจะใช้ช่อง |
CreateVehicleRequest
ข้อความคำขอ CreateVehicle
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
parent |
ต้องระบุ ต้องอยู่ในรูปแบบ |
vehicle_id |
ต้องระบุ รหัสยานพาหนะที่ไม่ซ้ำกัน อยู่ภายใต้ข้อจำกัดต่อไปนี้
|
vehicle |
ต้องระบุ เอนทิตียานพาหนะที่จะสร้าง เมื่อสร้างยานพาหนะ คุณต้องระบุข้อมูลต่อไปนี้
เมื่อสร้างยานพาหนะ ระบบจะไม่สนใจช่องต่อไปนี้
ช่องอื่นๆ ทั้งหมดเป็นตัวเลือกและจะใช้ (หากมี) |
DeviceSettings
ข้อมูลเกี่ยวกับการตั้งค่าต่างๆ บนอุปกรณ์เคลื่อนที่
ช่อง | |
---|---|
location_power_save_mode |
วิธีการตั้งค่าฟีเจอร์ตำแหน่งให้ทํางานในอุปกรณ์เมื่อโหมดประหยัดแบตเตอรี่เปิดอยู่ |
is_power_save_mode |
ระบุว่าอุปกรณ์อยู่ในโหมดประหยัดพลังงานหรือไม่ |
is_interactive |
ระบุว่าอุปกรณ์อยู่ในสถานะอินเทอร์แอกทีฟหรือไม่ |
battery_info |
ข้อมูลเกี่ยวกับสถานะแบตเตอรี่ |
GetTripRequest
ข้อความคำขอ GetTrip
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
name |
ต้องระบุ ต้องอยู่ในรูปแบบ |
view |
ชุดย่อยของฟิลด์การเดินทางที่ควรส่งคืนและการตีความ |
current_route_segment_version |
ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่จะดึงข้อมูล |
remaining_waypoints_version |
ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่มีการเรียกข้อมูล |
route_format_type |
รูปแบบเส้นทางปัจจุบันที่แสดงผล |
current_route_segment_traffic_version |
ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่มีการเรียกข้อมูล |
remaining_waypoints_route_version |
ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่จะดึงข้อมูล |
GetVehicleRequest
ข้อความคำขอ GetVehicle
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
name |
ต้องระบุ ต้องอยู่ในรูปแบบ |
current_route_segment_version |
ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่มีการเรียกข้อมูล |
waypoints_version |
ระบุการประทับเวลาขั้นต่ำ (ไม่รวม) ที่มีการเรียกข้อมูล |
LicensePlate
ข้อมูลป้ายทะเบียนรถ เพื่อหลีกเลี่ยงการจัดเก็บข้อมูลส่วนบุคคลที่สามารถระบุตัวตนได้ มีเพียงข้อมูลขั้นต่ำเกี่ยวกับป้ายทะเบียนรถเท่านั้นที่จะเก็บไว้ในฐานะส่วนหนึ่งของหน่วยงาน
ช่อง | |
---|---|
country_code |
ต้องระบุ รหัสประเทศ/ภูมิภาค CLDR เช่น |
last_character |
ตัวเลขสุดท้ายของป้ายทะเบียนรถหรือ "-1" เพื่อระบุว่าไม่มีค่าตัวเลขอยู่ในป้ายทะเบียน
|
ListVehiclesRequest
ข้อความคำขอ ListVehicles
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
parent |
ต้องระบุ ต้องอยู่ในรูปแบบ |
page_size |
จำนวนสูงสุดของยานพาหนะที่จะส่งคืน ค่าเริ่มต้นคือ 100 |
page_token |
ค่าของ |
minimum_capacity |
ระบุความจุขั้นต่ำที่ต้องการของยานพาหนะ ยานพาหนะทั้งหมดที่ส่งคืนจะมี |
trip_types[] |
จำกัดการตอบสนองสำหรับยานพาหนะที่รองรับประเภทการเดินทางที่ระบุอย่างน้อย 1 ประเภท |
maximum_staleness |
จำกัดการตอบสนองของยานพาหนะที่ส่งการอัปเดตตำแหน่งไปยัง Fleet Engine ภายในระยะเวลาที่กำหนด ยานพาหนะที่อยู่นิ่งที่ยังคงส่งข้อมูลตำแหน่งอยู่ไม่ถือว่าไม่มีอัปเดต หากมี ต้องเป็นระยะเวลาเป็นจำนวนบวกที่ถูกต้อง |
vehicle_type_categories[] |
ต้องระบุ จำกัดการตอบสนองสำหรับยานพาหนะที่มีหมวดหมู่ประเภทที่ระบุไว้ ไม่อนุญาต |
required_attributes[] |
ผู้โทรจะสร้างการดำเนินการเชิงตรรกะที่ซับซ้อนได้โดยใช้การผสมช่อง
จำกัดการตอบสนองสำหรับยานพาหนะที่มีแอตทริบิวต์ที่ระบุ ช่องนี้เป็นการดำเนินการเชื่อม/และ ต้องระบุ required_attribute สูงสุด 50 รายการ ซึ่งเท่ากับจำนวนแอตทริบิวต์สูงสุดที่อนุญาตในยานพาหนะ 1 คัน สตริงที่ซ้ำแต่ละรายการควรอยู่ในรูปแบบ "key:value" |
required_one_of_attributes[] |
จำกัดการตอบสนองสำหรับยานพาหนะที่มีแอตทริบิวต์ที่ระบุอย่างน้อย 1 รายการใน |
required_one_of_attribute_sets[] |
เช่นเดียวกับ
จำกัดการตอบสนองสำหรับยานพาหนะที่ตรงกับแอตทริบิวต์ทั้งหมดใน |
vehicle_state |
จำกัดการตอบสนองเฉพาะยานพาหนะที่มีสถานะนี้ |
on_trip_only |
ส่งคืนเฉพาะยานพาหนะที่มีการเดินทางในปัจจุบัน |
filter |
ไม่บังคับ คำค้นหาตัวกรองที่จะนำไปใช้เมื่อแสดงยานพาหนะ ดูตัวอย่างไวยากรณ์ของตัวกรองได้ที่ http://aip.dev/160 ช่องนี้ออกแบบมาเพื่อแทนที่ช่อง ตัวกรองนี้จะทำหน้าที่เป็นคำสั่ง "และ" ที่มีข้อจำกัดอื่นๆ เช่น โปรดทราบว่าการค้นหาที่รองรับมีแค่ในแอตทริบิวต์ยานพาหนะเท่านั้น (เช่น นอกจากนี้ แอตทริบิวต์ทั้งหมดจะจัดเก็บเป็นสตริง ดังนั้นการเปรียบเทียบกับแอตทริบิวต์ที่รองรับจึงเป็นการเปรียบเทียบสตริงเท่านั้น ในการเปรียบเทียบกับตัวเลขหรือค่าบูลีน ค่าจะต้องได้รับการยกข้อความมาอย่างชัดเจนเพื่อให้ถือว่าเป็นสตริง (เช่น |
viewport |
ไม่บังคับ ตัวกรองซึ่งจำกัดยานพาหนะที่ส่งคืนไปยังยานพาหนะที่ตำแหน่งที่ทราบล่าสุดอยู่ในพื้นที่สี่เหลี่ยมผืนผ้าซึ่งกำหนดโดยวิวพอร์ต |
ListVehiclesResponse
ListVehicles
ข้อความตอบกลับ
ช่อง | |
---|---|
vehicles[] |
ยานพาหนะที่ตรงกับเกณฑ์ในคำขอ จำนวนสูงสุดของยานพาหนะที่ส่งคืนจะกำหนดโดยช่อง |
next_page_token |
โทเค็นสำหรับเรียกดูหน้าถัดไปของยานพาหนะ หรือเว้นว่างไว้หากไม่มียานพาหนะที่ตรงตามเกณฑ์คำขออีก |
total_size |
ต้องระบุ จำนวนยานพาหนะทั้งหมดที่ตรงกับเกณฑ์คำขอในทุกหน้า |
LocationPowerSaveMode
วิธีกำหนดค่าฟีเจอร์ตำแหน่งให้ทำงานบนอุปกรณ์เคลื่อนที่เมื่อฟีเจอร์ "ประหยัดแบตเตอรี่" ของอุปกรณ์เปิดอยู่ (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
โหมด PowerSaveMode ที่ไม่ได้กำหนด |
LOCATION_MODE_NO_CHANGE |
ผู้ให้บริการตำแหน่งไม่ควรได้รับผลกระทบจากโหมดประหยัดแบตเตอรี่หรือโหมดประหยัดแบตเตอรี่ปิดอยู่ |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
ควรปิดใช้ผู้ให้บริการตำแหน่งที่ใช้ GPS เมื่อโหมดประหยัดแบตเตอรี่เปิดอยู่และอุปกรณ์ไม่มีการโต้ตอบ |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
ควรปิดใช้ผู้ให้บริการตำแหน่งทั้งหมดเมื่อโหมดประหยัดแบตเตอรี่เปิดอยู่และอุปกรณ์ไม่มีการโต้ตอบ |
LOCATION_MODE_FOREGROUND_ONLY |
ผู้ให้บริการตำแหน่งทั้งหมดจะยังคงใช้งานได้ แต่ควรแก้ไขตำแหน่งสำหรับแอปที่ทำงานอยู่เบื้องหน้าเท่านั้น |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
ระบบจะไม่ปิดตำแหน่ง แต่ LocationManager จะควบคุมคำขอทั้งหมดที่ส่งถึงผู้ให้บริการเมื่ออุปกรณ์ไม่มีการโต้ตอบ |
LocationSensor
เซ็นเซอร์หรือระเบียบวิธีที่ใช้ระบุตำแหน่ง
Enum | |
---|---|
UNKNOWN_SENSOR |
ไม่ระบุหรือไม่ทราบเซ็นเซอร์ |
GPS |
GPS หรือ Assist |
NETWORK |
GPS ที่ได้รับการสนับสนุน, ID เสาสัญญาณมือถือ หรือจุดเข้าใช้งาน WiFi |
PASSIVE |
รหัสเสาสัญญาณมือถือหรือจุดเข้าใช้งาน Wi-Fi |
ROAD_SNAPPED_LOCATION_PROVIDER |
ตำแหน่งที่มาจากอุปกรณ์เคลื่อนที่ ซึ่งเป็นตำแหน่งที่น่าจะมาจากถนน |
CUSTOMER_SUPPLIED_LOCATION |
สถานที่ตั้งที่ลูกค้าจัดหาให้จากแหล่งที่มาอิสระ โดยปกติแล้ว ค่านี้จะใช้สำหรับตำแหน่งที่มาจากแหล่งที่มาอื่นๆ ที่ไม่ใช่อุปกรณ์เคลื่อนที่ที่ใช้ Driver SDK หากค่า Enum อื่นๆ อธิบายถึงแหล่งที่มาเดิม ให้ใช้ค่านั้น โดยปกติแล้ว ตำแหน่งที่ทำเครื่องหมาย CUSTOMER_SUPPLIED_LOCATION จะให้บริการผ่าน last_location.supplemental_location_sensor ของยานพาหนะ |
FLEET_ENGINE_LOCATION |
ตำแหน่งที่คำนวณโดย Fleet Engine โดยอิงตามสัญญาณที่มีอยู่ เอาต์พุตเท่านั้น ระบบจะปฏิเสธค่านี้หากได้รับคำขอ |
FUSED_LOCATION_PROVIDER |
ผู้ให้บริการ Fused Location ของ Android |
CORE_LOCATION |
ผู้ให้บริการตำแหน่งในระบบปฏิบัติการ Apple |
PolylineFormatType
ประเภทของรูปแบบเส้นประกอบ
Enum | |
---|---|
UNKNOWN_FORMAT_TYPE |
ไม่ได้ระบุหรือไม่รู้จักรูปแบบ |
LAT_LNG_LIST_TYPE |
รายการ google.type.LatLng |
ENCODED_POLYLINE_TYPE |
โพลีไลน์ที่เข้ารหัสด้วยอัลกอริทึมการบีบอัดโพลีไลน์ ยังไม่รองรับการถอดรหัส |
PowerSource
ประเภทของที่ชาร์จที่ใช้ชาร์จแบตเตอรี่
Enum | |
---|---|
UNKNOWN_POWER_SOURCE |
ไม่ทราบแหล่งพลังงาน |
POWER_SOURCE_AC |
แหล่งจ่ายไฟเป็นที่ชาร์จ AC |
POWER_SOURCE_USB |
แหล่งจ่ายไฟเป็นพอร์ต USB |
POWER_SOURCE_WIRELESS |
แหล่งจ่ายไฟเป็นแบบไร้สาย |
POWER_SOURCE_UNPLUGGED |
ไม่ได้เสียบปลั๊กแบตเตอรี่ไว้ |
ReportBillableTripRequest
ข้อความคำขอ ReportBillableTrip
ช่อง | |
---|---|
name |
ต้องระบุ ต้องอยู่ในรูปแบบ |
country_code |
ต้องระบุ รหัสประเทศ 2 ตัวอักษรของประเทศที่มีการเดินทาง ราคาจะกำหนดตามรหัสประเทศ |
platform |
แพลตฟอร์มที่มีการออกคำขอ |
related_ids[] |
ตัวระบุที่เกี่ยวข้องโดยตรงกับการเดินทางที่รายงาน ซึ่งมักจะเป็นรหัส (เช่น รหัสเซสชัน) ของการดำเนินการจองล่วงหน้าที่ดำเนินการก่อนที่รหัสการเดินทางจะพร้อมใช้งาน จํานวน |
solution_type |
ประเภทโซลูชันผลิตภัณฑ์ GMP (เช่น |
SolutionType
ตัวเลือกสำหรับโซลูชันประเภทต่างๆ ของการเดินทางที่รายงาน
Enum | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
ค่าเริ่มต้น API จะใช้ ON_DEMAND_RIDESHARING_AND_DELIVERIES โดยค่าเริ่มต้น ซึ่งเป็นโซลูชันประเภทแรกที่รองรับสำหรับความเข้ากันได้แบบย้อนหลัง |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
โซลูชันนี้คือบริการร่วมเดินทางและการจัดส่งพัสดุตามคำขอ |
RequestHeader
ส่วนหัวของคำขอมีช่องที่ใช้ร่วมกันกับคำขอ RPC ของ Fleet Engine ทั้งหมด
ช่อง | |
---|---|
language_code |
รหัสภาษา BCP-47 เช่น en-US หรือ sr-Latn ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier หากไม่ได้ระบุ คำตอบอาจเป็นภาษาใดก็ได้ โดยเลือกใช้ภาษาอังกฤษหากมีชื่อดังกล่าว ตัวอย่างค่าในช่อง |
region_code |
ต้องระบุ รหัสภูมิภาคของ CLDR ของภูมิภาคที่ส่งคำขอ ตัวอย่างค่าในช่อง |
sdk_version |
เวอร์ชันของ SDK การโทร (หากมี) รูปแบบเวอร์ชันคือ "major.minor.patch" เช่น |
os_version |
เวอร์ชันของระบบปฏิบัติการที่ SDK การเรียกใช้ทำงานอยู่ ตัวอย่างค่าในช่อง: |
device_model |
รุ่นของอุปกรณ์ที่ SDK การโทรทำงานอยู่ ตัวอย่างค่าในช่อง: |
sdk_type |
ประเภทของ SDK ที่ส่งคำขอ |
maps_sdk_version |
เวอร์ชันของ MapSDK ที่ SDK การเรียกใช้ต้องใช้ (หากมี) รูปแบบเวอร์ชันคือ "major.minor.patch" เช่น |
nav_sdk_version |
เวอร์ชันของ NavSDK ที่ SDK การเรียกใช้ต้องใช้ (หากมี) รูปแบบเวอร์ชันคือ "major.minor.patch" เช่น |
platform |
แพลตฟอร์มของ SDK การโทร |
manufacturer |
ผู้ผลิตอุปกรณ์ Android จาก SDK การโทร ซึ่งใช้ได้กับ Android SDK เท่านั้น ตัวอย่างค่าในช่อง |
android_api_level |
ระดับ API ของ Android ของ SDK การโทร ซึ่งใช้ได้กับ SDK ของ Android เท่านั้น ตัวอย่างค่าในช่อง |
trace_id |
รหัสที่ไม่บังคับซึ่งมีไว้สำหรับการบันทึกเพื่อระบุคำขอ |
แพลตฟอร์ม
แพลตฟอร์มของ SDK การโทร
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
ค่าเริ่มต้น ระบบจะใช้ค่านี้หากไม่ได้ระบุแพลตฟอร์ม |
ANDROID |
คำขอมาจาก Android |
IOS |
คำขอมาจาก iOS |
WEB |
คำขอดังกล่าวมาจากเว็บ |
SdkType
ประเภท SDK ที่เป็นไปได้
Enum | |
---|---|
SDK_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ระบบจะใช้ค่านี้หากไม่ระบุ sdk_type |
CONSUMER |
SDK ที่เรียกใช้คือผู้ใช้ทั่วไป |
DRIVER |
SDK การเรียกคือไดรเวอร์ |
JAVASCRIPT |
SDK การเรียกคือ JavaScript |
SearchTripsRequest
ข้อความคำขอ SearchTrips
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
parent |
ต้องระบุ ต้องอยู่ในรูปแบบ |
vehicle_id |
ยานพาหนะที่เชื่อมโยงกับการเดินทางในคำขอ หากไม่ระบุ การเดินทางกลับจะไม่มีข้อมูลต่อไปนี้
|
active_trips_only |
หากตั้งค่าเป็น "จริง" การตอบกลับจะรวม "การเดินทาง" ที่ส่งผลต่อเส้นทางของคนขับ |
page_size |
หากไม่ได้ตั้งค่า เซิร์ฟเวอร์จะกำหนดจำนวนผลลัพธ์ที่จะแสดง |
page_token |
ตั้งค่านี้เป็นค่าที่เคยแสดงผลก่อนหน้านี้ใน |
minimum_staleness |
หากระบุ ระบบจะแสดงผลการเดินทางที่ยังไม่ได้อัปเดตหลังจากเวลา |
SearchTripsResponse
ข้อความตอบกลับ SearchTrips
ช่อง | |
---|---|
trips[] |
รายการการเดินทางของยานพาหนะที่ขอ |
next_page_token |
ส่งโทเค็นนี้ใน SearchTripsRequest เพื่อไปยังหน้าผลการค้นหารายการ API จะแสดงผลรายการการเดินทางในแต่ละการเรียก และเมื่อไม่มีผลลัพธ์เพิ่มเติมอีก รายการการเดินทางจะว่างเปล่า |
SearchVehiclesRequest
ข้อความคำขอ SearchVehicles
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
parent |
ต้องระบุ ต้องอยู่ในรูปแบบ |
pickup_point |
ต้องระบุ จุดรับสินค้าที่จะค้นหาใกล้ๆ |
dropoff_point |
สถานที่ส่งของลูกค้าที่ต้องการ ต้องกรอกข้อมูลในช่องนี้หาก |
pickup_radius_meters |
ต้องระบุ กำหนดรัศมีการค้นหารถรอบๆ จุดรับ ระบบจะแสดงเฉพาะยานพาหนะที่อยู่ในรัศมีการค้นหาเท่านั้น ค่าต้องอยู่ระหว่าง 400 ถึง 10,000 เมตร (รวม) |
count |
ต้องระบุ ระบุจำนวนสูงสุดของยานพาหนะที่จะส่งคืน ค่าต้องอยู่ระหว่าง 1 ถึง 50 (รวม) |
minimum_capacity |
ต้องระบุ ระบุจำนวนผู้โดยสารที่ต้องใช้ในการเดินทาง ค่าต้องมากกว่าหรือเท่ากับ 1 ไม่ได้พิจารณาคนขับในค่าความจุ |
trip_types[] |
ต้องระบุ แสดงประเภทการเดินทางที่เสนอ ต้องมีเพียงประเภทเดียว ไม่อนุญาต |
maximum_staleness |
จำกัดการค้นหาเฉพาะยานพาหนะที่ส่งการอัปเดตตำแหน่งไปยัง Fleet Engine ภายในระยะเวลาที่กำหนด ยานพาหนะที่อยู่นิ่งที่ยังคงส่งข้อมูลตำแหน่งอยู่ไม่ถือว่าไม่มีอัปเดต หากไม่ได้ตั้งค่าช่องนี้ เซิร์ฟเวอร์จะใช้ 5 นาทีเป็นค่าเริ่มต้น |
vehicle_types[] |
ต้องระบุ จำกัดการค้นหาเฉพาะยานพาหนะที่มีหนึ่งในประเภทที่ระบุ ต้องระบุประเภทยานพาหนะอย่างน้อย 1 ประเภท ไม่อนุญาตให้ใช้ยานพาหนะประเภท |
required_attributes[] |
ผู้โทรจะสร้างการดำเนินการเชิงตรรกะที่ซับซ้อนได้โดยใช้การผสมช่อง
จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุ ช่องนี้เป็นการดำเนินการเชื่อม/และ ต้องระบุ required_attribute สูงสุด 50 รายการ ซึ่งเท่ากับจำนวนแอตทริบิวต์สูงสุดที่อนุญาตในยานพาหนะ 1 คัน |
required_one_of_attributes[] |
จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ที่ระบุอย่างน้อย 1 รายการใน |
required_one_of_attribute_sets[] |
เช่นเดียวกับ
จำกัดการค้นหาเฉพาะยานพาหนะที่มีแอตทริบิวต์ทั้งหมดใน |
order_by |
ต้องระบุ ระบุเกณฑ์การจัดลำดับที่ต้องการสำหรับผลลัพธ์ |
include_back_to_back |
ข้อมูลนี้บ่งชี้ว่ายานพาหนะที่มีการเดินทางเพียงครั้งเดียวมีสิทธิ์สำหรับการค้นหานี้หรือไม่ ระบบจะใช้ช่องนี้เมื่อไม่ได้ระบุ ค่าเริ่มต้นคือ |
trip_id |
ระบุการเดินทางที่เกี่ยวข้องกับ |
current_trips_present |
ข้อมูลนี้ระบุว่ายานพาหนะที่มีการเดินทางที่ใช้งานอยู่มีสิทธิ์ใช้การค้นหานี้หรือไม่ ต้องตั้งค่านี้เป็นอย่างอื่นที่ไม่ใช่ |
filter |
ไม่บังคับ ตัวกรองการค้นหาที่ใช้เมื่อค้นหายานพาหนะ ดูตัวอย่างไวยากรณ์ของตัวกรองได้ที่ http://aip.dev/160 ช่องนี้ออกแบบมาเพื่อแทนที่ช่อง ตัวกรองนี้จะทำหน้าที่เป็นคำสั่ง "และ" ที่มีข้อจำกัดอื่นๆ เช่น โปรดทราบว่าการค้นหาที่รองรับมีแค่ในแอตทริบิวต์ยานพาหนะเท่านั้น (เช่น นอกจากนี้ แอตทริบิวต์ทั้งหมดจะจัดเก็บเป็นสตริง ดังนั้นการเปรียบเทียบกับแอตทริบิวต์ที่รองรับจึงเป็นการเปรียบเทียบสตริงเท่านั้น ในการเปรียบเทียบกับตัวเลขหรือค่าบูลีน ค่าจะต้องได้รับการยกข้อความมาอย่างชัดเจนเพื่อให้ถือว่าเป็นสตริง (เช่น |
CurrentTripsPresent
ระบุประเภทของข้อจำกัดในการเดินทางปัจจุบันของยานพาหนะ
Enum | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
ความพร้อมให้บริการของยานพาหนะที่มีการเดินทางจะอยู่ในบังคับของฟิลด์ include_back_to_back |
NONE |
ยานพาหนะที่ไม่มีการเดินทางอาจปรากฏในผลการค้นหา เมื่อใช้ค่านี้ include_back_to_back จะเป็น true ไม่ได้ |
ANY |
ยานพาหนะที่มีการเดินทางในปัจจุบันไม่เกิน 5 รายการและจุดอ้างอิง 10 แห่งจะรวมอยู่ในผลการค้นหา เมื่อใช้ค่านี้ include_back_to_back จะเป็น true ไม่ได้ |
VehicleMatchOrder
ระบุลำดับของยานพาหนะที่ตรงกันในการตอบกลับ
Enum | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
ค่าเริ่มต้น ใช้สำหรับลำดับการจับคู่ยานพาหนะที่ไม่ได้ระบุหรือไม่รู้จัก |
PICKUP_POINT_ETA |
ลำดับจากน้อยไปมากโดยใช้เวลาขับรถไปยังจุดรับสินค้า |
PICKUP_POINT_DISTANCE |
ลำดับจากน้อยไปมากตามระยะทางขับรถไปยังจุดรับสินค้า |
DROPOFF_POINT_ETA |
ลำดับจากน้อยไปมากตามเวลาในการขับยานพาหนะไปยังจุดส่ง ลำดับนี้จะใช้ได้เฉพาะเมื่อมีการระบุจุดส่งในคำขอเท่านั้น |
PICKUP_POINT_STRAIGHT_DISTANCE |
ลำดับจากน้อยไปมากตามระยะทางแบบเส้นตรงจากตำแหน่งที่รายงานล่าสุดของยานพาหนะไปยังจุดรับสินค้า |
COST |
เรียงลำดับจากน้อยไปมากตามค่าใช้จ่ายการจับคู่ที่กำหนดค่าไว้ การจับคู่ต้นทุนหมายถึงการคำนวณแบบถ่วงน้ำหนักระหว่างระยะทางเส้นตรงกับเวลาถึงโดยประมาณ น้ำหนักมีการตั้งค่าด้วยค่าเริ่มต้น และสามารถแก้ไขได้ต่อลูกค้า 1 ราย โปรดติดต่อทีมสนับสนุนของ Google หากจำเป็นต้องแก้ไขน้ำหนักเหล่านี้สำหรับโปรเจ็กต์ของคุณ |
SearchVehiclesResponse
SearchVehicles
ข้อความตอบกลับ
ช่อง | |
---|---|
matches[] |
รายการยานพาหนะที่ตรงกับเกณฑ์ |
SpeedReadingInterval
ตัวบ่งชี้ความหนาแน่นของการจราจรบนส่วนที่อยู่ติดกันของเส้นทาง บนเส้นทางที่มีจุด P_0, P_1, ... , P_N (ดัชนีแบบศูนย์) SpeedReadingInterval จะกำหนดช่วงและอธิบายปริมาณการใช้งานโดยใช้หมวดหมู่ต่อไปนี้
ช่อง | |
---|---|
start_polyline_point_index |
ดัชนีเริ่มต้นของช่วงเวลานี้ในเส้นทาง ใน JSON เมื่อดัชนีเป็น 0 ช่องจะต้องไม่มีการป้อนข้อมูล |
end_polyline_point_index |
ดัชนีสิ้นสุดของช่วงเวลานี้ในเส้นทาง ใน JSON เมื่อดัชนีเป็น 0 ช่องจะต้องไม่มีการป้อนข้อมูล |
speed |
ความเร็วของการจราจรในช่วงเวลานี้ |
ความเร็ว
การจัดประเภทความเร็วเส้นประกอบตามข้อมูลการจราจร
Enum | |
---|---|
SPEED_UNSPECIFIED |
ค่าเริ่มต้น ค่านี้ไม่ได้ใช้ |
NORMAL |
ความเร็วปกติ ไม่พบความเร็วที่ลดลง |
SLOW |
ตรวจพบการจราจรชะลอตัว แต่การจราจรไม่ติดขัด |
TRAFFIC_JAM |
ตรวจพบการจราจรติดขัด |
StopLocation
ตำแหน่งจริงที่มีจุดแวะ (ไปรับ/ส่ง)
ช่อง | |
---|---|
point |
ต้องระบุ ระบุตำแหน่งจริง |
timestamp |
ระบุเวลาที่หยุด |
stop_time |
อินพุตเท่านั้น เลิกใช้งานแล้ว ใช้ช่องการประทับเวลา |
TerminalLocation
อธิบายตำแหน่งของจุดอ้างอิง
ช่อง | |
---|---|
point |
ต้องระบุ แสดงตำแหน่งของจุดอ้างอิงการเดินทาง |
terminal_point_id |
เลิกใช้งานแล้ว: โปรดระบุช่อง |
access_point_id |
เลิกใช้งานแล้ว: โปรดระบุช่อง |
trip_id |
เลิกใช้งานแล้ว |
terminal_location_type |
เลิกใช้งาน: |
TerminalPointId
เลิกใช้งาน: Fleet Engine ไม่รองรับ TerminalPoints อีกต่อไป โปรดใช้ TerminalLocation.point
แทน
ช่อง | |
---|---|
value |
เลิกใช้งานแล้ว |
ฟิลด์สหภาพ Id เลิกใช้งานแล้ว Id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
place_id |
เลิกใช้งานแล้ว |
generated_id |
เลิกใช้งานแล้ว |
TrafficPolylineData
สภาพการจราจรบนเส้นทางที่ยานพาหนะที่คาดไว้
ช่อง | |
---|---|
traffic_rendering |
การแสดงผลแบบเส้นประกอบที่แสดงว่าการจราจรรวดเร็วเพียงใดในทุกภูมิภาคตลอดการเดินทางของลูกค้า 1 ครั้ง |
การเดินทาง
ข้อมูลเมตาของการเดินทาง
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ในรูปแบบ "providers/{provider}/trips/{trip}" |
vehicle_id |
รหัสของยานพาหนะที่ใช้ในการเดินทางนี้ |
trip_status |
สถานะปัจจุบันของการเดินทาง |
trip_type |
ประเภทของการเดินทาง |
pickup_point |
สถานที่ที่ลูกค้าระบุว่าให้มารับสินค้า |
actual_pickup_point |
อินพุตเท่านั้น ตำแหน่งจริงเวลาและสถานที่ที่ลูกค้ามารับ ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการรับสินค้าจริง |
actual_pickup_arrival_point |
อินพุตเท่านั้น เวลาและสถานที่จริงของคนขับรถที่มาถึงจุดรับ ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการมาถึงจริงที่จุดรับสินค้า |
pickup_time |
เอาต์พุตเท่านั้น เวลาโดยประมาณในอนาคตที่จะมารับผู้โดยสาร หรือเวลาจริงตอนมารับผู้โดยสาร |
intermediate_destinations[] |
จุดแวะระหว่างทางสำหรับการขอการเดินทาง (นอกเหนือจากการรับและส่ง) ในช่วงแรก ระบบจะไม่รองรับการเดินทางที่แชร์ร่วมกัน |
intermediate_destinations_version |
ระบุเวลาล่าสุดที่มีการแก้ไข |
intermediate_destination_index |
เมื่อ |
actual_intermediate_destination_arrival_points[] |
อินพุตเท่านั้น เวลาและตําแหน่งจริงที่คนขับจะไปถึงปลายทางระดับกลาง ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการมาถึงจริงของปลายทางระดับกลาง |
actual_intermediate_destinations[] |
อินพุตเท่านั้น เวลาและสถานที่จริงเวลาและสถานที่ที่ลูกค้าไปรับลูกค้าจากปลายทางระดับกลาง ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการรับสินค้าจริงที่ปลายทางระดับกลาง |
dropoff_point |
สถานที่ที่ลูกค้าระบุว่าจะออกเดินทาง |
actual_dropoff_point |
อินพุตเท่านั้น เวลาและสถานที่จริงเวลาและสถานที่ที่ลูกค้าออกไป ช่องนี้มีไว้เพื่อให้ผู้ให้บริการแสดงความคิดเห็นเกี่ยวกับข้อมูลการออกจริง |
dropoff_time |
เอาต์พุตเท่านั้น ไม่ว่าจะเป็นเวลาในอนาคตโดยประมาณที่จะลงรถที่จุดหมายสุดท้ายหรือเวลาจริงที่ขึ้นเครื่อง |
remaining_waypoints[] |
เอาต์พุตเท่านั้น เส้นทางทั้งหมดจากตำแหน่งปัจจุบันไปยังจุดส่ง (รวม) เส้นทางนี้อาจมีจุดอ้างอิงจากการเดินทางอื่นๆ |
vehicle_waypoints[] |
ฟิลด์นี้รองรับการเรียงลำดับจุดอ้างอิงสำหรับการเดินทางด้วยตนเอง ซึ่งมีจุดอ้างอิงที่เหลือทั้งหมดสำหรับรถที่กำหนดไว้ ตลอดจนจุดรับและขึ้นลงรถสำหรับการเดินทางครั้งนี้ หากไม่มีการกำหนดการเดินทางให้กับยานพาหนะ Fleet Engine จะไม่สนใจช่องนี้ เพื่อความเป็นส่วนตัว ฟิลด์นี้จะป้อนข้อมูลโดยเซิร์ฟเวอร์ในการเรียก |
route[] |
เอาต์พุตเท่านั้น เส้นทางที่คาดไว้สำหรับการเดินทางนี้ไปยังรายการแรกใน left_waypoints โปรดทราบว่าจุดอ้างอิงแรกอาจเป็นของการเดินทางอื่น |
current_route_segment |
เอาต์พุตเท่านั้น เส้นทางที่เข้ารหัสไปยังจุดอ้างอิงถัดไป หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น ยังไม่รองรับการถอดรหัส |
current_route_segment_version |
เอาต์พุตเท่านั้น ระบุครั้งล่าสุดที่เส้นทางมีการแก้ไข หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น |
current_route_segment_traffic |
เอาต์พุตเท่านั้น ระบุสภาพการจราจรตาม หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น |
current_route_segment_traffic_version |
เอาต์พุตเท่านั้น ระบุเวลาล่าสุดที่มีการแก้ไข หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น |
current_route_segment_end_point |
เอาต์พุตเท่านั้น จุดอ้างอิงที่ |
remaining_distance_meters |
เอาต์พุตเท่านั้น ระยะทางที่เหลือในการขับขี่ในฟิลด์ |
eta_to_first_waypoint |
เอาต์พุตเท่านั้น เวลาถึงโดยประมาณไปยังจุดอ้างอิงถัดไป (รายการแรกในฟิลด์ |
remaining_time_to_first_waypoint |
เอาต์พุตเท่านั้น ระยะเวลาตั้งแต่ที่ระบบส่งข้อมูลการเดินทางกลับไปที่เวลาใน |
remaining_waypoints_version |
เอาต์พุตเท่านั้น ระบุครั้งล่าสุดที่มีการเปลี่ยนแปลง |
remaining_waypoints_route_version |
เอาต์พุตเท่านั้น ระบุเวลาล่าสุดที่แก้ไข |
number_of_passengers |
เปลี่ยนแปลงไม่ได้ ระบุจำนวนผู้โดยสารในการเดินทางนี้และไม่รวมคนขับ ยานพาหนะต้องมีความจุที่พร้อมใช้งานจึงจะส่งคืนการตอบกลับ |
last_location |
เอาต์พุตเท่านั้น ระบุตำแหน่งที่รายงานล่าสุดของยานพาหนะในเส้นทาง |
last_location_snappable |
เอาต์พุตเท่านั้น ระบุว่าสามารถสแนป |
view |
ข้อมูลย่อยของช่องการเดินทางที่มีการป้อนข้อมูลและวิธีการตีความ |
TripStatus
สถานะของการเดินทางที่แสดงความคืบหน้าของการเดินทาง
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
ค่าเริ่มต้น ใช้สำหรับสถานะการเดินทางที่ไม่ระบุหรือไม่รู้จัก |
NEW |
การเดินทางที่สร้างขึ้นใหม่ |
ENROUTE_TO_PICKUP |
คนขับกำลังอยู่ระหว่างทางไปยังจุดรับสินค้า |
ARRIVED_AT_PICKUP |
คนขับมาถึงจุดรับสินค้าแล้ว |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
คนขับมาถึงปลายทางระดับกลางและกำลังรอคนขับอยู่ |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
คนขับกำลังอยู่ระหว่างทางไปยังจุดหมายระดับกลาง (ไม่ใช่จุดส่ง) |
ENROUTE_TO_DROPOFF |
คนขับรับผู้โดยสารแล้วและกำลังเดินทางไปยังจุดหมายถัดไป |
COMPLETE |
ผู้โดยสารลงแล้วและการเดินทางเสร็จสมบูรณ์แล้ว |
CANCELED |
การเดินทางถูกยกเลิกก่อนที่คนขับ ผู้โดยสาร หรือผู้ให้บริการร่วมเดินทางจะมารับ |
TripType
ประเภทของการเดินทาง
Enum | |
---|---|
UNKNOWN_TRIP_TYPE |
ค่าเริ่มต้น ใช้สำหรับประเภทการเดินทางที่ไม่ได้ระบุหรือไม่รู้จัก |
SHARED |
การเดินทางนี้อาจแชร์ยานพาหนะร่วมกับการเดินทางอื่นๆ |
EXCLUSIVE |
การเดินทางนี้จำกัดเฉพาะยานพาหนะเท่านั้น |
TripView
ตัวเลือกสำหรับช่องการเดินทางชุดต่างๆ ในการตอบกลับ GetTrip
ดู AIP-157 สำหรับบริบท มีแนวโน้มว่าจะมีการเพิ่มยอดดูอื่นๆ อีก
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
ค่าเริ่มต้น API จะตั้งค่าเริ่มต้นเป็นมุมมอง SDK เพื่อความเข้ากันได้แบบย้อนหลัง ขอแนะนำให้ลูกค้าเลือก TripView ที่ไม่ใช่ SDK เพื่อความเสถียรและการรองรับ |
SDK |
รวมถึงฟิลด์ที่อาจตีความไม่ได้หรือรองรับการใช้ไลบรารีที่เผยแพร่ต่อสาธารณะ |
JOURNEY_SHARING_V1S |
ระบบจะป้อนข้อมูลในช่องการเดินทางสำหรับกรณีการใช้งานของการแชร์เส้นทางการท่องเว็บ มุมมองนี้มีไว้สำหรับการสื่อสารแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ |
TripWaypoint
อธิบายจุดหยุดในเส้นทางของยานพาหนะหรือจุดสิ้นสุดในการเดินทางของยานพาหนะ
ช่อง | |
---|---|
location |
ตำแหน่งของจุดอ้างอิงนี้ |
trip_id |
การเดินทางที่เชื่อมโยงกับจุดอ้างอิงนี้ |
waypoint_type |
บทบาทที่จุดอ้างอิงนี้มีบทบาทในการเดินทางนี้ เช่น การรับสินค้าหรือการส่งคืน |
path_to_waypoint[] |
เส้นทางจากจุดอ้างอิงก่อนหน้าไปยังจุดอ้างอิงปัจจุบัน ไม่ได้กำหนดสำหรับจุดอ้างอิงแรกในรายการ ช่องนี้จะมีการป้อนข้อมูลเมื่อได้รับคำขอเท่านั้น |
encoded_path_to_waypoint |
เส้นทางที่เข้ารหัสจากจุดอ้างอิงก่อนหน้าไปยังจุดอ้างอิงปัจจุบัน หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK และ Consumer SDK เท่านั้น ยังไม่รองรับการถอดรหัส |
traffic_to_waypoint |
สภาพการจราจรตลอดเส้นทางมายังจุดอ้างอิงนี้ โปรดทราบว่าการเข้าชมพร้อมให้บริการแก่ลูกค้าโซลูชันการโดยสารและการนำส่งของ Google Maps Platform เท่านั้น |
distance_meters |
ระยะทางของเส้นทางจากจุดอ้างอิงก่อนหน้าไปยังจุดอ้างอิงปัจจุบัน ไม่ได้กำหนดสำหรับจุดอ้างอิงแรกในรายการ |
eta |
เวลาถึงโดยประมาณที่จุดอ้างอิงนี้ ไม่ได้กำหนดสำหรับจุดอ้างอิงแรกในรายการ |
duration |
เวลาที่ใช้ในการเดินทางจากจุดอ้างอิงก่อนหน้ามายังจุดนี้ ไม่ได้กำหนดสำหรับจุดอ้างอิงแรกในรายการ |
UpdateTripRequest
ข้อความคำขอ UpdateTrip
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
name |
ต้องระบุ ต้องอยู่ในรูปแบบ |
trip |
ต้องระบุ การเดินทางที่เชื่อมโยงกับการอัปเดต ฟิลด์ต่อไปนี้ได้รับการดูแลโดย Fleet Engine โปรดอย่าอัปเดตโดยใช้ Trip.update
เมื่อคุณอัปเดต เมื่อคุณระบุ คุณควรระบุ |
update_mask |
ต้องระบุ ฟิลด์มาสก์ที่ระบุว่าต้องอัปเดตช่องใดในการเดินทาง |
UpdateVehicleAttributesRequest
ข้อความคำขอ UpdateVehicleAttributes
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
name |
ต้องระบุ ต้องอยู่ในรูปแบบ |
attributes[] |
ต้องระบุ แอตทริบิวต์ของยานพาหนะที่ต้องอัปเดต ระบบจะไม่เปลี่ยนแปลงหรือนําแอตทริบิวต์ที่ไม่ได้กล่าวถึงออก |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
ข้อความตอบกลับ
ช่อง | |
---|---|
attributes[] |
ต้องระบุ รายการแอตทริบิวต์ทั้งหมดของยานพาหนะที่อัปเดต รวมถึงแอตทริบิวต์ใหม่ แอตทริบิวต์ที่มีการเปลี่ยนแปลง และแอตทริบิวต์ที่ไม่ได้รับผลกระทบ |
UpdateVehicleRequest
"ข้อความคำขออัปเดตยานพาหนะ
ช่อง | |
---|---|
header |
ส่วนหัวของคำขอ Fleet Engine มาตรฐาน |
name |
ต้องระบุ ต้องอยู่ในรูปแบบ |
vehicle |
ต้องระบุ ค่าเอนทิตี
หากอัปเดตช่อง ในทำนองเดียวกัน คุณสามารถอัปเดตฟิลด์ |
update_mask |
ต้องระบุ มาสก์ของช่องที่ระบุว่าต้องอัปเดตช่องใดของ |
ยานพาหนะ
ข้อมูลเมตาของรถ
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อที่ไม่ซ้ำกันของยานพาหนะคันนี้ รูปแบบคือ |
vehicle_state |
สถานะของรถ |
supported_trip_types[] |
ประเภทการเดินทางที่ยานพาหนะนี้รองรับ |
current_trips[] |
เอาต์พุตเท่านั้น รายการ |
last_location |
ตำแหน่งที่รายงานล่าสุดของยานพาหนะ |
maximum_capacity |
จำนวนผู้โดยสารทั้งหมดที่ยานพาหนะนี้บรรทุกได้ ผู้ขับจะไม่พิจารณาในค่านี้ ค่านี้ต้องมากกว่าหรือเท่ากับ 1 |
attributes[] |
รายการแอตทริบิวต์ของยานพาหนะ ยานพาหนะมีแอตทริบิวต์ได้สูงสุด 100 รายการและแต่ละแอตทริบิวต์ต้องมีคีย์ที่ไม่ซ้ำกัน |
vehicle_type |
ต้องระบุ ประเภทของยานพาหนะนี้ สามารถใช้เพื่อกรองยานพาหนะในผลการค้นหา |
license_plate |
ข้อมูลป้ายทะเบียนรถ |
route[] |
เลิกใช้งานแล้ว: ใช้ |
current_route_segment |
เส้นประกอบที่ระบุเส้นทางที่แอปคนขับต้องการใช้ไปยังจุดอ้างอิงถัดไป รายการนี้จะแสดงใน หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK เท่านั้น ยังไม่รองรับการถอดรหัส |
current_route_segment_traffic |
อินพุตเท่านั้น Fleet Engine ใช้ข้อมูลนี้เพื่อปรับปรุงการแชร์เส้นทาง หมายเหตุ: ช่องนี้มีไว้สำหรับใช้โดย Driver SDK เท่านั้น |
current_route_segment_version |
เอาต์พุตเท่านั้น เวลาที่ตั้งไว้ |
current_route_segment_end_point |
จุดอ้างอิงที่ |
remaining_distance_meters |
ระยะทางที่เหลือในการขับขี่สำหรับ |
eta_to_first_waypoint |
เวลาถึงโดยประมาณที่รายการแรกในช่อง เมื่ออัปเดตรถ |
remaining_time_seconds |
อินพุตเท่านั้น เวลาขับรถที่เหลือสำหรับ เมื่ออัปเดตรถ |
waypoints[] |
จุดอ้างอิงที่เหลือที่กำหนดให้กับรถคันนี้ |
waypoints_version |
เอาต์พุตเท่านั้น ครั้งล่าสุดที่มีการอัปเดตช่อง |
back_to_back_enabled |
ระบุว่าคนขับยอมรับการเดินทางแบบไปกลับหรือไม่ หากอยู่ใน |
navigation_status |
สถานะการนำทางของรถ |
device_settings |
อินพุตเท่านั้น ข้อมูลเกี่ยวกับการตั้งค่าในอุปกรณ์เคลื่อนที่ที่คนขับใช้งาน |
VehicleType
ประเภทของยานพาหนะ
ช่อง | |
---|---|
category |
หมวดหมู่ประเภทยานพาหนะ |
หมวดหมู่
หมวดหมู่ประเภทยานพาหนะ
Enum | |
---|---|
UNKNOWN |
ค่าเริ่มต้น ใช้สำหรับหมวดหมู่ยานพาหนะที่ไม่ได้ระบุหรือไม่รู้จัก |
AUTO |
รถยนต์ |
TAXI |
ยานพาหนะที่ทำหน้าที่เป็นแท็กซี่ (โดยทั่วไปมีใบอนุญาตหรือได้รับการควบคุม) |
TRUCK |
โดยทั่วไปแล้ว ยานพาหนะที่มีความจุพื้นที่เก็บข้อมูลขนาดใหญ่ |
TWO_WHEELER |
จักรยานยนต์ โมเพ็ด หรือยานพาหนะ 2 ล้ออื่นๆ |
BICYCLE |
การคมนาคมที่ขับเคลื่อนด้วยพลังของมนุษย์ |
PEDESTRIAN |
รถบรรทุกที่เป็นมนุษย์ ปกติแล้วเดินหรือวิ่ง และเดินทางไปตามทางเท้า |
VehicleAttribute
อธิบายแอตทริบิวต์ของยานพาหนะเป็นคู่คีย์-ค่า สตริง "key:value" ต้องไม่เกิน 256 อักขระ
ช่อง | |
---|---|
key |
คีย์ของแอตทริบิวต์ คีย์ต้องไม่มีอักขระโคลอน (:) |
value |
ค่าแอตทริบิวต์ |
ฟิลด์สหภาพ vehicle_attribute_value ค่าแอตทริบิวต์อาจเป็นสตริง bool หรือประเภท Double ก็ได้ vehicle_attribute_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
string_value |
ค่าแอตทริบิวต์ที่พิมพ์สตริง หมายเหตุ: ช่องนี้เหมือนกันกับช่อง |
bool_value |
ค่าแอตทริบิวต์ประเภทบูลีน |
number_value |
ค่าแอตทริบิวต์แบบพิมพ์คู่ |
VehicleAttributeList
ประเภทข้อมูลของรายการสําหรับแอตทริบิวต์ยานพาหนะ
ช่อง | |
---|---|
attributes[] |
รายการแอตทริบิวต์ในคอลเล็กชันนี้ |
VehicleLocation
ตำแหน่ง ความเร็ว และทิศทางของยานพาหนะ ณ ช่วงเวลาหนึ่งๆ
ช่อง | |
---|---|
location |
ตำแหน่งของยานพาหนะ เมื่อส่งไปยัง Fleet Engine ตำแหน่งของรถจะเป็นตำแหน่ง GPS เมื่อคุณได้รับการตอบกลับ ตำแหน่งของรถอาจเป็นตำแหน่ง GPS, ตำแหน่งเสริม หรือตำแหน่งโดยประมาณอื่นๆ ก็ได้ มีการระบุแหล่งที่มาใน |
horizontal_accuracy |
เลิกใช้งานแล้ว: ใช้ |
latlng_accuracy |
ความแม่นยำของ |
heading |
ทิศทางที่รถเคลื่อนที่ในหน่วยองศา 0 หมายถึงทิศเหนือ ช่วงที่ใช้ได้คือ [0,360) |
bearing_accuracy |
เลิกใช้งานแล้ว: ใช้ |
heading_accuracy |
ความแม่นยำของ |
altitude |
ระดับความสูงในหน่วยเมตรเหนือ WGS84 |
vertical_accuracy |
เลิกใช้งานแล้ว: ใช้ |
altitude_accuracy |
ความแม่นยำของ |
speed_kmph |
ความเร็วของยานพาหนะ หน่วยเป็นกิโลเมตรต่อชั่วโมง เลิกใช้งานแล้ว: ใช้ |
speed |
ความเร็วของยานพาหนะ หน่วยเป็นเมตร/วินาที |
speed_accuracy |
ความแม่นยำของ |
update_time |
เวลาที่เซ็นเซอร์รายงาน |
server_time |
เอาต์พุตเท่านั้น เวลาที่เซิร์ฟเวอร์ได้รับข้อมูลตำแหน่ง |
location_sensor |
ผู้ให้บริการข้อมูลตำแหน่ง (เช่น |
is_road_snapped |
ยึด |
is_gps_sensor_enabled |
อินพุตเท่านั้น ระบุว่าเปิดใช้งานเซ็นเซอร์ GPS ในอุปกรณ์เคลื่อนที่หรือไม่ |
time_since_update |
อินพุตเท่านั้น เวลา (เป็นวินาที) นับจากที่ส่งตำแหน่งนี้ไปยังเซิร์ฟเวอร์เป็นครั้งแรก ซึ่งจะเป็น 0 สำหรับการอัปเดตครั้งแรก หากไม่ทราบเวลา (เช่น เมื่อแอปรีสตาร์ท) ค่านี้จะรีเซ็ตเป็น 0 |
num_stale_updates |
อินพุตเท่านั้น เลิกใช้งาน: ใช้สัญญาณอื่นๆ เพื่อระบุว่าสถานที่หนึ่งๆ ไม่มีอัปเดตหรือไม่ |
raw_location |
ตำแหน่งยานพาหนะดิบ (ไม่ได้ประมวลผลโดยคนเดินถนน) |
raw_location_time |
การประทับเวลาที่เชื่อมโยงกับตำแหน่งดิบ |
raw_location_sensor |
แหล่งที่มาของตำแหน่งดิบ ค่าเริ่มต้นคือ |
raw_location_accuracy |
ความแม่นยำของ |
supplemental_location |
ตำแหน่งเสริมที่ได้รับจากแอปที่ผสานรวม |
supplemental_location_time |
การประทับเวลาที่เชื่อมโยงกับตำแหน่งเสริม |
supplemental_location_sensor |
แหล่งที่มาของตำแหน่งเสริม ค่าเริ่มต้นคือ |
supplemental_location_accuracy |
ความแม่นยำของ |
road_snapped |
เลิกใช้งานแล้ว: ใช้ |
VehicleMatch
มียานพาหนะและค่าประมาณที่เกี่ยวข้องของยานพาหนะที่ตรงกับจุดการเดินทางที่ใช้งานอยู่ของยานพาหนะ SearchVehiclesRequest
ช่อง | |
---|---|
vehicle |
ต้องระบุ ยานพาหนะที่ตรงกับคำขอ |
vehicle_pickup_eta |
เวลาถึงโดยประมาณของรถที่จะขับไปยังจุดรับที่ระบุไว้ในคำขอ ค่าว่างหมายความว่าคำนวณเวลาถึงโดยประมาณของยานพาหนะไม่สำเร็จ หาก |
vehicle_pickup_distance_meters |
ระยะทางจากตำแหน่งปัจจุบันของยานพาหนะไปยังจุดรับสินค้าที่ระบุไว้ในคำขอ รวมถึงจุดรับของหรือจุดส่งของการเดินทางที่มีอยู่ ระยะทางนี้ประกอบไปด้วยระยะทางขับรถ (เส้นทาง) ที่คำนวณไว้ บวกกับระยะทางในแนวตรงระหว่างจุดสิ้นสุดของการนำทางและจุดรับคำขอที่ขอ (โดยทั่วไปจะมีระยะทางระหว่างจุดสิ้นสุดการนำทางและจุดรับสินค้าที่ขอมักจะน้อย) ค่าว่างหมายถึงเกิดข้อผิดพลาดในการคำนวณระยะทาง |
vehicle_pickup_straight_line_distance_meters |
ต้องระบุ ระยะทางในแนวตรงระหว่างยานพาหนะและจุดรับสินค้าที่ระบุไว้ในคำขอ |
vehicle_dropoff_eta |
เวลาถึงโดยประมาณในการขับขี่ยานพาหนะที่สมบูรณ์ไปยังจุดส่งที่ระบุไว้ในคำขอ เวลาถึงโดยประมาณรวมถึงการหยุดที่จุดอ้างอิงก่อนถึง |
vehicle_pickup_to_dropoff_distance_meters |
ระยะทางที่รถวิ่งได้ (หน่วยเป็นเมตร) จากจุดรับสินค้าถึงจุดส่งที่ระบุไว้ในคำขอ ระยะทางจะอยู่ระหว่าง 2 จุดเท่านั้น โดยไม่รวมตำแหน่งของยานพาหนะหรือจุดอื่นๆ ที่ต้องเข้าชมก่อนที่ยานพาหนะจะไปยังจุดรับสินค้าหรือจุดส่ง ระบบจะเติมค่าเมื่อมีการระบุ |
trip_type |
ต้องระบุ ประเภทการเดินทางของคำขอที่ใช้ในการคำนวณเวลาถึงโดยประมาณไปยังจุดรับสินค้า |
vehicle_trips_waypoints[] |
รายการเรียงลำดับของจุดอ้างอิงที่ใช้ในการคำนวณ ETA รายการดังกล่าวรวมถึงตำแหน่งของยานพาหนะ จุดรับของการเดินทางที่ใช้งานอยู่สำหรับยานพาหนะ และจุดรับสินค้าที่ระบุไว้ในคำขอ รายการที่ว่างเปล่าแสดงว่าการคำนวณเวลาถึงโดยประมาณของรถล้มเหลว |
vehicle_match_type |
ประเภทยานพาหนะที่ตรงกัน |
requested_ordered_by |
คำสั่งที่ขอในการจัดเรียงยานพาหนะที่ตรงกัน |
ordered_by |
คำสั่งซื้อจริงที่ใช้สำหรับยานพาหนะนี้ โดยปกติแล้ว ค่านี้จะจับคู่ช่อง "order_by" จากคำขอ แต่ในบางกรณี เช่น ข้อผิดพลาดภายในเซิร์ฟเวอร์ อาจใช้วิธีการอื่น (เช่น |
VehicleMatchType
ประเภทยานพาหนะที่ตรงกัน
Enum | |
---|---|
UNKNOWN |
ประเภทการจับคู่ยานพาหนะที่ไม่รู้จัก |
EXCLUSIVE |
ขณะนี้รถยังไม่มีการกำหนดการเดินทาง และสามารถไปยังจุดรับสินค้าได้ |
BACK_TO_BACK |
ขณะนี้มีการกำหนดยานพาหนะสำหรับการเดินทางแล้ว แต่สามารถไปยังจุดรับสินค้าได้หลังจากการเดินทางที่อยู่ระหว่างดำเนินการเสร็จสมบูรณ์แล้ว การคำนวณเวลาถึงโดยประมาณและระยะทางจะคำนึงถึงการเดินทางปัจจุบัน |
CARPOOL |
ยานพาหนะมีความจุเพียงพอสำหรับการเดินทางร่วมกัน |
CARPOOL_BACK_TO_BACK |
พาหนะจะสิ้นสุดการเดินทางปัจจุบันที่ใช้งานอยู่ก่อนที่จะไปยังจุดรับสินค้า การคำนวณเวลาถึงโดยประมาณและระยะทางจะคำนึงถึงการเดินทางปัจจุบัน |
VehicleState
สถานะของ Vehicle
Enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
ค่าเริ่มต้น ใช้สำหรับสถานะของยานพาหนะที่ไม่ได้ระบุหรือไม่รู้จัก |
OFFLINE |
ยานพาหนะนี้ไม่รับการเดินทางใหม่ หมายเหตุ: รถอาจจะยังทำงานต่อไปในสถานะนี้ขณะกำลังเดินทางตามที่กำหนดไว้ |
ONLINE |
ยานพาหนะรับการเดินทางใหม่ |
VisualTrafficReportPolylineRendering
อธิบายวิธีที่ไคลเอ็นต์ควรระบายสีส่วนหนึ่งของเส้นประกอบตามเส้นทาง
ช่อง | |
---|---|
road_stretch[] |
ไม่บังคับ ถนนทอดยาวที่ควรแสดงผลตามเส้นประกอบ การขยายแผลจะไม่ทับซ้อนกัน และไม่จำเป็นต้องครอบคลุมทั้งเส้นทาง หากไม่มีถนนยืดตามรูปแบบ ลูกค้าควรใช้ค่าเริ่มต้นกับเส้นทาง |
RoadStretch
ถนนหนึ่งเส้นที่ควรแสดง
ช่อง | |
---|---|
style |
ต้องระบุ รูปแบบที่จะใช้ |
offset_meters |
ต้องระบุ ควรใช้รูปแบบระหว่าง |
length_meters |
ต้องระบุ ความยาวของเส้นทางที่จะใช้รูปแบบ |
สไตล์
รูปแบบการจราจร ระบุความเร็วของการจราจร
Enum | |
---|---|
STYLE_UNSPECIFIED |
ไม่ได้เลือกรูปแบบ |
SLOWER_TRAFFIC |
การจราจรหนาแน่นช้าลง |
TRAFFIC_JAM |
มีการจราจรติดขัด |
จุดบอกทาง
อธิบายจุดกึ่งกลางตลอดเส้นทางสำหรับ VehicleMatch
ใน SearchVehiclesResponse
แนวคิดนี้จะแสดงเป็น TripWaypoint
ในปลายทางอื่นๆ ทั้งหมด
ช่อง | |
---|---|
lat_lng |
ตำแหน่งของจุดอ้างอิงนี้ |
eta |
เวลาโดยประมาณที่ยานพาหนะจะมาถึงจุดอ้างอิงนี้ |
WaypointType
ประเภทของจุดอ้างอิง
Enum | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
ประเภทจุดอ้างอิงที่ไม่รู้จักหรือไม่ได้ระบุ |
PICKUP_WAYPOINT_TYPE |
จุดจอดสำหรับรับส่งผู้โดยสารหรือสิ่งของ |
DROP_OFF_WAYPOINT_TYPE |
จุดสำหรับส่งผู้โดยสารหรือสิ่งของ |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
จุดอ้างอิงสำหรับจุดหมายระดับกลางในการเดินทางหลายจุดหมาย |