Fleet Engine Entities

ממשק המשימות

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 interface

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 interface

google.maps.journeySharing.DeliveryVehicleStop ממשק

סוג של DeliveryVehicleStop

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

קבועים של DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState constants

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

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

Constants
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 interface

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 ממשק

הפרטים של כלי רכב שמוחזרים על ידי 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 constants

google.maps.journeySharing.VehicleNavigationStatus constants

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

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

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

VehicleState constants

google.maps.journeySharing.VehicleState constants

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

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

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

VehicleType constants

google.maps.journeySharing.VehicleType constants

סוג Vehicle.

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

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

TripType constants

google.maps.journeySharing.TripType constants

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

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

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

‫TripWaypoint interface

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 constants

google.maps.journeySharing.WaypointType constants

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

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

Constants
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 constants

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

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

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

‫SpeedReadingInterval interface

google.maps.journeySharing.SpeedReadingInterval ממשק

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

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