Fleet Tracking - On Demand Rides & Delivery

הכיתה FleetEngineVehicleLocationProvider

google.maps.journeySharing.FleetEngineVehicleLocationProvider class

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

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

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

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

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

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

Methods
עבר בירושה: addListener

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

הממשק FleetEngineVehicleLocationProviderOptions

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

ממשק google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

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

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

הכיתה FleetEngineFleetLocationProvider

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
עבר בירושה: addListener

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

הממשק FleetEngineFleetLocationProviderOptions

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

ממשק google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

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

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