Fleet Engine Entities

ממשק Task

ממשק google.maps.journeySharing.Task

הפרטים של המשימה שמוחזרים על ידי Fleet Engine.

מאפיינים
attributes	סוג:  Object<string, *> המאפיינים שהוקצו למשימה.
name	סוג:  string שם המשימה בפורמט providers/{provider_id}/tasks/{task_id}. השדה task_id חייב להיות מזהה ייחודי ולא מזהה מעקב. כדי לשמור מזהה מעקב של משלוח, משתמשים בשדה tracking_id. יכול להיות שמספר משימות יכללו את אותו מזהה מעקב (tracking_id).
remainingVehicleJourneySegments	סוג:  Array<VehicleJourneySegment> מידע על הקטעים שנותרו להשלמתם של המשימה הזו.
status	סוג:  string סטטוס הביצוע הנוכחי של המשימה.
type	סוג:  string סוג המשימה, למשל הפסקה או משלוח.
estimatedCompletionTime optional	סוג:  Date optional חותמת הזמן של מועד השלמת המשימה המשוער.
latestVehicleLocationUpdate optional	סוג:  VehicleLocationUpdate optional מידע ספציפי לעדכון המיקום האחרון.
outcome optional	סוג:  string optional התוצאה של המשימה.
outcomeLocation optional	סוג:  LatLngLiteral optional המיקום שבו המשימה הושלמה (מהספק).
outcomeLocationSource optional	סוג:  string optional הגורם שמגדיר את המיקום של תוצאת המשימה ('PROVIDER' או 'LAST_VEHICLE_LOCATION').
outcomeTime optional	סוג:  Date optional חותמת הזמן של מועד ההגדרה של התוצאה של המשימה (מהספק).
plannedLocation optional	סוג:  LatLngLiteral optional המיקום שבו המשימה צריכה להתבצע.
targetTimeWindow optional	סוג:  TimeWindow optional חלון הזמן שבו המשימה צריכה להסתיים.
trackingId optional	סוג:  string optional מזהה המשלוח לצורכי מעקב.
vehicleId optional	סוג:  string optional המזהה של הרכב שמבצע את המשימה הזו.

הממשק TaskInfo

ממשק google.maps.journeySharing.TaskInfo

סוג TaskInfo, שמשמש את DeliveryVehicleStop.

מאפיינים
extraDurationMillis optional	סוג:  number optional הזמן הנוסף שנדרש לביצוע המשימה, באלפיות השנייה.
id optional	סוג:  string optional המזהה של המשימה.
targetTimeWindow optional	סוג:  TimeWindow optional חלון הזמן שבו המשימה צריכה להסתיים.

הממשק TaskTrackingInfo

ממשק google.maps.journeySharing.TaskTrackingInfo

הפרטים של אובייקט מידע למעקב אחר משימות שהוחזרו על ידי Fleet Engine.

מאפיינים
attributes	סוג:  Object<string, *> המאפיינים שהוקצו למשימה.
name	סוג:  string השם בפורמט 'providers/{provider_id}/taskTrackingInfo/{tracking_id}', כאשר tracking_id מייצג את מזהה המעקב.
trackingId	סוג:  string המזהה לצורכי מעקב של משימה. צריכה להיות מחרוזת Unicode חוקית. האורך המקסימלי הוא 64 תווים. מנורמלים לפי Unicode Normalization Form C. אסור לכלול את תווים ה-ASCII הבאים: '/',‏ ':',‏ '?',‏ ',' או '#'.
estimatedArrivalTime optional	סוג:  Date optional שעת ההגעה המשוערת למיקום התחנה.
estimatedTaskCompletionTime optional	סוג:  Date optional זמן השלמה המשוער של משימה.
latestVehicleLocationUpdate optional	סוג:  VehicleLocationUpdate optional מידע ספציפי לעדכון המיקום האחרון.
plannedLocation optional	סוג:  LatLng optional המיקום שבו המשימה תושלם.
remainingDrivingDistanceMeters optional	סוג:  number optional המרחק הכולל שנותר במטרים עד ל-VehicleStop הרצוי.
remainingStopCount optional	סוג:  number optional מספר העצירות שנותרו לרכב עד שמגיעים לתחנה של המשימה, כולל התחנה של המשימה. לדוגמה, אם התחנה הבאה של הרכב היא התחנה של המשימה, הערך יהיה 1.
routePolylinePoints optional	סוג:  Array<LatLng> optional רשימה של נקודות, שמחוברות זו לזו ויוצרות קו מרובע של המסלול הצפוי של הרכב למיקום של המשימה הזו.
state optional	סוג:  string optional מצב הביצוע הנוכחי של המשימה.
targetTimeWindow optional	סוג:  TimeWindow optional חלון הזמן שבו המשימה צריכה להסתיים.
taskOutcome optional	סוג:  string optional התוצאה של ניסיון להריץ משימה.
taskOutcomeTime optional	סוג:  Date optional השעה שבה הספק הגדיר את התוצאה של המשימה.

