Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider class

google.maps.journeySharing.FleetEngineVehicleLocationProvider class

ספק מיקום הרכב.

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

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

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

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

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

Methods
Inherited: addListener

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

‫FleetEngineVehicleLocationProviderOptions interface

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions ממשק

אפשרויות לספק מיקום הרכב.

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ב-Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הלקוח במסוף Google Cloud.
activePolylineCustomization optional	סוג:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו הפוליגוני הפעיל. קו פוליגוני פעיל תואם לחלק מהמסלול שבו הרכב נוסע כרגע. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר VehiclePolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
destinationMarkerCustomization optional	סוג:  (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שמוחלת על סמן היעד של נסיעה ברכב. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר VehicleWaypointMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
intermediateDestinationMarkerCustomization optional	סוג:  (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שמוחלת על סמני היעד הביניים של נסיעה ברכב. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר VehicleWaypointMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
originMarkerCustomization optional	סוג:  (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית שחלה על סמן מוצא הנסיעה ברכב. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר VehicleWaypointMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
pollingIntervalMillis optional	סוג:  number optional פרק הזמן המינימלי בין אחזור עדכוני מיקום באלפיות השנייה. אם חולף יותר מ-pollingIntervalMillis עד שהמיקום מתעדכן, העדכון הבא של המיקום לא יתחיל עד שהעדכון הנוכחי יסתיים. הגדרת הערך הזה כ-0 משביתה את העדכונים החוזרים של המיקום. עדכון חדש של המיקום מתקבל אם חל שינוי באחד מהפרמטרים שנצפים על ידי ספק המיקום. הערך שמוגדר כברירת מחדל למרווח בין בדיקות הוא 5,000 אלפיות השנייה, שהוא המרווח המינימלי. אם מגדירים את מרווח הזמן של הבדיקה לערך נמוך יותר שאינו אפס, המערכת תשתמש בערך 5,000.
remainingPolylineCustomization optional	סוג:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על הקו המרובה הנותר. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לנוע בו. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר VehiclePolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
staleLocationThresholdMillis optional	סוג:  number optional סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מ-0 או Infinity, המערכת תתעלם מערך הסף ולא תתייחס למיקום הרכב כאל מיקום לא עדכני.
takenPolylineCustomization optional	סוג:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional ההתאמה האישית חלה על קו הפוליגון שנוצר. קו פוליגוני שנלקח מתאים לחלק מהמסלול שהרכב כבר עבר. בשדה הזה אפשר לציין סגנון מותאם אישית (למשל צבע של קו פוליגון) ואינטראקטיביות (למשל טיפול בקליקים). אם מציינים אובייקט PolylineOptions, השינויים שמצוינים בו יחולו על הקו המרוסק אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו המקוטע נוצר. (בפעולה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשקואורדינטות הקו המשונן משתנות, או כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לקו המשונן הזה השתנו. במאמר VehiclePolylineCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.
vehicleId optional	סוג:  string optional מזהה הרכב למעקב מיד אחרי יצירת מופע של ספק המיקום. אם לא מציינים ספק מיקום, הספק לא מתחיל לעקוב אחרי אף רכב. כדי להגדיר את המזהה ולהתחיל לעקוב, משתמשים ב-FleetEngineVehicleLocationProvider.vehicleId.
vehicleMarkerCustomization optional	סוג:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional התאמה אישית של סמן הרכב. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר VehicleMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.

‫FleetEngineVehicleLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent ממשק

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

מאפיינים
trips optional	סוג:  Array<Trip> optional רשימת הנסיעות שהושלמו ברכב הזה. אי אפשר לשנות.
vehicle optional	סוג:  Vehicle optional מבנה נתוני הרכב שמוחזרים על ידי העדכון. אי אפשר לשנות.

‫FleetEngineFleetLocationProvider class

google.maps.journeySharing.FleetEngineFleetLocationProvider class

ספק מיקום כלל המכשירים בארגון.

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

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

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

מאפיינים
locationRestriction	סוג:  LatLngBounds|LatLngBoundsLiteral optional הגבולות שבהם מתבצע מעקב אחרי כלי רכב. אם לא מוגדרים גבולות, לא מתבצע מעקב אחרי כלי רכב. כדי לעקוב אחרי כל הרכבים בלי קשר למיקום, מגדירים גבולות ששווים לכל כדור הארץ.
staleLocationThresholdMillis	סוג:  number השדה הזה הוא לקריאה בלבד. סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג.
vehicleFilter	סוג:  string optional המסנן שהופעל כשמאחזרים את כלי הרכב.
בירושה: isPolling, pollingIntervalMillis

Methods
Inherited: addListener

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

‫FleetEngineFleetLocationProviderOptions interface

google.maps.journeySharing.FleetEngineFleetLocationProviderOptions ממשק

אפשרויות לספק מיקום של צי הרכב.

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח ב-Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הלקוח במסוף Google Cloud.
locationRestriction optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional גבולות קו הרוחב וקו האורך שבהם יתבצע מעקב אחרי כלי רכב מיד אחרי יצירת מופע של ספק המיקום. אם לא מגדירים את המדיניות, ספק המיקום לא מתחיל לעקוב אחרי כלי רכב. צריך להשתמש בFleetEngineFleetLocationProvider.locationRestriction כדי להגדיר את הגבולות ולהתחיל לעקוב. כדי לעקוב אחרי כל הרכבים בלי קשר למיקום, מגדירים גבולות ששווים לכל כדור הארץ.
staleLocationThresholdMillis optional	סוג:  number optional סף הזמן שמעבר לו מיקום הרכב נחשב לא עדכני. אם המיקום האחרון של הרכב עודכן לפני יותר זמן מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מאפס או אינסוף, המערכת תתעלם מערך הסף והמיקום של הרכב לא ייחשב כמיקום לא עדכני.
vehicleFilter optional	סוג:  string optional שאילתת סינון להחלה בעת אחזור כלי רכב. המסנן הזה מועבר ישירות ל-Fleet Engine. במאמר בנושא ListVehiclesRequest.filter מפורטים הפורמטים הנתמכים. שימו לב: מסננים תקינים של מאפיינים חייבים להתחיל בקידומת attributes. לדוגמה: attributes.x = "y" או attributes."x y" = "z".
vehicleMarkerCustomization optional	סוג:  function(VehicleMarkerCustomizationFunctionParams): void optional התאמה אישית שהוחלה על סמן של רכב. בשדה הזה מציינים עיצוב מותאם אישית (כמו סמל של סמן) ואינטראקטיביות (כמו טיפול בקליקים). אם מציינים אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן אחרי שהוא ייווצר, ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות. אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהוא מתווסף לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בלי קשר לשאלה אם הנתונים שמתאימים לסמן הזה השתנו. במאמר VehicleMarkerCustomizationFunctionParams מפורטת רשימה של הפרמטרים שסופקו והשימושים שלהם.

‫FleetEngineFleetLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent ממשק

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

מאפיינים
vehicles optional	סוג:  Array<Vehicle> optional רשימת הרכבים שהוחזרה על ידי השאילתה. אי אפשר לשנות.