Fleet Engine Entities

ממשק משימות

ממשק google.maps.journeySharing.Task

הפרטים של משימה שהוחזרה על ידי Fleet Engine.
attributes
סוג:  Object<string, *>
מאפיינים שהוקצו למשימה.
name
סוג:  string
שם המשימה בפורמט "providers/{provider_id}/tasks/{task_id}". ה-Tasks_id צריך להיות מזהה ייחודי ולא מזהה לצורכי מעקב. כדי לאחסן מזהה משלוח לצורכי מעקב, צריך להשתמש בשדה tracking_id. אפשר לשייך לכמה משימות אותו מזהה מסוג tracking_id.
remainingVehicleJourneySegments
מידע על המקטעים שצריך להשלים במשימה.
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

סוג המשימה, בשימוש על ידי 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 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
מערך של ציוני דרך שמציינים את הנתיב מהמיקום הנוכחי לנקודת ההורדה.
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
קטעי הנסיעה שהוקצו לרכב המסירה הזה, החל מהמיקום האחרון שדווח על הרכב. השדה הזה מאוכלס רק כשאובייקט הנתונים 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

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

ממשק VehicleLocationUpdate

ממשק google.maps.journeySharing.VehicleLocationUpdate

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

הממשק של VehicleWaypoint

ממשק google.maps.journeySharing.VehicleWaypoint

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

ממשק הרכב

ממשק google.maps.journeySharing.Vehicle

פרטים של רכב שהוחזר על ידי Fleet Engine.
attributes
סוג:  Object<string, *>
מאפיינים מותאמים אישית של רכב.
name
סוג:  string
בפורמט: "providers/{provider_id}/vehicles/{vehicle_id}". הערך של Automotive_id צריך להיות מזהה ייחודי.
navigationStatus
סטטוס הניווט הנוכחי של הרכב.
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 קבועים

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

ניתן לגשת באמצעות חיוג אל const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
ARRIVED_AT_DESTINATION הרכב נמצא בטווח של כ-50 מטרים מהיעד.
ENROUTE_TO_DESTINATION ניתן לקבל ניווט במסלול מפורט והניווט באמצעות אפליקציית הנהג עבר למצב directoryD_NAV
NO_GUIDANCE הניווט של אפליקציית ה-Drive נמצא במצב FREE_NAV.
OFF_ROUTE הרכב סטי מהמסלול המוצע.
UNKNOWN_NAVIGATION_STATUS סטטוס הניווט לא צוין.

קבועים של VehicleState

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

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

ניתן לגשת באמצעות חיוג אל const {VehicleState} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
OFFLINE הרכב לא מקבל נסיעות חדשות.
ONLINE הרכב מקבל נסיעות חדשות.
UNKNOWN_VEHICLE_STATE מצב הרכב לא ידוע.

קבועים של VehicleType

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

הסוג של Vehicle.

ניתן לגשת באמצעות חיוג אל const {VehicleType} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
AUTO מכונית.
TAXI כל כלי רכב שמשמש כמו מונית (בדרך כלל ברישיון או בפיקוח).
TRUCK רכב עם נפח אחסון גדול
TWO_WHEELER אופנוע, קטנוע או כלי רכב דו-גלגלי אחר.
UNKNOWN סוג כלי רכב לא ידוע.

קבועים של TripType

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

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

ניתן לגשת באמצעות חיוג אל const {TripType} = await google.maps.importLibrary("journeySharing"). ראה ספריות ב-Maps JavaScript API.
EXCLUSIVE הנסיעה מוגבלת לרכב.
SHARED יכול להיות שבנסיעה משותפת כלי רכב עם נסיעות אחרות.
UNKNOWN_TRIP_TYPE סוג נסיעה לא ידוע.

הממשק של TripWaypoint

ממשק google.maps.journeySharing.TripWaypoint

סוג TripWaypoint.
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 קבועים

סוגי ציוני דרך שנתמכים על ידי 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
האינדקס מבוסס-אפס של נקודת ההתחלה של המרווח בנתיב.