Fleet Tracking - Last Mile Fleet

המחלקה FleetEngineDeliveryVehicleLocationProvider

מחלקה google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider

ספק מיקום הרכב

השיעור הזה נמשך PollingLocationProvider.

אפשר לקבל גישה על ידי התקשרות ל-const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
פרמטרים: 
יצירת ספק מיקום חדש לרכב Fleet Engine.
deliveryVehicleId
סוג:  string
המזהה של הרכב שספק המיקום הזה צופה בו. הגדרת השדה הזה למעקב אחר רכב.
shouldShowOutcomeLocations
סוג:  boolean optional
לחלופין, המשתמשים יכולים להציג את מיקום התוצאה של המשימה.
shouldShowTasks
סוג:  boolean optional
לחלופין, המשתמשים יכולים להציג משימות שאוחזרו.
staleLocationThresholdMillis
סוג:  number
השדה הזה הוא לקריאה בלבד. הסף לאיתור מיקום לא פעיל של רכב. אם המיקום האחרון של הרכב ישן מהסף הזה, הרכב לא יוצג.
taskFilterOptions
הפונקציה מחזירה את אפשרויות הסינון שיחולו במהלך אחזור משימות.
עברו בירושה: isPolling, pollingIntervalMillis
עברו בירושה: addListener
error
function(event)
ארגומנטים: 
אירוע שמופעל כשספק המיקום נתקל בשגיאה.
update
function(event)
אירוע שמופעל כשבקשת עדכון הנתונים של Fleet Engine הסתיימה.
עברו בירושה: ispollingchange

ממשק FleetEngineDeliveryVehicleLocationProviderOption

ממשק google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

אפשרויות לספק מיקום הרכב.

authTokenFetcher
מספקת אסימוני אינטרנט עבור JSON לצורך אימות הלקוח ל-Fleet Engine.
projectId
סוג:  string
מזהה הפרויקט של הצרכן ממסוף Google Cloud.
deliveryVehicleId optional
סוג:  string optional
מזהה הרכב למסירה למעקב מיידי ברגע שספק המיקום מצוין. אם לא מציינים את המיקום, ספק המיקום לא מתחיל לעקוב אחר כלי רכב. יש להשתמש ב-FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId כדי להגדיר את המזהה ולהתחיל במעקב.
deliveryVehicleMarkerCustomization optional
בוצעה התאמה אישית של הסמן על רכב המסירה.