ממשק Trip

ממשק google.maps.journeySharing.Trip

הפרטים של נסיעה שהוחזרו על ידי Fleet Engine.

מאפיינים
name	סוג:  string בפורמט 'providers/{provider_id}/trips/{trip_id}'. השדה trip_id חייב להיות מזהה ייחודי.
passengerCount	סוג:  number מספר הנוסעים בנסיעה הזו, לא כולל הנהג.
remainingWaypoints	סוג:  Array<VehicleWaypoint> מערך של נקודות ציון שמציינות את הנתיב מהמיקום הנוכחי לנקודת ההורדה.
status	סוג:  string הסטטוס הנוכחי של הנסיעה. הערכים האפשריים הם UNKNOWN_TRIP_STATUS,‏ NEW,‏ ENROUTE_TO_PICKUP,‏ ARRIVED_AT_PICKUP,‏ ARRIVED_AT_INTERMEDIATE_DESTINATION,‏ ENROUTE_TO_INTERMEDIATE_DESTINATION,‏ ENROUTE_TO_DROPOFF,‏ COMPLETE או CANCELED.
type	סוג:  string סוג הנסיעה. הערכים האפשריים הם UNKNOWN_TRIP_TYPE, ‏ SHARED או EXCLUSIVE.
vehicleId	סוג:  string המזהה של הרכב שבו בוצעה הנסיעה.
actualDropOffLocation optional	סוג:  LatLngLiteral optional המיקום שבו הלקוח ירד מהרכב.
actualPickupLocation optional	סוג:  LatLngLiteral optional המיקום שבו הלקוח נאסף.
dropOffTime optional	סוג:  Date optional השעה המשוערת שבה הנוסעים יוורדו, או השעה בפועל שבה הם יוורדו.
latestVehicleLocationUpdate optional	סוג:  VehicleLocationUpdate optional מידע ספציפי לעדכון המיקום האחרון.
pickupTime optional	סוג:  Date optional השעה המשוערת שבה הנוסעים ייאספו, או השעה בפועל שבה הם נאספו.
plannedDropOffLocation optional	סוג:  LatLngLiteral optional המיקום שבו הלקוח מציין שהוא רוצה להוריד את ההזמנה.
plannedPickupLocation optional	סוג:  LatLngLiteral optional המיקום שבו הלקוח מציין שהוא רוצה לאסוף את ההזמנה.

ממשק DeliveryVehicle

ממשק google.maps.journeySharing.DeliveryVehicle

הפרטים של רכב מסירה שהוחזרו על ידי Fleet Engine.

מאפיינים
attributes	סוג:  Object<string, string optional> מאפיינים מותאמים אישית של כלי רכב להעברה.
name	סוג:  string בפורמט 'providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}'. השדה delivery_vehicle_id חייב להיות מזהה ייחודי.
navigationStatus	סוג:  string סטטוס הניווט הנוכחי של הרכב.
remainingDistanceMeters	סוג:  number מרחק הנסיעה שנותר בקטע הנוכחי של המסלול, במטרים.
remainingVehicleJourneySegments	סוג:  Array<VehicleJourneySegment> קטעי המסלול שהוקצו לרכב המסירה הזה, החל מהמיקום האחרון שדווח על הרכב. השדה מאוכלס רק כשאובייקט הנתונים DeliveryVehicle מסופק דרך FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional	סוג:  LatLngLiteral optional המיקום שבו מסתיים קטע המסלול הנוכחי.
latestVehicleLocationUpdate optional	סוג:  VehicleLocationUpdate optional המיקום האחרון שדווח על רכב המסירה.
remainingDurationMillis optional	סוג:  number optional משך הנסיעה שנותר בקטע הנוכחי של המסלול, באלפיות שנייה.

