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 אופציונלי	סוג: Date optional חותמת הזמן של מועד הסיום המשוער של המשימה.
latestVehicleLocationUpdate אופציונלי	סוג: VehicleLocationUpdate optional מידע ספציפי לגבי עדכון לגבי מיקום האחרון.
outcome אופציונלי	סוג: string optional תוצאת המשימה.
outcomeLocation אופציונלי	סוג: LatLngLiteral optional המיקום שבו המשימה הושלמה (מהספק).
outcomeLocationSource אופציונלי	סוג: string optional הגורם שמגדיר את מיקום התוצאה של המשימה (PROVIDER או LAST_VEHICLE_LOCATION).
outcomeTime אופציונלי	סוג: Date optional חותמת הזמן של המועד שבו הוגדרה תוצאת המשימה (מהספק).
plannedLocation אופציונלי	סוג: LatLngLiteral optional המקום שבו צריך לבצע את המשימה.
targetTimeWindow אופציונלי	סוג: TimeWindow optional חלון הזמן שבו צריך להשלים את המשימה.
trackingId אופציונלי	סוג: string optional מזהה לצורכי מעקב של המשלוח.
vehicleId אופציונלי	סוג: string optional המזהה של הרכב שמבצע את המשימה הזו.

ממשק TaskInfo

ממשק google.maps.journeySharing.TaskInfo

סוג TaskInfo, בשימוש על ידי DeliveryVehicleStop.

מאפיינים
extraDurationMillis אופציונלי	סוג: number optional הזמן הנוסף שנדרש כדי לבצע את המשימה, באלפיות השנייה.
id אופציונלי	סוג: string optional המזהה של המשימה.
targetTimeWindow אופציונלי	סוג: 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 אופציונלי	סוג: Date optional זמן ההגעה המשוער למיקום התחנה.
estimatedTaskCompletionTime אופציונלי	סוג: Date optional הזמן המשוער לסיום המשימה.
latestVehicleLocationUpdate אופציונלי	סוג: VehicleLocationUpdate optional מידע ספציפי לגבי עדכון לגבי מיקום האחרון.
plannedLocation אופציונלי	סוג: LatLng optional המקום שבו המשימה תבוצע.
remainingDrivingDistanceMeters אופציונלי	סוג: number optional המרחק הכולל שנותר במטרים עד לVehicleStop הרלוונטי.
remainingStopCount אופציונלי	סוג: number optional מציין את מספר העצירות שנותרו לרכב עד להגעה לעצירה של המשימה, כולל העצירה של המשימה. לדוגמה, אם התחנה הבאה של הרכב היא תחנת המשימה, הערך יהיה 1.
routePolylinePoints אופציונלי	סוג: Array<LatLng> optional רשימה של נקודות שכאשר הן מחוברות, הן יוצרות קו פוליגוני של המסלול הצפוי של הרכב למיקום של המשימה הזו.
state אופציונלי	סוג: string optional מצב הביצוע הנוכחי של המשימה.
targetTimeWindow אופציונלי	סוג: TimeWindow optional חלון הזמן שבו צריך להשלים את המשימה.
taskOutcome אופציונלי	סוג: string optional התוצאה של ניסיון להריץ משימה.
taskOutcomeTime אופציונלי	סוג: Date optional השעה שבה הספק הגדיר את תוצאת המשימה.

ממשק נסיעה

ממשק 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 אופציונלי	סוג: LatLngLiteral optional המיקום שבו הלקוח ירד מהרכב.
actualPickupLocation אופציונלי	סוג: LatLngLiteral optional המיקום שבו הלקוח נאסף.
dropOffTime אופציונלי	סוג: Date optional הזמן המשוער שבו הנוסעים יגיעו ליעד, או הזמן שבו הם הגיעו ליעד בפועל.
latestVehicleLocationUpdate אופציונלי	סוג: VehicleLocationUpdate optional מידע ספציפי לגבי עדכון לגבי מיקום האחרון.
pickupTime אופציונלי	סוג: Date optional הזמן המשוער בעתיד שבו הנוסעים ייאספו, או הזמן בפועל שבו הם נאספו.
plannedDropOffLocation אופציונלי	סוג: LatLngLiteral optional המיקום שבו הלקוח מציין שהוא ירד מהרכב.
plannedPickupLocation אופציונלי	סוג: 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 אופציונלי	סוג: LatLngLiteral optional המיקום שבו מסתיים קטע המסלול הנוכחי.
latestVehicleLocationUpdate אופציונלי	סוג: VehicleLocationUpdate optional המיקום האחרון שדווח של רכב המשלוחים.
remainingDurationMillis אופציונלי	סוג: number optional משך הנסיעה שנותר בקטע המסלול הנוכחי, באלפיות השנייה.

ממשק DeliveryVehicleStop

ממשק google.maps.journeySharing.DeliveryVehicleStop

סוג DeliveryVehicleStop

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

קבועים של DeliveryVehicleStopState

constants google.maps.journeySharing.DeliveryVehicleStopState
ספרייה "journeySharing"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג DeliveryVehicleStopStateString.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");

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

ממשק VehicleJourneySegment

ממשק google.maps.journeySharing.VehicleJourneySegment

סוג VehicleJourneySegment

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

ממשק VehicleLocationUpdate

ממשק google.maps.journeySharing.VehicleLocationUpdate

סוג VehicleLocationUpdate

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

הממשק VehicleWaypoint

ממשק google.maps.journeySharing.VehicleWaypoint

סוג VehicleWaypoint.

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

ממשק הרכב

ממשק google.maps.journeySharing.Vehicle

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

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

ערכי VehicleNavigationStatus קבועים

constants google.maps.journeySharing.VehicleNavigationStatus
ספרייה "journeySharing"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג VehicleNavigationStatusString.

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing");

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

קבועים של VehicleState

constants google.maps.journeySharing.VehicleState
ספרייה "journeySharing"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג VehicleStateString.

const {VehicleState} = await google.maps.importLibrary("journeySharing");

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

קבועים של VehicleType

constants google.maps.journeySharing.VehicleType
ספרייה "journeySharing"

סוג ה-Vehicle.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("journeySharing");

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

קבועים של TripType

constants google.maps.journeySharing.TripType
ספרייה "journeySharing"

סוגי הנסיעות שנתמכים על ידי Vehicle.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג TripTypeString.

const {TripType} = await google.maps.importLibrary("journeySharing");

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

הממשק TripWaypoint

ממשק google.maps.journeySharing.TripWaypoint

סוג TripWaypoint.

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

קבועים של WaypointType

constants google.maps.journeySharing.WaypointType
ספרייה "journeySharing"

סוגי נקודות הדרך שנתמכים על ידי Vehicle.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג WaypointTypeString.

const {WaypointType} = await google.maps.importLibrary("journeySharing");

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

ממשק TimeWindow

ממשק google.maps.journeySharing.TimeWindow

טווח תאריכים.

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

קבועי מהירות

constants google.maps.journeySharing.Speed
ספרייה "journeySharing"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג SpeedString.

const {Speed} = await google.maps.importLibrary("journeySharing");

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

ממשק SpeedReadingInterval

ממשק google.maps.journeySharing.SpeedReadingInterval

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

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