Fleet Tracking - Last Mile Fleet

מחלקה FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider סיווג

ספק מיקום של כלי רכב למשלוחים.

הכיתה הזו משתרעת על פני PollingLocationProvider.

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

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

ממשק FleetEngineDeliveryVehicleLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

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

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

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

    אפשר לעיין ב-DeliveryVehiclePolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
deliveryVehicleId optional
סוג:  string optional
מזהה הרכב למשלוח, שיש לעקוב אחריו מיד לאחר יצירת מופע של ספק המיקום. אם לא מציינים את הפרמטר הזה, ספק המיקום לא מתחיל לעקוב אחרי אף רכב. משתמשים בפונקציה FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId כדי להגדיר את המזהה ולהתחיל את המעקב.
deliveryVehicleMarkerCustomization optional
בוצעה התאמה אישית על סמן הרכב למשלוח.

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

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

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

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

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

מרווח הזמן המינימלי לתשאול הוא 5, 000 אלפיות השנייה. אם תגדיר את מרווח הזמן לתשאול לערך נמוך יותר שאינו אפס, ייעשה שימוש ב-5,000.
remainingPolylineCustomization optional
ההתאמה האישית הוחלה על הקו הנותר. קו פוליגוני שנותר מייצג חלק ממסלול המסלול שהרכב עדיין לא התחיל לעבור בו.

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

    אפשר לעיין ב-DeliveryVehiclePolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
shouldShowOutcomeLocations optional
סוג:  boolean optional
ערך בוליאני להצגה או להסתרה של מיקומי התוצאות של המשימות שאוחזרו.
shouldShowTasks optional
סוג:  boolean optional
ערך בוליאני להצגה או להסתרה של משימות. אם המדיניות מוגדרת כ-False, לא ניתן יהיה לקרוא לנקודת הקצה ListTasks כדי לאחזר את המשימות. יוצגו רק עצירות הרכב הבאות.
staleLocationThresholdMillis optional
סוג:  number optional
סף למיקום של רכב לא פעיל. אם המיקום המעודכן האחרון של הרכב ישן יותר מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם הסף נמוך מ-0, או אינסוף, המערכת תתעלם מהסף ומיקום הרכב לא ייחשב כמיושן.
takenPolylineCustomization optional
הוחלה התאמה אישית על הקו הפוליגוני שנלקח. קו פוליגוני שנלקח הוא חלק מהמסלול שהרכב כבר עבר.

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

    אפשר לעיין ב-DeliveryVehiclePolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
taskFilterOptions optional
סוג:  FleetEngineTaskFilterOptions optional
אפשרויות הסינון שרוצים להחיל במהלך אחזור המשימות. האפשרויות יכולות לכלול סטטוס ספציפי של רכב, שעה ומשימה.
taskMarkerCustomization optional
סוג:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
התאמה אישית הוחלה על סמן המשימה. סמן משימה מעובד במיקום המתוכנן של כל משימה שמוקצית לרכב המסירה.

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

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

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

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

ממשק FleetEngineTaskFilterOptions

ממשק google.maps.journeySharing.FleetEngineTaskFilterOptions

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

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

ממשק FleetEngineDeliveryVehicleLocationProviderUpdateEvent של

ממשק google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

אובייקט האירוע מועבר לגורם המטפל באירועים כשהאירוע 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"). ראה ספריות ב-Maps JavaScript API.

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

ממשק FleetEngineDeliveryFleetLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

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

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

מידע נוסף על הפורמטים הנתמכים זמין במאמר ListDeliveryVehiclesRequest.filter.

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

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

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

ממשק FleetEngineDeliveryFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

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