Trip and Order Progress

FleetEngineTripLocationProvider class

google.maps.journeySharing.FleetEngineTripLocationProvider class

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

הכיתה הזו היא הרחבה של PollingLocationProvider.

אפשר להתקשר אל const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

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

Static Methods
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 רענון מפורש של המיקום המעקב.
Inherited: addListener

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

‫FleetEngineTripLocationProviderOptions interface

google.maps.journeySharing.FleetEngineTripLocationProviderOptions ממשק

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

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ב-Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הלקוח במסוף Google Cloud.
activePolylineCustomization optional	סוג:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו הפוליגוני הפעיל. קו פוליגוני פעיל תואם לחלק מהמסלול שבו הרכב נוסע כרגע. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר TripPolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
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.
remainingPolylineCustomization optional	סוג:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו המרובה הנותר. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לנוע בו. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר TripPolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
takenPolylineCustomization optional	סוג:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על קו הפוליגון שנוצר. קו פוליגוני שנלקח מתאים לחלק מהמסלול שהרכב כבר עבר. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר TripPolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
tripId optional	סוג:  string optional מזהה הנסיעה למעקב מיידי אחרי יצירת מופע של ספק המיקום. אם לא מציינים ספק מיקום, הספק לא מתחיל לעקוב אחרי אף נסיעה. צריך להשתמש ב-FleetEngineTripLocationProvider.tripId כדי להגדיר את המזהה ולהתחיל לעקוב.
vehicleMarkerCustomization optional	סוג:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית של סמן הרכב. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר TripMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
waypointMarkerCustomization optional	סוג:  (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן של נקודת ציון. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר TripWaypointMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.

ממשק FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent ממשק

אובייקט האירוע שמועבר ל-event handler כשמופעל האירוע FleetEngineTripLocationProvider.update.

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