Trip and Order Progress

המחלקה FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

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

ממשק FleetEngineTripLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineTripLocationProviderOptions

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

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

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

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

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

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

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

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

מרווח הזמן שמוגדר כברירת מחדל בין בדיקות הוא 5,000 אלפיות השנייה, וזה גם המרווח המינימלי. אם מגדירים את מרווח הזמן של הבדיקה לערך נמוך יותר שאינו אפס, המערכת משתמשת בערך 5,000.
remainingPolylineCustomization
אופציונלי
סוג: (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
ההתאמה האישית חלה על הקו הפוליגוני הנותר. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לנוע בו.

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

    רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-TripPolylineCustomizationFunctionParams.
takenPolylineCustomization
אופציונלי
סוג: (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
ההתאמה האישית חלה על הקו הפוליגוני שנוצר. קו פוליגוני שנלקח מתאים לחלק מהמסלול שהרכב כבר עבר.

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

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

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

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

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

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

ממשק FleetEngineTripLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

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