Fleet Tracking - On Demand Rides & Delivery (beta)

המחלקה FleetEngineVehicleLocationProvider

כיתה google.maps.journeySharing.FleetEngineVehicleLocationProvider

הערה: זמין רק בערוץ v=beta.

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

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

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

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

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

שיטות
הועבר בירושה: addListener

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

ממשק FleetEngineVehicleLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

הערה: זמין רק בערוץ v=beta.

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

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספקת אסימוני אינטרנט מסוג JSON לאימות הלקוח מול Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הצרכן מ-Google Cloud Console.
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.
staleLocationThresholdMillis optional	סוג:  number optional סף למיקום רכב לא פעיל. אם המיקום האחרון של הרכב מעודכן לסף הזה, הרכב לא יוצג. ברירת המחדל היא 24 שעות, באלפיות השנייה. אם הסף הנמוך מ-0 או Infinity, המערכת תתעלם מהסף והמיקום של הרכב לא ייחשב כמיושן.
vehicleId optional	סוג:  string optional מזהה הרכב למעקב מיד לאחר יצירת המיקום. אם לא יצוין שם, ספק המיקום לא יתחיל לעקוב אחר כלי רכב. יש להשתמש ב-FleetEngineVehicleLocationProvider.vehicleId כדי להגדיר את המזהה ולהתחיל במעקב.
vehicleMarkerCustomization optional	סוג:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional בוצעה התאמה אישית של הסמן על הרכב. אפשר להשתמש בשדה הזה כדי לציין עיצוב בהתאמה אישית (כמו סמל הסמן) ואינטראקטיביות (כמו טיפול בקליקים). אם אובייקט MarkerOptions צוין, השינויים שצוינו בו יחולו על הסמן לאחר יצירת הסמן, ויחליפו את אפשרויות ברירת המחדל אם הן קיימות. אם צוינה פונקציה, היא תופעל פעם אחת לאחר יצירת הסמן, לפני הוספתה לתצוגת המפה. (בהפעלה הזו, הפרמטר isNew באובייקט של הפרמטרים מוגדר ל-true). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין אם הנתונים התואמים לסמן הזה השתנו. לקבלת רשימה של פרמטרים שסופקו והשימוש בהם, ראו VehicleMarkerCustomizationFunctionParams.

ממשק FleetEngineVehicleLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

הערה: זמין רק בערוץ v=beta.

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

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

המחלקה FleetEngineFleetLocationProvider

כיתה google.maps.journeySharing.FleetEngineFleetLocationProvider

הערה: זמין רק בערוץ v=beta.

ספק שירותי המיקום.

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

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

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

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

שיטות
הועבר בירושה: addListener

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

ממשק FleetEngineFleetLocationProviderOptions

ממשק google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

הערה: זמין רק בערוץ v=beta.

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

מאפיינים
authTokenFetcher	סוג:  AuthTokenFetcher מספקת אסימוני אינטרנט מסוג JSON לאימות הלקוח מול Fleet Engine.
projectId	סוג:  string מזהה הפרויקט של הצרכן מ-Google Cloud Console.
locationRestriction optional	סוג:  LatLngBounds|LatLngBoundsLiteral 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). בנוסף, הפונקציה הזו מופעלת כשספק המיקום מקבל נתונים מ-Fleet Engine, בין אם הנתונים התואמים לסמן הזה השתנו. לקבלת רשימה של פרמטרים שסופקו והשימוש בהם, ראו VehicleMarkerCustomizationFunctionParams.

ממשק FleetEngineFleetLocationProviderUpdateEvent

ממשק google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

הערה: זמין רק בערוץ v=beta.

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

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