מדריך מקוצר לשירות Fleet Engine

‫Fleet Engine הוא שירות לקצה העורפי שיוצר מודל של צי הרכבים שלכם בעולם האמיתי, ומספק עדכונים לגבי מסלולים, זמן הגעה משוער, תנועה וסטטוס של נסיעות על פי דרישה ומשימות מתוזמנות. הוא משתמש בנתוני מיקום ומסלול מ-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 Service:

  • אתם צריכים קצה עורפי שמדמה כלי רכב ונסיעות על פי דרישה (איסוף, נקודות ציון, הורדה), כולל נסיעות עם כמה יעדים, נסיעות ברצף או נסיעות משותפות.
  • אתם צריכים ליצור מודל של משימות מסירה או שירות מתוזמנות שמוקצות לכלי רכב, ולעקוב אחרי העצירות, התוצאות וזמני ההגעה המשוערים שלהם.
  • כדי להתאים רכבים לנסיעות שהוזמנו, צריך לחפש או להציג רכבים באזור מסוים.
  • אתם צריכים מעקב אחר נסיעות או משלוחים של צרכנים ומעקב אחר מפעילי צי רכב, שמוזנים על ידי עדכונים לגבי מיקום של Driver SDK.

אין להשתמש בשירות Fleet Engine כאשר:

  • אתם צריכים להציג סמני GPS או נתיבי נכסים בזמן אמת במפה באינטרנט ממסד הנתונים או מהסטרימינג שלכם, בלי תזמור של נסיעות או משימות ב-Fleet Engine. במקום זאת, צריך להשתמש ב-Maps JavaScript API.
  • אתם צריכים להציג סמנים או מסלולים בזמן אמת מהנתונים שלכם באפליקציה ל-Android, בלי תזמור של נסיעות או משימות ב-Fleet Engine. במקום זאת, צריך להשתמש ב-SDK של מפות ל-Android.
  • אתם צריכים להציג סמנים או מסלולים בזמן אמת מהנתונים שלכם באפליקציה ל-iOS, בלי תזמור של נסיעות או משימות ב-Fleet Engine. במקום זאת, צריך להשתמש ב-SDK של מפות ל-iOS.
  • אתם צריכים לחשב תוכניות מסלול אופטימליות לכל הצי. Fleet Engine מקבל תוכניות מסלול רק ממערכת פתרונות שאתם מספקים. במקומו, צריך להשתמש ב-Route Optimization API.

שירות Fleet Engine: הגדרה

  • השירות שצריך להפעיל: fleetengine.googleapis.com
  • אימות: חשבון שירות, אסימון אינטרנט מסוג JSON‏ (JWT), ‏ OAuth 2.0
  • שיוך השימוש: תכונה אופציונלית בגרסת בטא: מגדירים את כותרת ה-HTTP‏ X-Goog-Maps-Experience-ID למזהה העסקה של Mobility (או למזהה קשור, כמו מזהה סשן) בקריאות לשירותים של חבילת Mobility. מפרידים בין כמה מזהים באמצעות פסיקים. כשמדווחים על העסקה, צריך להעביר את כל המזהים הקשורים ב-related_ids.
  • תחילת העבודה: הגדרת שירות Fleet Engine
  • מקור מידע: מקור מידע על שירות Fleet Engine
  • כללי מדיניות: כללי המדיניות של Fleet Engine Service
  • נתוני גרסה: נתוני הגרסה של שירות 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
  • go:‏ cloud.google.com/go/maps

‫Fleet Engine Service: טעויות נפוצות

  • הבעיה: בקשות ל-Fleet Engine עלולות להיכשל מדי פעם, ואחרי כישלון, יכול להיות שישויות כמו כלי רכב לא יהיו קיימות יותר (NOT_FOUND בעדכון). פתרון: מטמיעים ניסיונות חוזרים עם השהיה (ספריות הלקוח מנסות שוב כברירת מחדל), ויוצרים מחדש כלי רכב או משימות חסרים במצב הנוכחי שלהם. אפשר לעיין במאמר /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 חסרות ההצהרות הנכונות או שלחשבון השירות החותם אין את תפקיד ה-IAM הנדרש ב-Fleet Engine (לדוגמה, "JWT does not contain a matching scope for requested trip"). תיקון: בודקים את התפקידים של חשבון השירות ומוודאים שהטענות של ה-JWT כוללות היקפים של הרכב, הנסיעה או המשימה שאליהם ניגשים. אפשר לעיין במאמר /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • הבעיה: כשעוברים מ-On-Demand Rides and Deliveries לכל חבילת Mobility, או מ-Last Mile Fleet Solution ל-Mobility Activate או ל-Mobility Optimize, בקשות ל-Mobility Billing API מחזירות את קוד הסטטוס HTTP 202 עד שההעברה מסתיימת, ולא מחויבות. הפתרון: שולחים קריאות גם ל-Fleet Engine ReportBillableTrip וגם ל-Mobility Billing API מכמה ימים לפני המעבר ועד כמה ימים אחריו, משווים את מספר הבקשות ב-Cloud Logging ואז מסירים את הקריאות ל-ReportBillableTrip. מידע נוסף זמין בכתובת /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

שירות Fleet Engine: תכונות מדור קודם ותכונות שהוצאו משימוש

  • השיטה UpdateVehicleLocation: יצאה משימוש ב-1 במאי 2024. החלפה: UpdateVehicle ב-VehicleService. Symptom: הוצא משימוש ב-1 בפברואר 2024, והושבת במאי 2024.
  • השיטה SearchFuzzedVehicles: הוצאה משימוש ב-1 במאי 2024. החלפה: SearchVehicles ב-VehicleService. Symptom: הוצא משימוש ב-1 בפברואר 2024, והושבת במאי 2024.
  • השיטה SearchTasks: יצאה משימוש ב-1 במאי 2024. החלפה: GetTaskTrackingInfo ב-DeliveryService. Symptom: הוצא משימוש ב-1 בפברואר 2024, והושבת במאי 2024.
  • ReportBillableTrip אחרי המעבר לחבילת Mobility (מ-On-Demand Rides and Deliveries לכל חבילה, או מ-Last Mile Fleet Solution ל-Activate או ל-Optimize): Legacy. ‫החלפה: Mobility Billing API reportBillableEvent. התופעה: בעיה ספציפית לחוזה, לא הוצאה משימוש של API. אחרי ההעברה, יכול להיות שיוחזר הערך "Invalid Contract: This project [...] is not authorized to use FleetEngine" (חוזה לא חוקי: לפרויקט הזה [...] אין הרשאה להשתמש ב-FleetEngine). למדריך להעברת נתונים (מיגרציה)

מה אפשר לעשות עם Fleet Engine Service

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.