Fleet Tracking - Last Mile Fleet

הכיתה FleetEngineDeliveryVehicleLocationProvider

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
עבר בירושה: 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 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 אלפיות השנייה, המרווח המינימלי. אם מגדירים את מרווח הזמן לבדיקה לערך נמוך יותר שאינו אפס, המערכת תשתמש בערך 5000.
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

ממשק google.maps.journeySharing.FleetEngineTaskFilterOptions

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

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

הממשק 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 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
עבר בירושה: addListener

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

הממשק FleetEngineDeliveryFleetLocationProviderOptions

ממשק 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 שעות באלפיות השנייה. אם ערך הסף נמוך מאפס או Infinity, המערכת תתעלם מהסף ולא תתייחס למיקום הרכב כמיקום לא עדכני.

הממשק FleetEngineDeliveryFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

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