אפשר להשתמש בשדה הזה כדי לציין סגנון מותאם אישית (כמו סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם אובייקט MarkerOptions מצוין, השינויים שצוינו בו חלים על הסמן לאחר יצירת הסמן, והם מחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם צוינה פונקציה, היא תופעל פעם אחת לאחר יצירת הסמן, לפני הוספתו לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט של הפרמטרים לפונקציה מוגדר ל-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין שהנתונים התואמים לסמן הזה השתנו.

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,DeliveryVehicleMarkerCustomizationFunctionParams.
plannedStopMarkerCustomization optional
סוג:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
התאמה אישית חלה על סמן עצירה מתוכנן.

אפשר להשתמש בשדה הזה כדי לציין סגנון מותאם אישית (כמו סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם אובייקט MarkerOptions מצוין, השינויים שצוינו בו חלים על הסמן לאחר יצירת הסמן, והם מחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם צוינה פונקציה, היא תופעל פעם אחת לאחר יצירת הסמן, לפני הוספתו לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט של הפרמטרים לפונקציה מוגדר ל-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין שהנתונים התואמים לסמן הזה השתנו.

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,PlannedStopMarkerCustomizationFunctionParams.
pollingIntervalMillis optional
סוג:  number optional
הזמן המינימלי בין אחזור עדכוני מיקום באלפיות השנייה. אם שליפה של עדכון מיקום נמשכת יותר מ-pollingIntervalMillis, עדכון המיקום הבא יתחיל רק עד שהעדכון הנוכחי יסתיים.

הגדרת הערך 0 משביתה את עדכוני המיקום. עדכון חדש של מיקום מאוחזר אם אחד מהפרמטרים שתועדו על ידי ספק המיקום השתנה.

מרווח ברירת המחדל של הקלפי הוא 5,000 אלפיות השנייה, המרווח המינימלי. אם מגדירים את מרווח הסקרים לערך נמוך יותר שאינו אפס, ייעשה שימוש ב-5,000.
shouldShowOutcomeLocations optional
סוג:  boolean optional
ערך בוליאני כדי להציג או להסתיר מיקומי תוצאות של המשימות שאוחזרו.
shouldShowTasks optional
סוג:  boolean optional
בוליאני כדי להציג או להסתיר משימות. אם המדיניות מוגדרת כ-False, המערכת לא תוכל לקרוא לנקודות הקצה של Tasks כדי לאחזר את המשימות. רק התחנות הבאות יוצגו ברכב.
staleLocationThresholdMillis optional
סוג:  number optional
הסף לאיתור מיקום לא פעיל של רכב. אם מיקום העדכון האחרון של הרכב ישן יותר מהסף, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם הסף הוא פחות מ-0, או אינסוף, המערכת תתעלם מהסף ומיקום הרכב לא ייחשב מיושן.
taskFilterOptions optional
סוג:  FleetEngineTaskFilterOptions optional
סינון אפשרויות שיחולו על שליפת משימות. האפשרויות יכולות לכלול רכב, שעה וסטטוס משימות ספציפיים.
taskMarkerCustomization optional
סוג:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
ההתאמה האישית חלה על סמן של משימה. סימון משימה מתבצע במיקום המתוכנן של כל משימה שמוקצית לרכב המסירה.

אפשר להשתמש בשדה הזה כדי לציין סגנון מותאם אישית (כמו סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם אובייקט MarkerOptions מצוין, השינויים שצוינו בו חלים על הסמן לאחר יצירת הסמן, והם מחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם צוינה פונקציה, היא תופעל פעם אחת לאחר יצירת הסמן, לפני הוספתו לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט של הפרמטרים לפונקציה מוגדר ל-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין שהנתונים התואמים לסמן הזה השתנו.

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,TaskMarkerCustomizationFunctionParams.
taskOutcomeMarkerCustomization optional
סוג:  function(TaskMarkerCustomizationFunctionParams): void optional
ההתאמה האישית חלה על סמן של תוצאת משימה. סמן תוצאה של משימה מעובד במיקום בפועל של כל משימה שמוקצית לרכב המסירה.

אפשר להשתמש בשדה הזה כדי לציין סגנון מותאם אישית (כמו סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם אובייקט MarkerOptions מצוין, השינויים שצוינו בו חלים על הסמן לאחר יצירת הסמן, והם מחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם צוינה פונקציה, היא תופעל פעם אחת לאחר יצירת הסמן, לפני הוספתו לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט של הפרמטרים לפונקציה מוגדר ל-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין שהנתונים התואמים לסמן הזה השתנו.

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,TaskMarkerCustomizationFunctionParams.

ממשק FleetEngineTaskFilterOptions

ממשק google.maps.journeySharing.FleetEngineTaskFilterOptions

אפשרויות סינון למשימות אצל ספק מיקום הרכב המוסר.

completionTimeFrom optional
סוג:  Date optional
גבול תחתון בלעדי לזמן ההשלמה של המשימה. משמש לסינון משימות שהושלמו אחרי הזמן שצוין.
completionTimeTo optional
סוג:  Date optional
גבול עליון בלעדי לזמן ההשלמה של המשימה. משמש לסינון משימות שהושלמו לפני המועד שצוין.
state optional
סוג:  string optional
הסטטוס של המשימה. הערכים החוקיים הם 'פתוח' או 'סגור'.

ממשק FleetEngineDeliveryVehicleLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

אובייקט האירוע מועבר ל-handler של האירוע כשהאירוע FleetEngineDeliveryVehicleLocationProvider.update מופעל.

completedVehicleJourneySegments optional
סוג:  Array<VehicleJourneySegment> optional
קטעי המסלול שהושלמו על ידי הרכב הזה. לא ניתן לשנות אותה.
deliveryVehicle optional
סוג:  DeliveryVehicle optional
מבנה הנתונים של כלי הרכב שמוחזר על ידי העדכון. לא ניתן לשנות אותה.
tasks optional
סוג:  Array<Task> optional
רשימת המשימות שבוצעו על ידי הרכב הזה. לא ניתן לשנות אותה.

המחלקה FleetEngineDeliveryFleetLocationProvider

מחלקה google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider

ספק מיקום לצי המשלוחים.

השיעור הזה נמשך PollingLocationProvider.

אפשר לקבל גישה על ידי התקשרות ל-const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
פרמטרים: 
יצירת ספק מיקום חדש לכלי רכב שנמצאים במעקב של Fleet Engine.
deliveryVehicleFilter
סוג:  string optional
המסנן הופעל כשמביאים את הרכבים למסירה.
locationRestriction
הגבולות שבהם יש לעקוב אחר כלי רכב למשלוחים. אם לא מוגדרים גבולות, לא יתבצע מעקב אחר כלי רכב למשלוחים. כדי לעקוב אחר כל כלי הרכב למשלוחים ללא קשר למיקום, יש להגדיר גבולות המקבילים לכדור הארץ כולו.
staleLocationThresholdMillis
סוג:  number
השדה הזה הוא לקריאה בלבד. הסף לאיתור מיקום לא פעיל של רכב. אם המיקום האחרון של הרכב ישן מהסף הזה, הרכב לא יוצג.
עברו בירושה: isPolling, pollingIntervalMillis
עברו בירושה: addListener
update
function(event)
אירוע שמופעל כשבקשת עדכון הנתונים של Fleet Engine הסתיימה.
עברו בירושה: ispollingchange

ממשק FleetEngineDeliveryFleetLocationProviderOption

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

אפשרויות לספק מיקום של צי המשלוחים.

authTokenFetcher
מספקת אסימוני אינטרנט עבור JSON לצורך אימות הלקוח ל-Fleet Engine.
projectId
סוג:  string
מזהה הפרויקט של הצרכן ממסוף Google Cloud.
deliveryVehicleFilter optional
סוג:  string optional
שאילתת סינון שאפשר להחיל בעת אחזור כלי רכב למשלוחים. המסנן הזה מועבר ישירות ל-Fleet Engine.

כדי לקבל מידע על הפורמטים הנתמכים, אפשר לעיין במאמר ListDeliveryVehiclesRequest.filter.

חשוב לזכור שמסננים חוקיים של מאפיינים צריכים להתחיל בקידומת "מאפיינים". לדוגמה, attributes.x = "y" או attributes."x y" = "z".
deliveryVehicleMarkerCustomization optional
סוג:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
בוצעה התאמה אישית של סמן המשלוח ברכב.

אפשר להשתמש בשדה הזה כדי לציין סגנון מותאם אישית (כמו סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם אובייקט MarkerOptions מצוין, השינויים שצוינו בו חלים על הסמן לאחר יצירת הסמן, והם מחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם צוינה פונקציה, היא תופעל פעם אחת לאחר יצירת הסמן, לפני הוספתו לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט של הפרמטרים לפונקציה מוגדר ל-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין שהנתונים התואמים לסמן הזה השתנו.

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,DeliveryVehicleMarkerCustomizationFunctionParams.
locationRestriction optional
קו הרוחב/קו הרוחב שתחתיו יש לעקוב אחר כלי רכב מיד לאחר יצירת ספק המיקום. אם המדיניות לא מוגדרת, ספק המיקום לא מתחיל לעקוב אחר כלי רכב. יש להשתמש ב-FleetEngineDeliveryFleetLocationProvider.locationRestriction כדי להגדיר את הגבולות ולהתחיל לעקוב. כדי לעקוב אחר כל כלי הרכב למשלוחים ללא קשר למיקום, יש להגדיר גבולות המקבילים לכדור הארץ כולו.
staleLocationThresholdMillis optional
סוג:  number optional
הסף לאיתור מיקום לא פעיל של רכב. אם מיקום העדכון האחרון של הרכב ישן יותר מהסף, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם הסף הוא פחות מאפס, או אינסוף, המערכת תתעלם מהסף ומיקום הרכב לא ייחשב מיושן.

ממשק FleetEngineDeliveryFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

אובייקט האירוע מועבר ל-handler של האירוע כשהאירוע FleetEngineDeliveryFleetLocationProvider.update מופעל.

deliveryVehicles optional
סוג:  Array<DeliveryVehicle> optional
רשימת כלי הרכב שהוחזרו על ידי השאילתה. לא ניתן לשנות אותה.