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)
פרמטרים: 
יצירת ספק מיקום חדש לרכב ב-Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
פרמטרים: 
ערך המוחזר:  None
פונקציית התאמה אישית של קו פוליגון שמכתימה את הקו הפוליגוני הפעיל בהתאם לקריאת המהירות שלו. מציינים את הפונקציה הזו כ-FleetEngineVehicleLocationProviderOptions.activePolylineCustomization כדי להציג קו פוליגוני שמתחשב בתנועה עבור הקו הפוליגוני הפעיל.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
פרמטרים: 
ערך המוחזר:  None
פונקציית התאמה אישית של קו פוליגוני שמכתימה את קו הפוליגון שנותר לפי קריאת המהירות שלו. מציינים את הפונקציה הזו כ-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). בנוסף, הפונקציה הזו מופעלת כשהקווים של הפוליגון משתנים, או כשספק המיקום מקבל נתונים מ-Fleet Engine, גם אם הנתונים התואמים לפוליגון הזה לא השתנו.

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

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

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

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

    ב-VehicleWaypointMarkerCustomizationFunctionParams מופיעה רשימה של הפרמטרים שסופקו והשימושים שלהם.
originMarkerCustomization 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)
פרמטרים: 
יצירת ספק מיקום חדש לכלי רכב שבהם מתבצע מעקב באמצעות Fleet 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 שעות באלפיות השנייה. אם ערך הסף נמוך מאפס או 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
רשימת הרכבים שהוחזרו על ידי השאילתה. לא ניתן לשינוי.