Fleet Engine เป็นบริการแบ็กเอนด์ที่จำลองกลุ่มยานพาหนะในชีวิตจริง และให้ข้อมูลอัปเดตเกี่ยวกับเส้นทาง, ETA, การจราจร และสถานะสำหรับการเดินทางแบบออนดีมานด์และงานที่กำหนดเวลาไว้ โดยจะใช้ข้อมูลตำแหน่งและเส้นทางจาก Driver SDK และทำงานร่วมกับ Consumer SDK และ API อื่นๆ ของ Google Maps Platform
บริการ Fleet Engine: ข้อเท็จจริงสำคัญ
- ผลิตภัณฑ์: บริการ Fleet Engine
- หรือที่เรียกว่า Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
- หมวดหมู่: เส้นทาง
- แพลตฟอร์ม: บริการผ่านเว็บ (REST)
- ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
- ระยะการเปิดตัว: GA
- วงจร: ใช้งานอยู่
- ภาพรวม: ภาพรวมบริการ Fleet Engine
บริการ Fleet Engine: กรณีที่ควรใช้
ใช้บริการ Fleet Engine ในกรณีต่อไปนี้
- คุณต้องมีแบ็กเอนด์ที่จำลองยานพาหนะและการเดินทางแบบออนดีมานด์ (จุดรับ จุดอ้างอิง จุดส่ง) รวมถึงการเดินทางแบบหลายจุดหมาย การเดินทางแบบต่อเนื่อง หรือการเดินทางร่วมกัน
- คุณต้องจำลองงานการนำส่งหรือบริการตามกำหนดเวลาที่มอบหมายให้กับยานพาหนะ และติดตามจุดแวะพัก ผลลัพธ์ และ ETA
- คุณต้องค้นหาหรือแสดงยานพาหนะในภูมิภาคเพื่อจับคู่กับเที่ยวโดยสารที่ขอ
- คุณต้องมีการติดตามการเดินทางหรือการจัดส่งของผู้บริโภค และการติดตามผู้ให้บริการยานพาหนะที่อัปเดตตำแหน่งโดย Driver SDK
อย่าใช้บริการ Fleet Engine ในกรณีต่อไปนี้
- คุณต้องแสดงเครื่องหมาย GPS แบบเรียลไทม์หรือเส้นทางของชิ้นงานบนแผนที่เว็บจากฐานข้อมูลหรือสตรีมของคุณเอง โดยไม่ต้องมีการจัดระเบียบการเดินทางหรือการจัดระเบียบงานของ Fleet Engine โปรดใช้ Maps JavaScript API แทน
- คุณต้องแสดงเครื่องหมายหรือเส้นทางแบบเรียลไทม์จากข้อมูลของคุณเองในแอป Android โดยไม่ต้องใช้การจัดการการเดินทางหรือการจัดการงานของ Fleet Engine โปรดใช้ Maps SDK สำหรับ Android แทน
- คุณต้องแสดงเครื่องหมายหรือเส้นทางแบบเรียลไทม์จากข้อมูลของคุณเองในแอป iOS โดยไม่ต้องใช้การจัดเรียงการเดินทางหรือการจัดเรียงงานของ Fleet Engine โปรดใช้ Maps SDK สำหรับ iOS แทน
- คุณต้องคำนวณแผนเส้นทางที่เพิ่มประสิทธิภาพสำหรับทั้งกลุ่มยานพาหนะ Fleet Engine จะใช้แผนเส้นทางจากโปรแกรมแก้ปัญหาที่คุณระบุเท่านั้น โปรดใช้ Route Optimization API แทน
บริการ Fleet Engine: การตั้งค่า
- บริการที่ต้องเปิดใช้:
fleetengine.googleapis.com - การตรวจสอบสิทธิ์: บัญชีบริการ, JSON Web Token (JWT), OAuth 2.0
- การระบุแหล่งที่มาของการใช้งาน: ฟีเจอร์เบต้าที่ไม่บังคับ: ตั้งค่าส่วนหัว HTTP
X-Goog-Maps-Experience-IDเป็นรหัสธุรกรรม Mobility (หรือรหัสที่เกี่ยวข้อง เช่น รหัสเซสชัน) ในการเรียกใช้บริการแพ็กเกจ Mobility โดยคั่นรหัสหลายรายการด้วยคอมมา ส่งรหัสที่เกี่ยวข้องในrelated_idsเมื่อรายงานธุรกรรม - เริ่มต้นใช้งาน: ตั้งค่าบริการ Fleet Engine
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิงเกี่ยวกับบริการ Fleet Engine
- นโยบาย: นโยบายบริการ Fleet Engine
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของบริการ Fleet Engine
แพ็กเกจบริการ Fleet Engine อย่างเป็นทางการ
- maven:
com.google.maps:google-maps-fleetengine - maven:
com.google.maps:google-maps-fleetengine-delivery - npm:
@googlemaps/fleetengine - npm:
@googlemaps/fleetengine-delivery - pypi:
google-maps-fleetengine - pypi:
google-maps-fleetengine-delivery - ไปที่:
cloud.google.com/go/maps
บริการ Fleet Engine: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Driver SDK สำหรับ Android, Driver SDK สำหรับ iOS, Consumer SDK สำหรับ Android, Consumer SDK สำหรับ iOS, JavaScript Consumer SDK, Route Optimization API
บริการ Fleet Engine: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: คำขอไปยัง Fleet Engine อาจดำเนินการไม่สำเร็จเป็นครั้งคราว และหลังจากดำเนินการไม่สำเร็จ เอนทิตีต่างๆ เช่น ยานพาหนะ อาจไม่มีอยู่อีกต่อไป (
NOT_FOUNDในการอัปเดต) วิธีแก้ไข: ลองอีกครั้งโดยใช้ Backoff (ไลบรารีของไคลเอ็นต์จะลองอีกครั้งโดยค่าเริ่มต้น) และสร้างยานพาหนะหรืองานที่ขาดหายไปขึ้นมาใหม่ในสถานะปัจจุบัน ดู /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot - ปัญหา: ข้อผิดพลาด
DEADLINE_EXCEEDEDจะเกิดขึ้นเมื่อคำขอใช้เวลานานกว่าระยะหมดเวลาเริ่มต้นของไลบรารีของไคลเอ็นต์ วิธีแก้ไข: ปรับการตั้งค่าการลองใหม่ของ RPC (เช่นsetTotalTimeoutในVehicleServiceSettingsในไคลเอ็นต์ Java) ดู /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot - ปัญหา:
PERMISSION_DENIED(HTTP 403) เมื่อ JWT ไม่มี Claim ที่ถูกต้อง หรือบัญชีบริการที่ลงชื่อไม่มีบทบาท Fleet Engine IAM ที่จำเป็น (เช่น "JWT ไม่มีขอบเขตที่ตรงกันสำหรับการเดินทางที่ขอ") วิธีแก้ไข: ตรวจสอบบทบาทของบัญชีบริการและตรวจสอบว่าการอ้างสิทธิ์ JWT มีขอบเขตสำหรับยานพาหนะ การเดินทาง หรืองานที่เข้าถึง ดู /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot - ปัญหา: เมื่อย้ายข้อมูลจาก On-Demand Rides and Deliveries ไปยังแพ็กเกจ Mobility ใดก็ตาม หรือจาก Last Mile Fleet Solution ไปยัง Mobility Activate หรือ Optimize คำขอ Mobility Billing API จะแสดงผล HTTP 202 จนกว่าการย้ายข้อมูลจะเสร็จสมบูรณ์ และจะไม่ส่งผลต่อการเรียกเก็บเงิน การแก้ไข: เรียกใช้ทั้ง Fleet Engine
ReportBillableTripและ Mobility Billing API ตั้งแต่ 2-3 วันก่อนจนถึง 2-3 วันหลังการย้ายข้อมูล เปรียบเทียบจำนวนคำขอใน Cloud Logging แล้วนำการเรียกใช้ReportBillableTripออก ดู /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration
บริการ Fleet Engine: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
- เมธอด
UpdateVehicleLocation: เลิกใช้งานตั้งแต่วันที่ 1 พฤษภาคม 2024 การเปลี่ยนทดแทน:UpdateVehicleในVehicleServiceอาการ: เลิกใช้งานเมื่อวันที่ 1 กุมภาพันธ์ 2024 และปิดให้บริการในเดือนพฤษภาคม 2024 - เมธอด
SearchFuzzedVehicles: เลิกใช้งานตั้งแต่วันที่ 1 พฤษภาคม 2024 การเปลี่ยนทดแทน:SearchVehiclesในVehicleServiceอาการ: เลิกใช้งานเมื่อวันที่ 1 กุมภาพันธ์ 2024 และปิดให้บริการในเดือนพฤษภาคม 2024 - เมธอด
SearchTasks: เลิกใช้งานตั้งแต่วันที่ 1 พฤษภาคม 2024 การเปลี่ยนทดแทน:GetTaskTrackingInfoในDeliveryServiceอาการ: เลิกใช้งานเมื่อวันที่ 1 กุมภาพันธ์ 2024 และปิดให้บริการในเดือนพฤษภาคม 2024 ReportBillableTripหลังจากย้ายข้อมูลไปยังแพ็กเกจ Mobility (การเดินทางและการจัดส่งแบบออนดีมานด์ไปยังแพ็กเกจใดก็ได้ หรือ Last Mile Fleet Solution ไปยัง Activate หรือ Optimize): เดิม รายการทดแทน: Mobility Billing APIreportBillableEventอาการ: เฉพาะสัญญา ไม่ใช่การเลิกใช้งาน API หลังจากการย้ายข้อมูล การเรียกอาจแสดงผลเป็น "สัญญาไม่ถูกต้อง: โปรเจ็กต์นี้ [...] ไม่ได้รับอนุญาตให้ใช้ FleetEngine" ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วยบริการ Fleet Engine
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- รายงานการใช้งานการเดินทางของ Fleet Engine ที่เรียกเก็บเงินได้
- สร้างและแสดงผลการเดินทางใหม่ของ Fleet Engine
- แสดงข้อมูลเกี่ยวกับการเดินทางของ Fleet Engine
- แสดงรายการการเดินทางทั้งหมดของ Fleet Engine สำหรับยานพาหนะที่ระบุ
- อัปเดตข้อมูลการเดินทางสำหรับการเดินทางของ Fleet Engine
- สร้างอินสแตนซ์ยานพาหนะใหม่ใน Fleet Engine ที่เชื่อมโยงกับผู้ให้บริการร่วมเดินทางหรือผู้ให้บริการจัดส่งแบบออนดีมานด์
- แสดงผลยานพาหนะจากบริการ Fleet Engine
- แสดงผลรายการยานพาหนะที่มีการแบ่งหน้าใน Fleet Engine ซึ่งเชื่อมโยงกับผู้ให้บริการที่ตรงกับเกณฑ์ที่ระบุ
- แสดงรายการยานพาหนะใน Fleet Engine ที่ตรงกับเกณฑ์ที่ระบุ
- อัปเดตข้อมูลยานพาหนะสำหรับยานพาหนะใน Fleet Engine
- อัปเดตแอตทริบิวต์ของยานพาหนะสำหรับยานพาหนะใน Fleet Engine
- แสดงข้อมูลการเดินทางของยานพาหนะจากบริการ Fleet Engine