ข้อมูลอ้างอิงโดยย่อเกี่ยวกับบริการ Fleet Engine

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: การตั้งค่า

แพ็กเกจบริการ 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: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: คำขอไปยัง 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 API reportBillableEvent อาการ: เฉพาะสัญญา ไม่ใช่การเลิกใช้งาน API หลังจากการย้ายข้อมูล การเรียกอาจแสดงผลเป็น "สัญญาไม่ถูกต้อง: โปรเจ็กต์นี้ [...] ไม่ได้รับอนุญาตให้ใช้ FleetEngine" ดูคำแนะนำในการย้ายข้อมูล

สิ่งที่คุณทำได้ด้วยบริการ Fleet Engine

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