Fleet Tracking - On Demand Rides & Delivery

המחלקה FleetEngineVehicleLocationProvider

class google.maps.journeySharing.FleetEngineVehicleLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

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

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
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
אופציונלי
ההתאמה האישית חלה על הקו הפוליגוני הפעיל. קו פוליגוני פעיל תואם לחלק מהמסלול שבו הרכב נוסע כרגע.

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

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

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

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

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

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

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

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

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

מרווח הזמן שמוגדר כברירת מחדל בין בדיקות הוא 5,000 אלפיות השנייה, וזה גם המרווח המינימלי. אם מגדירים את מרווח הזמן של הבדיקה לערך נמוך יותר שאינו אפס, המערכת משתמשת בערך 5,000.
remainingPolylineCustomization
אופציונלי
ההתאמה האישית חלה על הקו הפוליגוני הנותר. קו פוליגוני שנותר תואם לחלק מהמסלול שהרכב עדיין לא התחיל לנוע בו.

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

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

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

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

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

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

ממשק FleetEngineVehicleLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

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

המחלקה FleetEngineFleetLocationProvider

class google.maps.journeySharing.FleetEngineFleetLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

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

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
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
אופציונלי
גבולות קו הרוחב/קו האורך שבהם מתבצע מעקב אחרי כלי רכב מיד אחרי שנוצר מופע של ספק המיקום. אם לא מגדירים את ספק המיקום, הוא לא מתחיל לעקוב אחרי אף רכב. צריך להשתמש ב-FleetEngineFleetLocationProvider.locationRestriction כדי להגדיר את הגבולות ולהתחיל לעקוב. כדי לעקוב אחרי כל הרכבים בלי קשר למיקום, מגדירים גבולות ששווים לכל כדור הארץ.
staleLocationThresholdMillis
אופציונלי
סוג: number optional
הסף למיקום לא עדכני של הרכב. אם המיקום המעודכן האחרון של הרכב ישן יותר מהסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות באלפיות השנייה. אם ערך הסף קטן מאפס או שהוא Infinity, המערכת תתעלם מערך הסף והמיקום של הרכב לא ייחשב כמיושן.
vehicleFilter
אופציונלי
סוג: string optional
שאילתת סינון שצריך להפעיל כשמאחזרים כלי רכב. המסנן הזה מועבר ישירות אל Fleet Engine.

במאמר ListVehiclesRequest.filter מפורטים הפורמטים הנתמכים.

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

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

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

ממשק FleetEngineFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

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