Shipment Tracking

המחלקה FleetEngineShipmentLocationProvider

מחלקה google.maps.journeySharing.FleetEngineShipmentLocationProvider

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

השיעור הזה נמשך PollingLocationProvider.

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

ממשק FleetEngineShipmentLocationProviderOption

ממשק google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions

אפשרויות לספק מיקום של משלוחים.
authTokenFetcher
מספקת אסימוני אינטרנט עבור JSON לצורך אימות הלקוח ל-Fleet Engine.
projectId
סוג:  string
מזהה הפרויקט של הצרכן ממסוף Google Cloud.
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, לאינסוף או לערך שלילי משביתה את העדכונים האוטומטיים של המיקום. עדכון חדש של מיקום מאוחזר פעם אחת אם הפרמטר של מזהה המעקב (לדוגמה, מזהה המעקב של המשלוח של ספק המיקום של המשלוח), או אפשרות סינון (לדוגמה, גבולות אזור התצוגה או מסנני מאפיינים עבור ספקי מיקום של צי).

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

ממשק FleetEngineShipmentLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent

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