Shipment Tracking

מחלקה FleetEngineShipmentLocationProvider

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

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

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

ניתן לגשת באמצעות חיוג אל const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
פרמטרים: 
יצירת ספק מיקום חדש למעקב אחר משלוחים של Fleet Engine.
trackingId
סוג:  string
המזהה לצורכי מעקב של המשימה שספק המיקום הזה מטפל בה. יש להגדיר את השדה הזה כדי להתחיל במעקב.
עברה בירושה: isPolling, pollingIntervalMillis
refresh
refresh()
פרמטרים: ללא
הערך המוחזר:  void
רענון מפורש של המיקום שבמעקב.
עברה בירושה: addListener
error
function(event)
ארגומנטים: 
אירוע שמופעל כשספק המיקום נתקל בשגיאה.
update
function(event)
ארגומנטים: 
אירוע שמופעל כשמסתיימת בקשה לעדכון נתונים של Fleet Engine.
עברה בירושה: ispollingchange

ממשק FleetEngineShipmentLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions

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

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

    אפשר לעיין ב-ShipmentPolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
deliveryVehicleMarkerCustomization optional
סוג:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
בוצעה התאמה אישית על סמן הרכב למשלוח.

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

    בShipmentMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
destinationMarkerCustomization optional
סוג:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
התאמה אישית הוחלה על סמן היעד.

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

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

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

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

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

    אפשר לעיין ב-ShipmentPolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
takenPolylineCustomization optional
הוחלה התאמה אישית על הקו הפוליגוני שנלקח. קו פוליגוני שנלקח הוא חלק מהמסלול שהרכב כבר עבר.

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

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

ממשק FleetEngineShipmentLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent

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