ממשק DeliveryVehicleStop

ממשק google.maps.journeySharing.DeliveryVehicleStop

סוג DeliveryVehicleStop

מאפיינים
tasks	סוג:  Array<TaskInfo> רשימת המשימות לביצוע בתחנה הזו. id: מזהה המשימה. extraDurationMillis: הזמן הנוסף שנדרש לביצוע המשימה, באלפיות השנייה.
plannedLocation optional	סוג:  LatLngLiteral optional המיקום של התחנה.
state optional	סוג:  DeliveryVehicleStopState optional מצב התחנה.

קבועים של DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState קבועים

המצב הנוכחי של DeliveryVehicleStop.

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

קבועים
ARRIVED	הגעה לתחנה. ההנחה היא שכאשר הרכב מקבל מסלול לעצירה הבאה, כל העצירות הקודמות הושלמו.
ENROUTE	הוקצו ונעשה בהן ניתוב פעיל.
NEW	נוצרו, אבל לא מתבצע ניתוב פעיל שלהם.
UNSPECIFIED	לא ידוע.

הממשק VehicleJourneySegment

ממשק google.maps.journeySharing.VehicleJourneySegment

הסוג VehicleJourneySegment

מאפיינים
drivingDistanceMeters optional	סוג:  number optional מרחק הנסיעה מהתחנה הקודמת לתחנה הזו, במטרים.
drivingDurationMillis optional	סוג:  number optional זמן הנסיעה מהתחנה הקודמת לתחנה הזו, באלפיות שנייה.
path optional	סוג:  Array<LatLngLiteral> optional הנתיב מהעצירה הקודמת (או מהמיקום הנוכחי של הרכב, אם זו העצירה הראשונה ברשימת העצירות) אל העצירה הזו.
stop optional	סוג:  DeliveryVehicleStop optional מידע על התחנה.

הממשק VehicleLocationUpdate

ממשק google.maps.journeySharing.VehicleLocationUpdate

הסוג של VehicleLocationUpdate

מאפיינים
heading optional	סוג:  number optional הכותרת של העדכון. הערך 0 מייצג את הצפון, הערך 180 מייצג את הדרום.
location optional	סוג:  LatLngLiteral|LatLng optional המיקום של העדכון.
speedKilometersPerHour optional	סוג:  number optional המהירות בקילומטרים לשעה.
time optional	סוג:  Date optional השעה שבה העדכון התקבל מהרכב.

ממשק VehicleWaypoint

ממשק google.maps.journeySharing.VehicleWaypoint

הסוג של VehicleWaypoint.

מאפיינים
distanceMeters optional	סוג:  number optional מרחק המסלול בין נקודת הציון הקודמת (או המיקום הנוכחי של הרכב, אם נקודת הציון הזו היא הראשונה ברשימת נקודות הציון) לנקודת הציון הזו, במטרים.
durationMillis optional	סוג:  number optional זמן הנסיעה מנקודת הציון הקודמת (או מהמיקום הנוכחי של הרכב, אם נקודת הציון הזו היא הראשונה ברשימת נקודות הציון) לנקודת הציון הזו, באלפיות שנייה.
location optional	סוג:  LatLngLiteral optional המיקום של נקודת הציון.
path optional	סוג:  Array<LatLngLiteral> optional הנתיב מנקודת הציון הקודמת (או מהמיקום הנוכחי של הרכב, אם נקודת הציון הזו היא הראשונה ברשימת נקודות הציון) לנקודת הציון הזו.
speedReadingIntervals optional	סוג:  Array<SpeedReadingInterval> optional רשימת מהירויות התנועה לאורך הנתיב מנקודת הציון הקודמת (או ממיקום הרכב) לנקודת הציון הנוכחית. כל מרווח זמן ברשימה מתאר את התנועה בקטע רציף בנתיב. המרווח מגדיר את נקודות ההתחלה והסיום של הקטע באמצעות האינדקסים שלהן. פרטים נוספים זמינים בהגדרה של SpeedReadingInterval.

