Trip and Order Progress

המחלקה FleetEngineTripLocationProvider

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

ספק מיקום לנסיעה.

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

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

ממשק FleetEngineTripLocationProviderOption

ממשק google.maps.journeySharing.FleetEngineTripLocationProviderOptions

אפשרויות לספק המיקום של הנסיעה.
authTokenFetcher
מספקת אסימוני אינטרנט עבור JSON לצורך אימות הלקוח ל-Fleet Engine.
projectId
סוג:  string
מזהה הפרויקט של הצרכן ממסוף Google Cloud.
destinationMarkerCustomization optional
סוג:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
בוצעה התאמה אישית של הסמן על היעד.

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

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,TripMarkerCustomizationFunctionParams.
originMarkerCustomization optional
סוג:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
בוצעה התאמה אישית של הסמן המקורי.

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

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

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

מרווח ברירת המחדל של הקלפי הוא 5,000 אלפיות השנייה, המרווח המינימלי. אם מגדירים את מרווח הסקרים לערך נמוך יותר שאינו אפס, ייעשה שימוש ב-5,000.
tripId optional
סוג:  string optional
מזהה הנסיעה שצריך לעקוב מייד אחרי ספק המיקום. אם לא צוין, ספק המיקום לא מתחיל לעקוב אחר נסיעה. יש להשתמש ב-FleetEngineTripLocationProvider.tripId להגדרת המזהה ולהתחיל במעקב.
vehicleMarkerCustomization optional
סוג:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
בוצעה התאמה אישית של הסמן על הרכב.

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

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,TripMarkerCustomizationFunctionParams.
waypointMarkerCustomization optional
ההתאמה האישית חלה על סמן של ציון דרך.

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

    לרשימה של פרמטרים שסופקו והשימוש שלהם בהם,TripWaypointMarkerCustomizationFunctionParams.

ממשק FleetEngineTripLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

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