Fleet Engine Entities

واجهة مهمة

واجهة google.maps.journeySharing.Task

تفاصيل مهمة عرضها Fleet Engine
attributes
النوع:  Object<string, *>
السمات المُسنَدة إلى المهمة.
name
النوع:  string
اسم المهمة بالتنسيق "providers/{provider_id}/tasks/{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
رقم تعريف التتبُّع لإحدى المهام.
  • يجب أن يكون سلسلة يونيكود صالحة.
  • يجب ألا يزيد عدد الأحرف عن 64 حرفًا.
  • تمت تسويته وفقًا لنموذج تعديل يونيكود.
  • لا يجوز أن يحتوي على أي من أحرف 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
الوقت الذي أعدَّ فيه مقدِّم الخدمة نتيجة المهمة.

واجهة رحلة

واجهة google.maps.journeySharing.Trip

تفاصيل رحلة عرضتها شركة Fleet Engine.
name
النوع:  string
بالتنسيق "providers/{provider_id}/trips/{trip_id}". يجب أن تكون معرّف_الرحلة معرّفًا فريدًا.
passengerCount
النوع:  number
عدد الركاب في هذه الرحلة، ولا يشمل ذلك السائق
remainingWaypoints
النوع:  Array<VehicleWaypoint>
مصفوفة من نقاط الطريق التي تشير إلى المسار من الموقع الحالي إلى نقطة الانسحاب.
status
النوع:  string
الحالة الراهنة للرحلة القيم المحتملة هي UNKNOWN_TRIP_STATUS، جديدة، ENROUTE_TO_PICKUP، ARRIVED_AT_PICKUP، ARRIVED_AT_INTERMEDIATE_DESTINATION، ENROUTE_TO_INTERMEDIATE_DESTINATION أو ENROUTE_TO_DROPoff أو إكمال أو إلغاء.
type
النوع:  string
نوع الرحلة. القيم المحتملة هي UNKNOWN_TRIP_TYPE أو SHARED أو غير حصرية.
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
الموقع الجغرافي الذي يشير إليه العميل عند استلامه

واجهة مركبة التسليم

واجهة google.maps.journeySharing.DeliveryVehicle

تفاصيل مركبة التسليم التي تعرضها شركة Fleet Engine
attributes
النوع:  Object<string, string optional>
سمات مخصّصة لمركبات التسليم
name
النوع:  string
بالتنسيق "providers/{provider_id}/deliveryمركبات/{delivery_vehicle_id}"). يجب أن تكون معرّف التسليم_vehicle_id معرّفًا فريدًا.
navigationStatus
النوع:  string
حالة التنقّل الحالية للمركبة
remainingDistanceMeters
النوع:  number
المسافة المتبقية في القيادة في جزء المسار الحالي بالمتر
remainingVehicleJourneySegments
شرائح الرحلة التي تم تخصيصها لمركبة التسليم هذه، بدءًا من أحدث موقع جغرافي للمركبة تم الإبلاغ عنه لا تتم تعبئة هذا الحقل إلا عند توفير عنصر بيانات DeliveryVehicle من خلال FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
النوع:  LatLngLiteral optional
الموقع الجغرافي الذي تنتهي فيه شريحة المسار الحالية
latestVehicleLocationUpdate optional
النوع:  VehicleLocationUpdate optional
آخر موقع جغرافي لمركبة التسليم التي تم الإبلاغ عنها
remainingDurationMillis optional
النوع:  number optional
مدة القيادة المتبقية في جزء المسار الحالي بالملي ثانية.

واجهة توصيل المركبةالمركبة

واجهة google.maps.journeySharing.DeliveryVehicleStop

نوع:المركبة توقف
tasks
النوع:  Array<TaskInfo>
قائمة المهام التي سيتم تنفيذها في هذه المحطة
  • id: رقم تعريف المهمة
  • extraDurationMillis: الوقت الإضافي الذي يستغرقه تنفيذ المهمة بالمللي ثانية
plannedLocation optional
النوع:  LatLngLiteral optional
موقع المحطة.
state optional
النوع:  DeliveryVehicleStopState optional
حالة المحطة

توصيلات السيارة الثابتة

google.maps.journeySharing.DeliveryVehicleStopState ثوابت

الحالة الراهنة لـ DeliveryVehicleStop

