Fleet Engine Entities

ממשק משימה

ממשק google.maps.journeySharing.Task

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

סוג 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}". ה-tridid צריך להיות מזהה ייחודי.
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
המיקום שבו הלקוח יאסוף אותו.

ממשק ShippingVehicle

ממשק 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"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
ARRIVED הגעתי לעצירה. נקודת הפתיחה: כשהרכב עובר לתחנה הבאה, כל התחנות הקודמות הושלמו.
ENROUTE הקצאה וניתוב באופן פעיל.
NEW נוצר, אבל לא מתבצע ניתוב פעיל.
UNSPECIFIED לא ידוע.

הממשק של VehicleJourneySegment

ממשק google.maps.journeySharing.VehicleJourneySegment

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

ממשק VehicleLocationUpdate

ממשק google.maps.journeySharing.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

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

ממשק לרכב

ממשק google.maps.journeySharing.Vehicle

פרטי הרכב שמוחזר על ידי Fleet Engine.
attributes
סוג:  Object<string, *>
מאפייני רכב מותאמים אישית.
name
סוג:  string
בפורמט "providers/{provider_id}/vehicles/{vehicle_id}". הערך car_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"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
ARRIVED_AT_DESTINATION הרכב נמצא במרחק של כ-50 מטרים מהיעד.
ENROUTE_TO_DESTINATION ניווט מפורט זמין והניווט של אפליקציית הנהג עבר למצב GuideD_NAV.
NO_GUIDANCE הניווט של אפליקציית הנהג במצב FREE_NAV.
OFF_ROUTE הרכב ירד מהמסלול המוצע.
UNKNOWN_NAVIGATION_STATUS סטטוס ניווט לא מוגדר.

קבועים של VehicleState

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

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

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

קבועים של VehicleType

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

הסוג של Vehicle.

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

קבועים של TripType

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

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

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

ממשק TripWaypoint

ממשק google.maps.journeySharing.TripWaypoint

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

קבועים של WaypointType

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

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

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

הממשק של TimeWindow

ממשק google.maps.journeySharing.TimeWindow

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