Trip and Order Progress

המחלקה FleetEngineTripLocationProvider

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

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

const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing");

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

שיטות סטטיות
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params) פרמטרים: params: TripPolylineCustomizationFunctionParams הפרמטרים שסופקו לפונקציית ההתאמה האישית של הקו הפוליגוני. הערך המוחזר: אין פונקציה להתאמה אישית של קו פוליגוני שצובעת את הקו הפוליגוני הפעיל בהתאם למהירות הנסיעה. מציינים את הפונקציה הזו בתור FleetEngineTripLocationProviderOptions.activePolylineCustomization כדי לעבד קו פוליגוני שמתחשב במצב התנועה בשביל הקו הפוליגוני הפעיל.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params) פרמטרים: params: TripPolylineCustomizationFunctionParams הפרמטרים שסופקו לפונקציית ההתאמה האישית של הקו הפוליגוני. הערך המוחזר: אין פונקציית התאמה אישית של קו פוליגוני שצובעת את הקו הפוליגוני הנותר בהתאם למהירות הנסיעה. מציינים את הפונקציה הזו בתור FleetEngineTripLocationProviderOptions.remainingPolylineCustomization כדי להציג קו פוליגוני עם מידע על מצב התנועה בשאר המסלול.

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

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

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

ממשק FleetEngineTripLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineTripLocationProviderOptions

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

מאפיינים
authTokenFetcher	סוג: 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 אופציונלי	סוג: (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן של נקודת דרך. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שמצוינים בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. רשימה של הפרמטרים שמסופקים והשימושים שלהם מפורטת ב-TripWaypointMarkerCustomizationFunctionParams.

ממשק FleetEngineTripLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

אובייקט האירוע שמועבר לגורם המטפל באירועים כשמופעל האירוע FleetEngineTripLocationProvider.update.

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