Fleet Tracking - Last Mile Fleet

‫FleetEngineDeliveryVehicleLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

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

הכיתה הזו היא הרחבה של PollingLocationProvider.

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

יצרן
FleetEngineDeliveryVehicleLocationProvider	FleetEngineDeliveryVehicleLocationProvider(options) פרמטרים:  ‫options:  FleetEngineDeliveryVehicleLocationProviderOptions אפשרויות להעברה לספק המיקום. יוצר ספק מיקום חדש לרכב משלוחים ב-Fleet Engine.

מאפיינים
deliveryVehicleId	סוג:  string מזהה של כלי הרכב שהספק הזה עוקב אחריו. מגדירים את השדה הזה כדי לעקוב אחרי רכב.
shouldShowOutcomeLocations	סוג:  boolean optional אפשר לאפשר למשתמשים להציג את מיקום התוצאה של המשימה.
shouldShowTasks	סוג:  boolean optional אפשר לאפשר למשתמשים להציג את המשימות שאוחזרו.
staleLocationThresholdMillis	סוג:  number השדה הזה הוא לקריאה בלבד. סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג.
taskFilterOptions	סוג:  FleetEngineTaskFilterOptions מחזירה את אפשרויות הסינון להחלה בעת אחזור משימות.
בירושה: isPolling, pollingIntervalMillis

Methods
Inherited: addListener

אירועים
error	function(event) ארגומנטים:  event:  ErrorEvent אירוע שמופעל כשספק המיקום נתקל בשגיאה.
update	function(event) ארגומנטים:  event:  FleetEngineDeliveryVehicleLocationProviderUpdateEvent אירוע שמופעל כשבקשה לעדכון נתונים ב-Fleet Engine מסתיימת.
Inherited: ispollingchange

‫FleetEngineDeliveryVehicleLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions ממשק

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

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ב-Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הלקוח במסוף Google Cloud.
activePolylineCustomization optional	סוג:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו הפוליגוני הפעיל. קו פוליגוני פעיל תואם לחלק מהמסלול שבו הרכב נוסע כרגע. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר DeliveryVehiclePolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
deliveryVehicleId optional	סוג:  string optional מזהה רכב המשלוח למעקב מיידי אחרי יצירת מופע של ספק המיקום. אם לא מציינים ספק מיקום, הספק לא מתחיל לעקוב אחרי אף רכב. כדי להגדיר את המזהה ולהתחיל לעקוב, משתמשים ב-FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId.
deliveryVehicleMarkerCustomization optional	סוג:  (function(DeliveryVehicleMarkerCustomizationFunctionParams): void)|MarkerOptions 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.
remainingPolylineCustomization optional	סוג:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו המרובה הנותר. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לנוע בו. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר DeliveryVehiclePolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
shouldShowOutcomeLocations optional	סוג:  boolean optional ערך בוליאני להצגה או להסתרה של מיקומי התוצאות של המשימות שאוחזרו.
shouldShowTasks optional	סוג:  boolean optional ערך בוליאני להצגה או להסתרה של משימות. אם מגדירים את הערך הזה כ-false, לא מתבצעת קריאה לנקודת הקצה ListTasks כדי לאחזר את המשימות. יוצגו רק העצירות הקרובות של כלי הרכב.
staleLocationThresholdMillis optional	סוג:  number optional סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מ-0 או Infinity, המערכת תתעלם מערך הסף ולא תתייחס למיקום הרכב כאל מיקום לא עדכני.
takenPolylineCustomization optional	סוג:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על קו הפוליגון שנוצר. קו פוליגוני שנלקח מתאים לחלק מהמסלול שהרכב כבר עבר. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר DeliveryVehiclePolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
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 interface

google.maps.journeySharing.FleetEngineTaskFilterOptions ממשק

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

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

‫FleetEngineDeliveryVehicleLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent ממשק

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

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

‫FleetEngineDeliveryFleetLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class

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

הכיתה הזו היא הרחבה של PollingLocationProvider.

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

יצרן
FleetEngineDeliveryFleetLocationProvider	FleetEngineDeliveryFleetLocationProvider(options) פרמטרים:  ‫options:  FleetEngineDeliveryFleetLocationProviderOptions אפשרויות להעברה לספק המיקום. יוצר ספק מיקום חדש לרכבים שנמצאים במעקב על ידי Fleet Engine.

מאפיינים
deliveryVehicleFilter	סוג:  string optional המסנן שהופעל כשמאחזרים את כלי הרכב למשלוחים.
locationRestriction	סוג:  LatLngBounds|LatLngBoundsLiteral optional הגבולות שבהם מתבצע מעקב אחרי רכבי משלוח. אם לא מוגדרים גבולות, לא מתבצע מעקב אחרי כלי רכב למשלוחים. כדי לעקוב אחרי כל כלי הרכב למשלוחים בלי קשר למיקום שלהם, צריך להגדיר גבולות ששווים לכל כדור הארץ.
staleLocationThresholdMillis	סוג:  number השדה הזה הוא לקריאה בלבד. סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג.
בירושה: isPolling, pollingIntervalMillis

Methods
Inherited: addListener

אירועים
update	function(event) ארגומנטים:  event:  FleetEngineDeliveryFleetLocationProviderUpdateEvent אירוע שמופעל כשבקשה לעדכון נתונים ב-Fleet Engine מסתיימת.
Inherited: ispollingchange

‫FleetEngineDeliveryFleetLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions ממשק

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

מאפיינים
authTokenFetcher	סוג:  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). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר DeliveryVehicleMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
locationRestriction optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional גבולות קו הרוחב וקו האורך שבהם יתבצע מעקב אחרי כלי רכב מיד אחרי יצירת מופע של ספק המיקום. אם לא מגדירים את המדיניות, ספק המיקום לא מתחיל לעקוב אחרי כלי רכב. צריך להשתמש בFleetEngineDeliveryFleetLocationProvider.locationRestriction כדי להגדיר את הגבולות ולהתחיל לעקוב. כדי לעקוב אחרי כל כלי הרכב למשלוחים בלי קשר למיקום שלהם, צריך להגדיר גבולות ששווים לכל כדור הארץ.
staleLocationThresholdMillis optional	סוג:  number optional סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מאפס או אינסוף, המערכת תתעלם מערך הסף והמיקום של הרכב לא ייחשב כמיקום לא עדכני.

‫FleetEngineDeliveryFleetLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent ממשק

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

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