ממשק Vehicle

ממשק google.maps.journeySharing.Vehicle

הערה: התכונה זמינה רק בערוץ v=beta.

הפרטים של רכב שהוחזרו על ידי Fleet Engine.

מאפיינים
attributes	סוג:  Object<string, *> מאפייני רכב מותאמים אישית.
name	סוג:  string בפורמט 'providers/{provider_id}/vehicles/{vehicle_id}'. השדה vehicle_id חייב להיות מזהה ייחודי.
navigationStatus	סוג:  VehicleNavigationStatus סטטוס הניווט הנוכחי של הרכב.
remainingDistanceMeters	סוג:  number מרחק הנסיעה שנותר בקטע הנוכחי של המסלול, במטרים.
vehicleState	סוג:  VehicleState מצב הרכב.
vehicleType	סוג:  VehicleType סוג הרכב.
currentRouteSegmentEndPoint optional	סוג:  TripWaypoint optional נקודת הציון שבה מסתיים קטע המסלול הנוכחי.
currentRouteSegmentVersion optional	סוג:  Date optional השעה שבה קטע המסלול הנוכחי הוגדר.
currentTrips optional	סוג:  Array<string> optional רשימת מזהי הנסיעות של הנסיעות שמוקצות כרגע לרכב הזה.
etaToFirstWaypoint optional	סוג:  Date optional זמן ההגעה המשוער לנקודה הראשונה בשדה של נקודות העצירה.
latestLocation optional	סוג:  VehicleLocationUpdate optional המיקום האחרון שדווח על הרכב.
maximumCapacity optional	סוג:  number optional מספר הנוסעים הכולל שכלי הרכב יכול לשאת. הנהג לא נלקח בחשבון בערך הזה.
supportedTripTypes optional	סוג:  Array<TripType> optional סוגי הנסיעות שנתמכים ברכב הזה.
waypoints optional	סוג:  Array<TripWaypoint> optional נקודות הדרך הנותרות שהוקצו לרכב הזה.
waypointsVersion optional	סוג:  Date optional הפעם האחרונה שבה השדה של נקודות הדרך עודכן.

קבועים של VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus קבועים

הערה: התכונה זמינה רק בערוץ v=beta.

סטטוס הניווט הנוכחי של Vehicle.

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

קבועים
ARRIVED_AT_DESTINATION	הרכב נמצא במרחק של כ-50 מ' מהיעד.
ENROUTE_TO_DESTINATION	הניווט במסלול מפורט זמין והניווט באפליקציית Driver נכנס למצב GUIDED_NAV.
NO_GUIDANCE	הניווט באפליקציית הנהיגה נמצא במצב FREE_NAV.
OFF_ROUTE	הרכב יצא מהמסלול המוצע.
UNKNOWN_NAVIGATION_STATUS	סטטוס ניווט לא צוין.

קבועים של VehicleState

google.maps.journeySharing.VehicleState קבועים

הערה: התכונה זמינה רק בערוץ v=beta.

המצב הנוכחי של Vehicle.

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

קבועים
OFFLINE	הרכב לא מקבל נסיעות חדשות.
ONLINE	הרכב מקבל נסיעות חדשות.
UNKNOWN_VEHICLE_STATE	מצב הרכב לא ידוע.

קבועים של VehicleType

google.maps.journeySharing.VehicleType קבועים

הערה: התכונה זמינה רק בערוץ v=beta.

הסוג של Vehicle.

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

קבועים
AUTO	רכב.
TAXI	כל רכב שמשמש כמונית (בדרך כלל רכב ברישיון או בפיקוח).
TRUCK	רכב עם קיבולת אחסון גדולה.
TWO_WHEELER	אופנוע, טוסטוס או כלי רכב דו-גלגלי אחר.
UNKNOWN	סוג הרכב לא ידוע.

