Fleet Tracking - Last Mile Fleet

המחלקה FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");

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

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

Methods
בירושה: addListener

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

ממשק FleetEngineDeliveryVehicleLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

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

מאפיינים
authTokenFetcher	סוג: AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ל-Fleet Engine.
projectId	סוג: string מזהה הפרויקט של הצרכן ממסוף Google Cloud.
activePolylineCustomization אופציונלי	סוג: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו הפוליגוני הפעיל. קו פוליגוני פעיל תואם לחלק מהמסלול שבו הרכב נוסע כרגע. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגוני) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו הפוליגוני אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו הפוליגוני נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו הפוליגוני משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שנוגעים לקו הפוליגוני הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-DeliveryVehiclePolylineCustomizationFunctionParams.
deliveryVehicleId אופציונלי	סוג: string optional מזהה רכב המשלוחים למעקב מיד אחרי שנוצר מופע של ספק המיקום. אם לא מציינים את ספק המיקום, הוא לא מתחיל לעקוב אחרי אף רכב. צריך להשתמש ב-FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId כדי להגדיר את המזהה ולהתחיל לעקוב.
deliveryVehicleMarkerCustomization אופציונלי	סוג: (function(DeliveryVehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן רכב המשלוחים. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שמצוינים בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-DeliveryVehicleMarkerCustomizationFunctionParams.
plannedStopMarkerCustomization אופציונלי	סוג: (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן של עצירה מתוכננת. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שמצוינים בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-PlannedStopMarkerCustomizationFunctionParams.
pollingIntervalMillis אופציונלי	סוג: number optional פרק הזמן המינימלי בין אחזור עדכוני מיקום באלפיות השנייה. אם חולף יותר מ-pollingIntervalMillis עד שהמיקום מתעדכן, העדכון הבא של המיקום לא יתחיל עד שהעדכון הנוכחי יסתיים. אם מגדירים את הערך הזה כ-0, עדכונים לגבי מיקום חוזרים מושבתים. עדכון לגבי מיקום חדש מתקבל אם אחד מהפרמטרים שספק המיקום צופה בהם משתנה. מרווח הזמן שמוגדר כברירת מחדל בין בדיקות הוא 5,000 אלפיות השנייה, וזה גם המרווח המינימלי. אם מגדירים את מרווח הזמן של הבדיקה לערך נמוך יותר שאינו אפס, המערכת משתמשת בערך 5,000.
remainingPolylineCustomization אופציונלי	סוג: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו הפוליגוני הנותר. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לנוע בו. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגוני) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו הפוליגוני אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו הפוליגוני נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו הפוליגוני משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שנוגעים לקו הפוליגוני הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-DeliveryVehiclePolylineCustomizationFunctionParams.
shouldShowOutcomeLocations אופציונלי	סוג: boolean optional ערך בוליאני להצגה או להסתרה של מיקומי התוצאות של המשימות שאוחזרו.
shouldShowTasks אופציונלי	סוג: boolean optional ערך בוליאני להצגה או להסתרה של משימות. אם מגדירים את הערך False, נקודת הקצה ListTasks לא תיקרא כדי לאחזר את המשימות. יוצגו רק התחנות הבאות של הרכב.
staleLocationThresholdMillis אופציונלי	סוג: number optional הסף למיקום לא עדכני של הרכב. אם המיקום המעודכן האחרון של הרכב ישן יותר מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מ-0 או שהוא אינסוף, המערכת תתעלם מערך הסף ומיקום הרכב לא ייחשב כמיושן.
takenPolylineCustomization אופציונלי	סוג: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו הפוליגוני שנוצר. קו פוליגוני שנלקח מתאים לחלק מהמסלול שהרכב כבר עבר. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגוני) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו הפוליגוני אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו הפוליגוני נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו הפוליגוני משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שנוגעים לקו הפוליגוני הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-DeliveryVehiclePolylineCustomizationFunctionParams.
taskFilterOptions אופציונלי	סוג: FleetEngineTaskFilterOptions optional אפשרויות סינון שאפשר להחיל כשמאחזרים משימות. האפשרויות יכולות לכלול רכב ספציפי, שעה וסטטוס משימה.
taskMarkerCustomization אופציונלי	סוג: (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן משימה. סמן משימה מוצג במיקום המתוכנן של כל משימה שהוקצתה לרכב המשלוחים. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שמצוינים בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-TaskMarkerCustomizationFunctionParams.
taskOutcomeMarkerCustomization אופציונלי	סוג: function(TaskMarkerCustomizationFunctionParams): void optional התאמה אישית שחלה על סמן תוצאת המשימה. סמן תוצאת המשימה מוצג במיקום התוצאה בפועל של כל משימה שהוקצתה לרכב המשלוחים. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שמצוינים בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-TaskMarkerCustomizationFunctionParams.

ממשק FleetEngineTaskFilterOptions

ממשק google.maps.journeySharing.FleetEngineTaskFilterOptions

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

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

ממשק FleetEngineDeliveryVehicleLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

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

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

המחלקה FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");

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

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

Methods
בירושה: addListener

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

ממשק FleetEngineDeliveryFleetLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

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

מאפיינים
authTokenFetcher	סוג: AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ל-Fleet Engine.
projectId	סוג: string מזהה הפרויקט של הצרכן ממסוף Google Cloud.
deliveryVehicleFilter אופציונלי	סוג: string optional שאילתת סינון שצריך להחיל כשמאחזרים רכבי משלוחים. המסנן הזה מועבר ישירות אל Fleet Engine. אפשר לעיין בפורמטים הנתמכים ב-ListDeliveryVehiclesRequest.filter. חשוב לשים לב שלמסננים תקינים של מאפיינים צריכה להיות הקידומת "attributes". לדוגמה: attributes.x = "y" או attributes."x y" = "z".
deliveryVehicleMarkerCustomization אופציונלי	סוג: function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional התאמה אישית שחלה על סמן של רכב משלוחים. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שמצוינים בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-DeliveryVehicleMarkerCustomizationFunctionParams.
locationRestriction אופציונלי	סוג: LatLngBounds|LatLngBoundsLiteral optional גבולות קו הרוחב/קו האורך שבהם מתבצע מעקב אחרי כלי רכב מיד אחרי שנוצר מופע של ספק המיקום. אם לא מגדירים את ספק המיקום, הוא לא מתחיל לעקוב אחרי אף רכב. צריך להשתמש ב-FleetEngineDeliveryFleetLocationProvider.locationRestriction כדי להגדיר את הגבולות ולהתחיל לעקוב. כדי לעקוב אחרי כל רכבי המשלוחים בלי קשר למיקום, מגדירים גבולות ששווים לכל כדור הארץ.
staleLocationThresholdMillis אופציונלי	סוג: number optional הסף למיקום לא עדכני של הרכב. אם המיקום המעודכן האחרון של הרכב ישן יותר מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מאפס או שהוא Infinity, המערכת תתעלם מערך הסף והמיקום של הרכב לא ייחשב כמיושן.

ממשק FleetEngineDeliveryFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

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