Fleet Tracking - On Demand Rides & Delivery (beta)

מחלקה FleetEngineVehicleLocationProvider

google.maps.journeySharing.FleetEngineVehicleLocationProvider סיווג

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

הכיתה הזו משתרעת על פני PollingLocationProvider.

ניתן לגשת באמצעות חיוג אל const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
פרמטרים: 
יצירת ספק מיקום חדש לרכב Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
פרמטרים: 
ערך החזרה: ללא
פונקציית התאמה אישית של קווים פוליגוניים שצובעת את הקו הפוליגוני הפעיל בהתאם לקריאה מהירה שלו. צריך לציין את הפונקציה הזו בתור FleetEngineVehicleLocationProviderOptions.activePolylineCustomization כדי לעבד קו פוליגוני המודע לתנועה עבור הקו הפוליגוני הפעיל.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
פרמטרים: 
ערך החזרה: ללא
פונקציית התאמה אישית של קווים פוליגוניים שצובעת את הקו הפוליגוני הנותר בהתאם לקריאה מהירה שלו. צריך לציין את הפונקציה הזו בתור FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization כדי לעבד קו פוליגוני המודע לתנועה עבור הקו הפוליגוני הנותר.
staleLocationThresholdMillis
סוג:  number
השדה הזה הוא לקריאה בלבד. סף למיקום של רכב לא פעיל. אם המיקום המעודכן האחרון של הרכב הוא ישן מהסף הזה, הרכב לא יוצג.
vehicleId
סוג:  string
המזהה של כלי הרכב שספק המיקום הזה מזהה. צריך להגדיר את השדה הזה כדי לעקוב אחרי כלי רכב.
עברה בירושה: isPolling, pollingIntervalMillis
עברה בירושה: addListener
error
function(event)
ארגומנטים: 
אירוע שמופעל כשספק המיקום נתקל בשגיאה.
update
function(event)
ארגומנטים: 
אירוע שמופעל כשמסתיימת בקשה לעדכון נתונים של Fleet Engine.
עברה בירושה: ispollingchange

ממשק FleetEngineVehicleLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

האפשרויות של ספק המיקום של הרכב.
authTokenFetcher
מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח מול Fleet Engine.
projectId
סוג:  string
מזהה הפרויקט של הצרכן ממסוף Google Cloud.
activePolylineCustomization optional
סוג:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
ההתאמה האישית הוחלה על הקו הפוליגוני הפעיל. קו פוליגוני פעיל מייצג חלק מהמסלול שהרכב עובר כרגע.

יש להשתמש בשדה הזה כדי לציין עיצוב בהתאמה אישית (כמו צבע בקו פוליגוני) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט PolylineOptions, השינויים שצוינו בו יחולו על הקו הפוליגוני לאחר יצירת הקו הפוליגוני ויחליף את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו הפוליגוני נוצר. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) בנוסף, הפונקציה הזו מופעלת כשהקואורדינטות של ה-polyline משתנות, או כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים ל-polyt Engine הזה השתנו.

    אפשר לעיין ב-VehiclePolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
destinationMarkerCustomization optional
התאמה אישית הוחלה על סמן היעד של הנסיעה ברכב.