קבועים של TripType

google.maps.journeySharing.TripType קבועים

הערה: התכונה זמינה רק בערוץ v=beta.

סוגי הנסיעות שנתמכים ב-Vehicle.

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

קבועים
EXCLUSIVE	הנסיעה היא ייעודית לרכב.
SHARED	יכול להיות שהנסיעה תשתמש ברכב עם נסיעות אחרות.
UNKNOWN_TRIP_TYPE	סוג הנסיעה לא ידוע.

ממשק TripWaypoint

ממשק google.maps.journeySharing.TripWaypoint

הערה: התכונה זמינה רק בערוץ v=beta.

הסוג של נקודת העצירה בנסיעה.

מאפיינים
distanceMeters optional	סוג:  number optional מרחק המסלול בין נקודת הציון הקודמת (או המיקום הנוכחי של הרכב, אם נקודת הציון הזו היא הראשונה ברשימת נקודות הציון) לנקודת הציון הזו, במטרים.
durationMillis optional	סוג:  number optional זמן הנסיעה מנקודת הציון הקודמת (או מהמיקום הנוכחי של הרכב, אם נקודת הציון הזו היא הראשונה ברשימת נקודות הציון) לנקודת הציון הזו, באלפיות שנייה.
location optional	סוג:  LatLng optional המיקום של נקודת הציון.
path optional	סוג:  Array<LatLng> optional הנתיב מהעצירה הקודמת (או מהמיקום הנוכחי של הרכב, אם זו העצירה הראשונה ברשימת העצירות) אל העצירה הזו.
speedReadingIntervals optional	סוג:  Array<SpeedReadingInterval> optional רשימת מהירויות התנועה לאורך הנתיב מנקודת הציון הקודמת (או ממיקום הרכב) לנקודת הציון הנוכחית. כל מרווח זמן ברשימה מתאר את התנועה בקטע רציף בנתיב. המרווח מגדיר את נקודות ההתחלה והסיום של הקטע באמצעות האינדקסים שלהן. פרטים נוספים זמינים בהגדרה של SpeedReadingInterval.
tripId optional	סוג:  string optional הנסיעה שמשויכת לנקודת הציון הזו.
waypointType optional	סוג:  WaypointType optional התפקיד של נקודת הציון הזו בנסיעה, למשל איסוף או מסירה.

קבועים של WaypointType

google.maps.journeySharing.WaypointType קבועים

הערה: התכונה זמינה רק בערוץ v=beta.

סוגי ציוני הדרך שנתמכים ב-Vehicle.

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

קבועים
DROP_OFF_WAYPOINT_TYPE	נקודות דרך להורדת נוסעים.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE	ציוני דרך ליעדים ביניים בנסיעה עם כמה יעדים.
PICKUP_WAYPOINT_TYPE	נקודות דרך לאיסוף נוסעים.
UNKNOWN_WAYPOINT_TYPE	סוג נקודת ציון לא ידוע.

הממשק TimeWindow

ממשק google.maps.journeySharing.TimeWindow

טווח זמן.

מאפיינים
endTime	סוג:  Date שעת הסיום של חלון הזמן (כולל).
startTime	סוג:  Date שעת ההתחלה של חלון הזמן (כולל).

קבועי מהירות

google.maps.journeySharing.Speed קבועים

סיווג המהירות של קו פוליגון על סמך נתוני תנועה.

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

קבועים
NORMAL	מהירות רגילה, לא זוהתה האטה.
SLOW	זוהתה האטה, אבל לא נוצרה פקק תנועה.
TRAFFIC_JAM	זוהה פקק תנועה.

הממשק SpeedReadingInterval

ממשק google.maps.journeySharing.SpeedReadingInterval

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

מאפיינים
endPolylinePointIndex	סוג:  number האינדקס שמתחיל באפס של נקודת הסיום של מרווח הזמן בנתיב.
speed	סוג:  Speed מהירות התנועה במרווח הזמן הזה.
startPolylinePointIndex	סוג:  number האינדקס שמתחיל באפס של נקודת ההתחלה של מרווח הזמן בנתיב.