Shipment Tracking

הכיתה FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider class

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

הכיתה הזו היא תת-מחלקה של PollingLocationProvider.

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

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

מאפיינים
trackingId	סוג:  string המזהה לצורכי מעקב של המשימה שספק המיקום הזה עוקב אחריה. מגדירים את השדה הזה כדי להתחיל במעקב.
עובר בירושה: isPolling, pollingIntervalMillis

Methods
refresh	refresh() פרמטרים:  ללא ערך המוחזר:  void רענון מפורש של המיקום במעקב.
עבר בירושה: addListener

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

הממשק FleetEngineShipmentLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions

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

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ב-Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הצרכן במסוף Google Cloud.
activePolylineCustomization optional	סוג:  (function(ShipmentPolylineCustomizationFunctionParams): void)|PolylineOptions optional התאמה אישית שחלה על הקו הפעיל. קו פוליגוני פעיל תואם לחלק מהמסלול שבו הרכב נוסע כרגע. משתמשים בשדה הזה כדי לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בלחיצות). אם מצוין אובייקט PolylineOptions, השינויים שצוינו בו יחולו על קו הפוליגון אחרי היצירה שלו, וימחקו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשיוצרים את קו הפוליגון. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true). בנוסף, הפונקציה הזו מופעלת כשהקווים של הפוליגון משתנים, או כשספק המיקום מקבל נתונים מ-Fleet Engine, גם אם הנתונים התואמים לפוליגון הזה לא השתנו. ב-ShipmentPolylineCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
deliveryVehicleMarkerCustomization optional	סוג:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על הסמן של כלי הרכב למשלוח. משתמשים בשדה הזה כדי לציין עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בלחיצות). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו חלים על הסמן אחרי היצירה שלו, ומחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשיוצרים את הסמן, לפני שהוא מתווסף לתצוגת המפה. (בקריאה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, גם אם הנתונים התואמים לסמן הזה השתנו. ב-ShipmentMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
destinationMarkerCustomization optional	סוג:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן היעד. משתמשים בשדה הזה כדי לציין עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בלחיצות). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו חלים על הסמן אחרי היצירה שלו, ומחליפים את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשיוצרים את הסמן, לפני שהוא מתווסף לתצוגת המפה. (בקריאה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, גם אם הנתונים התואמים לסמן הזה השתנו. ב-ShipmentMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
pollingIntervalMillis optional	סוג:  number optional פרק הזמן המינימלי בין אחזור עדכוני המיקום, באלפיות השנייה. אם חלפו יותר מ-pollingIntervalMillis שניות מאז האחזור של עדכון המיקום, עדכון המיקום הבא לא יתחיל עד לסיום העדכון הנוכחי. הגדרת הערך הזה כ-0, כ-Infinity או כערך שלילי משביתה את עדכוני המיקום האוטומטיים. עדכון מיקום חדש מאוחזר פעם אחת אם הפרמטר של מזהה המעקב (לדוגמה, מזהה המעקב אחר המשלוח של ספק המיקום של המשלוח) או אפשרות סינון (לדוגמה, גבולות שדה התצוגה או מסנני מאפיינים של ספקי מיקום של צי כלי רכב) משתנה. מרווח הזמן המינימלי והברירת המחדל לבדיקות הוא 5,000 אלפיות השנייה. אם מגדירים את מרווח הזמן לבדיקות לערך חיובי נמוך יותר, המערכת מאחסנת את הערך 5000 ומשתמשת בו.
remainingPolylineCustomization optional	סוג:  (function(ShipmentPolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית תחול על שאר הקווים הפוליגונים. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לעבור בו. משתמשים בשדה הזה כדי לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בלחיצות). אם מצוין אובייקט PolylineOptions, השינויים שצוינו בו יחולו על קו הפוליגון אחרי היצירה שלו, וימחקו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשיוצרים את קו הפוליגון. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true). בנוסף, הפונקציה הזו מופעלת כשהקווים של הפוליגון משתנים, או כשספק המיקום מקבל נתונים מ-Fleet Engine, גם אם הנתונים התואמים לפוליגון הזה לא השתנו. ב-ShipmentPolylineCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
takenPolylineCustomization optional	סוג:  (function(ShipmentPolylineCustomizationFunctionParams): void)|PolylineOptions optional התאמה אישית שחלה על הקו הפוליגוני שצילמתם. קו פוליגוני שעבר תואם לחלק מהמסלול שהרכב כבר עבר. משתמשים בשדה הזה כדי לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בלחיצות). אם מצוין אובייקט PolylineOptions, השינויים שצוינו בו יחולו על קו הפוליגון אחרי היצירה שלו, וימחקו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשיוצרים את קו הפוליגון. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true). בנוסף, הפונקציה הזו מופעלת כשהקווים של הפוליגון משתנים, או כשספק המיקום מקבל נתונים מ-Fleet Engine, גם אם הנתונים התואמים לפוליגון הזה לא השתנו. ב-ShipmentPolylineCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
trackingId optional	סוג:  string optional מזהה המעקב של המשימה שרוצים לעקוב אחריה, מיד אחרי יצירת המופע של ספק המיקום. אם לא מציינים מזהה, ספק המיקום לא יתחיל לעקוב אחרי אף משימה. צריך להשתמש ב-FleetEngineShipmentLocationProvider.trackingId כדי להגדיר את מזהה המעקב ולהתחיל את המעקב.

הממשק FleetEngineShipmentLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent

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

מאפיינים
taskTrackingInfo optional	סוג:  TaskTrackingInfo optional מבנה המידע למעקב אחר משימות שהעדכון מחזיר. לא ניתן לשינוי.