יש להשתמש בשדה הזה כדי לציין סגנון בהתאמה אישית (כגון סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן לאחר יצירת הסמן ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהיא מתווספת לתצוגת המפה. (בהפעלה זו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים לסמן הזה השתנו.

    בVehicleWaypointMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
intermediateDestinationMarkerCustomization optional
התאמה אישית הוחלה על הסמנים של יעד הביניים בנסיעה ברכב.

יש להשתמש בשדה הזה כדי לציין סגנון בהתאמה אישית (כגון סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן לאחר יצירת הסמן ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהיא מתווספת לתצוגת המפה. (בהפעלה זו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים לסמן הזה השתנו.

    בVehicleWaypointMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
originMarkerCustomization optional
התאמה אישית הוחלה על סמן המוצא של הנסיעה ברכב.

יש להשתמש בשדה הזה כדי לציין סגנון בהתאמה אישית (כגון סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן לאחר יצירת הסמן ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהיא מתווספת לתצוגת המפה. (בהפעלה זו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים לסמן הזה השתנו.

    בVehicleWaypointMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
pollingIntervalMillis optional
סוג:  number optional
משך הזמן המינימלי בין שליפה של עדכוני מיקום באלפיות השנייה. אם השליפה של עדכון מיקום נמשכת יותר מ-pollingIntervalMillis, עדכון המיקום הבא לא יתחיל עד שהעדכון הנוכחי יסתיים.

הגדרת הערך הזה כ-0 משביתה את עדכוני המיקום החוזרים. עדכון המיקום החדש יאוחזר אם אחד מהפרמטרים שספק המיקום זיהה משתנה.

מרווח הזמן המינימלי לתשאול הוא 5, 000 אלפיות השנייה. אם תגדיר את מרווח הזמן לתשאול לערך נמוך יותר שאינו אפס, ייעשה שימוש ב-5,000.
remainingPolylineCustomization optional
סוג:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
ההתאמה האישית הוחלה על הקו הנותר. קו פוליגוני שנותר מייצג חלק ממסלול המסלול שהרכב עדיין לא התחיל לעבור בו.

יש להשתמש בשדה הזה כדי לציין עיצוב בהתאמה אישית (כמו צבע בקו פוליגוני) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט PolylineOptions, השינויים שצוינו בו יחולו על הקו הפוליגוני לאחר יצירת הקו הפוליגוני ויחליף את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו הפוליגוני נוצר. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) בנוסף, הפונקציה הזו מופעלת כשהקואורדינטות של ה-polyline משתנות, או כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים ל-polyt Engine הזה השתנו.

    אפשר לעיין ב-VehiclePolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
staleLocationThresholdMillis optional
סוג:  number optional
סף למיקום של רכב לא פעיל. אם המיקום המעודכן האחרון של הרכב ישן יותר מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם הסף נמוך מ-0, או אינסוף, המערכת תתעלם מהסף ומיקום הרכב לא ייחשב כמיושן.
takenPolylineCustomization optional
סוג:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
הוחלה התאמה אישית על הקו הפוליגוני שנלקח. קו פוליגוני שנלקח הוא חלק מהמסלול שהרכב כבר עבר.

יש להשתמש בשדה הזה כדי לציין עיצוב בהתאמה אישית (כמו צבע בקו פוליגוני) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט PolylineOptions, השינויים שצוינו בו יחולו על הקו הפוליגוני לאחר יצירת הקו הפוליגוני ויחליף את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהקו הפוליגוני נוצר. (בהפעלה הזו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) בנוסף, הפונקציה הזו מופעלת כשהקואורדינטות של ה-polyline משתנות, או כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים ל-polyt Engine הזה השתנו.

    אפשר לעיין ב-VehiclePolylineCustomizationFunctionParams כדי לראות רשימה של הפרמטרים שסופקו והשימושים שלהם.
vehicleId optional
סוג:  string optional
מזהה הרכב למעקב מיד לאחר יצירת מופע של ספק המיקום. אם לא מציינים את הפרמטר הזה, ספק המיקום לא מתחיל לעקוב אחרי אף רכב. משתמשים בפונקציה FleetEngineVehicleLocationProvider.vehicleId כדי להגדיר את המזהה ולהתחיל את המעקב.
vehicleMarkerCustomization optional
סוג:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
התאמה אישית הוחלה על סמן הרכב.

יש להשתמש בשדה הזה כדי לציין סגנון בהתאמה אישית (כגון סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן לאחר יצירת הסמן ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהיא מתווספת לתצוגת המפה. (בהפעלה זו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים לסמן הזה השתנו.

    בVehicleMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.

FleetEngineVehicleLocationProviderUpdateEvent ממשק

ממשק google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

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

מחלקה FleetEngineFleetLocationProvider

google.maps.journeySharing.FleetEngineFleetLocationProvider סיווג

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

הכיתה הזו משתרעת על פני PollingLocationProvider.

ניתן לגשת באמצעות חיוג אל const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
פרמטרים: 
יצירת ספק מיקום חדש לכלי רכב ש-Flet Engine עוקב אחריהם.
locationRestriction
הגבולות שבהם יש לעקוב אחר כלי רכב. אם לא יוגדרו גבולות, לא יתבצע מעקב אחר כלי רכב. כדי לעקוב אחרי כל כלי הרכב ללא קשר למיקום, צריך להגדיר גבולות שווי ערך לכדור הארץ כולו.
staleLocationThresholdMillis
סוג:  number
השדה הזה הוא לקריאה בלבד. סף למיקום של רכב לא פעיל. אם המיקום המעודכן האחרון של הרכב הוא ישן מהסף הזה, הרכב לא יוצג.
vehicleFilter
סוג:  string optional
המסנן הופעל במהלך אחזור הרכבים.
עברה בירושה: isPolling, pollingIntervalMillis
עברה בירושה: addListener
update
function(event)
ארגומנטים: 
אירוע שמופעל כשמסתיימת בקשה לעדכון נתונים של Fleet Engine.
עברה בירושה: ispollingchange

ממשק FleetEngineFleetLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

אפשרויות עבור ספק המיקום של הצי.
authTokenFetcher
מספק אסימוני אינטרנט מסוג JSON לאימות הלקוח מול Fleet Engine.
projectId
סוג:  string
מזהה הפרויקט של הצרכן ממסוף Google Cloud.
locationRestriction optional
גבולות קווי האורך והרוחב שבהם יש לעקוב אחר כלי רכב מיד לאחר יצירת מופע ספק המיקום. אם המדיניות לא מוגדרת, ספק המיקום לא מתחיל לעקוב אחר כלי רכב. יש להשתמש ב-FleetEngineFleetLocationProvider.locationRestriction כדי להגדיר את הגבולות ולהתחיל את המעקב. כדי לעקוב אחרי כל כלי הרכב ללא קשר למיקום, צריך להגדיר גבולות שווי ערך לכדור הארץ כולו.
staleLocationThresholdMillis optional
סוג:  number optional
סף למיקום של רכב לא פעיל. אם המיקום המעודכן האחרון של הרכב הוא ישן מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם הסף קטן מאפס, או מאינסוף, המערכת תתעלם מהסף ומיקום הרכב לא ייחשב לא פעיל.
vehicleFilter optional
סוג:  string optional
שאילתת סינון שצריך להחיל כשמאחזרים רכבים. המסנן הזה מועבר ישירות אל Fleet Engine.

מידע על הפורמטים הנתמכים זמין במאמר ListVehiclesRequest.filter.

לתשומת ליבך, מסננים חוקיים של מאפיינים חייבים לכלול תחילית של "מאפיינים". לדוגמה, attributes.x = "y" או attributes."x y" = "z".
vehicleMarkerCustomization optional
סוג:  function(VehicleMarkerCustomizationFunctionParams): void optional
התאמה אישית הוחלה על סמן של רכב.

יש להשתמש בשדה הזה כדי לציין סגנון בהתאמה אישית (כגון סמל סמן) ואינטראקטיביות (כמו טיפול בקליקים).
  • אם צוין אובייקט MarkerOptions, השינויים שצוינו בו יחולו על הסמן לאחר יצירת הסמן ויחליפו את אפשרויות ברירת המחדל שלו אם הן קיימות.
  • אם מציינים פונקציה, היא מופעלת פעם אחת כשהסמן נוצר, לפני שהיא מתווספת לתצוגת המפה. (בהפעלה זו, הפרמטר isNew באובייקט הפרמטרים של הפונקציה מוגדר כ-true.) כמו כן, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Flet Engine, גם אם הנתונים התואמים לסמן הזה השתנו.

    בVehicleMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.

ממשק FleetEngineFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

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