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: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Driver SDK ל-Android, Driver SDK ל-iOS, Consumer SDK ל-Android, Consumer SDK ל-iOS, JavaScript Consumer SDK, Route Optimization API
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 APIreportBillableEvent. התופעה: בעיה ספציפית לחוזה, לא הוצאה משימוש של API. אחרי ההעברה, יכול להיות שיוחזר הערך "Invalid Contract: This project [...] is not authorized to use FleetEngine" (חוזה לא חוקי: לפרויקט הזה [...] אין הרשאה להשתמש ב-FleetEngine). למדריך להעברת נתונים (מיגרציה)
מה אפשר לעשות עם Fleet Engine Service
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- דיווח על שימוש בנסיעות ב-Fleet Engine שניתן לחייב עליהן.
- יצירה והחזרה של נסיעה חדשה ב-Fleet Engine.
- החזרת מידע על נסיעה ב-Fleet Engine.
- החזרת רשימה של כל הנסיעות ב-Fleet Engine של רכב מסוים.
- עדכון נתוני נסיעה ב-Fleet Engine.
- הפעלת רכב חדש ב-Fleet Engine שמשויך לספק של נסיעות שיתופיות או משלוחים על פי דרישה.
- החזרת רכב משירות Fleet Engine.
- החזרת רשימה של כלי רכב ב-Fleet Engine שמשויכים לספק ועומדים בקריטריונים שצוינו.
- החזרת רשימה של כלי רכב ב-Fleet Engine שתואמים לקריטריונים שצוינו.
- עדכון נתוני רכב ב-Fleet Engine.
- עדכון מאפייני הרכב ב-Fleet Engine.
- החזרת פרטי הנסיעה של רכב משירות Fleet Engine.