Trip and Order Progress

הכיתה FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider class

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

הכיתה הזו היא תת-מחלקה של PollingLocationProvider.

אפשר לגשת אליו באמצעות חיוג למספר const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). ספריות ב-Maps JavaScript API

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

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

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

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

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

הממשק FleetEngineTripLocationProviderOptions

ממשק 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 אלפיות השנייה, המרווח המינימלי. אם מגדירים את מרווח הזמן לבדיקה לערך נמוך יותר שאינו אפס, המערכת תשתמש בערך 5000.
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

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

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