يمكنك الوصول من خلال الاتصال بـ const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
ARRIVED وصلت إلى المحطة. لنفترض أنه عند توجيه المركبة إلى المحطة التالية، تكون هذه المحطات مكتملة.
ENROUTE يتم تحديده وتوجيهه بشكلٍ نشط.
NEW تم الإنشاء لكن ليس توجيهًا نشطًا.
UNSPECIFIED غير معروف.

واجهة vehicleJourneyتقسيم

واجهة google.maps.journeySharing.VehicleJourneySegment

نوع السيارة
drivingDistanceMeters optional
النوع:  number optional
مسافة السفر من المحطة السابقة إلى هذه المحطة بالمتر
drivingDurationMillis optional
النوع:  number optional
مدة الرحلة من المحطة السابقة التي تتوقّف فيها هذه المحطة، بالملي ثانية
path optional
النوع:  Array<LatLngLiteral> optional
المسار من المحطة السابقة (أو الموقع الجغرافي الحالي للمركبة، إذا كانت هذه المحطة هي الأولى في قائمة المحطات)
stop optional
النوع:  DeliveryVehicleStop optional
معلومات عن المحطة

واجهة vehicleLocationUpdate

واجهة google.maps.journeySharing.VehicleLocationUpdate

نوع تحديث LocationLocation
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}". يجب أن تكون vehicle_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
تاريخ آخر تعديل.

ثوابت مركبة التنقل المركبة

google.maps.journeySharing.VehicleNavigationStatus ثوابت

حالة التنقل الحالية في Vehicle.

يمكنك الوصول من خلال الاتصال بـ const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
ARRIVED_AT_DESTINATION تقع المركبة على مسافة 50 متر تقريبًا من الوجهة.
ENROUTE_TO_DESTINATION تتوفّر ميزة التنقّل باتّجاهات مفصّلة ودخل وضع التنقّل في تطبيق "السائق" في وضع GUIDED_NAV.
NO_GUIDANCE التنقّل في تطبيق "السائق" في وضع FREE_NAV.
OFF_ROUTE لقد خرجت المركبة من المسار المقترَح.
UNKNOWN_NAVIGATION_STATUS حالة التنقل غير محدّدة.

الثوابت.

google.maps.journeySharing.VehicleState ثوابت

الحالة الراهنة لـ Vehicle

يمكنك الوصول من خلال الاتصال بـ const {VehicleState} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
OFFLINE لا تقبل المركبة رحلات جديدة.
ONLINE تقبل المركبة رحلات جديدة.
UNKNOWN_VEHICLE_STATE حالة المركبة غير معروفة.

ثوابت مركبةType

google.maps.journeySharing.VehicleType ثوابت

تمثّل هذه السمة نوع Vehicle.

يمكنك الوصول من خلال الاتصال بـ const {VehicleType} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
AUTO سيارة.
TAXI أي مركبة تعمل كسيارة أجرة (عادةً ما تكون مرخّصة أو خاضعة للرقابة)
TRUCK مركَبة ذات مساحة تخزين كبيرة
TWO_WHEELER دراجة نارية أو دراجة نارية أو مركبة أخرى ذات دراجة نارية.
UNKNOWN نوع المركبة غير معروف.

TripType ثوابت

google.maps.journeySharing.TripType ثوابت

أنواع الرحلات المتوافقة مع Vehicle.

يمكنك الوصول من خلال الاتصال بـ const {TripType} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
EXCLUSIVE هذه الرحلة حصرية لمركبة.
SHARED قد تشارك الرحلة مركبة مع رحلات أخرى.
UNKNOWN_TRIP_TYPE نوع رحلة غير معروف.

واجهة TripWaypoint

واجهة google.maps.journeySharing.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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
DROP_OFF_WAYPOINT_TYPE نقاط العبور في مناطق الانسحاب
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE تشير هذه السمة إلى نقاط الوصول إلى الوجهات المتوسطة في رحلة ذات وجهات متعددة.
PICKUP_WAYPOINT_TYPE نقاط التقاط صور لراكبي الدراجات
UNKNOWN_WAYPOINT_TYPE نوع نقطة طريق غير معروفة.

واجهة TimeWindow

واجهة google.maps.journeySharing.TimeWindow

نطاق زمني
endTime
النوع:  Date
وقت انتهاء الفترة الزمنية (شاملة)
startTime
النوع:  Date
وقت بدء الفترة الزمنية (شاملة)