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. يمكن أن يكون لمهام متعددة رقم تعريف التتبع نفسه.
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 interface

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

نوع TaskInfo، يستخدمه DeliveryVehicleStop.

الخصائص
extraDurationMillis اختياري	النوع: number optional الوقت الإضافي الذي يستغرقه تنفيذ المهمة، بالمللي ثانية
id اختياري	النوع: string optional رقم تعريف المهمة
targetTimeWindow اختياري	النوع: TimeWindow optional يشير هذا الحقل إلى الفترة الزمنية التي يجب إكمال المهمة خلالها.

TaskTrackingInfo interface

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

تفاصيل عنصر معلومات تتبُّع المهام الذي يعرضه Fleet Engine

الخصائص
attributes	النوع: Object<string, *> السمات المخصّصة للمهمة
name	النوع: string الاسم بالتنسيق "providers/{provider_id}/taskTrackingInfo/{tracking_id}"، حيث يمثّل tracking_id رقم تعريف التتبُّع.
trackingId	النوع: string رقم تعريف التتبّع لمهمة معيّنة يجب أن تكون سلسلة Unicode صالحة. يجب ألا يتجاوز الحد الأقصى للطول 64 حرفًا. يجب أن تكون موحّدة وفقًا لنموذج توحيد يونيكود 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 تشير هذه السمة إلى الوقت الذي حدّد فيه مقدّم الخدمة نتيجة المهمة.

واجهة 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 اختياري	النوع: 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

ثوابت 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

ثوابت google.maps.journeySharing.VehicleNavigationStatus
مكتبة "journeySharing"

حالة التنقّل الحالية لـ Vehicle

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع VehicleNavigationStatusString.

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

الثوابت
ARRIVED_AT_DESTINATION	تكون المركبة على بُعد 50 مترًا تقريبًا من الوجهة.
ENROUTE_TO_DESTINATION	تتوفّر الاتجاهات المفصّلة، وقد دخلت ميزة التنقّل في تطبيق Driver في وضع GUIDED_NAV.
NO_GUIDANCE	يكون التنقّل في تطبيق السائق في وضع FREE_NAV.
OFF_ROUTE	خرجت المركبة عن المسار المقترَح.
UNKNOWN_NAVIGATION_STATUS	حالة التنقّل غير محدّدة.

ثوابت VehicleState

ثوابت google.maps.journeySharing.VehicleState
مكتبة "journeySharing"

تمثّل هذه السمة الحالة الحالية لـ Vehicle.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع VehicleStateString.

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

الثوابت
OFFLINE	لا تقبل المركبة رحلات جديدة.
ONLINE	تقبل المركبة رحلات جديدة.
UNKNOWN_VEHICLE_STATE	حالة المركبة غير معروفة.

ثوابت VehicleType

ثوابت google.maps.journeySharing.VehicleType
مكتبة "journeySharing"

نوع Vehicle

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع VehicleTypeString.

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

الثوابت
AUTO	سيارة
TAXI	أي مركبة تعمل كسيارة أجرة (تكون عادةً مرخّصة أو خاضعة للوائح التنظيمية)
TRUCK	مركبة ذات سعة تخزين كبيرة
TWO_WHEELER	دراجة نارية أو دراجة بخارية أو مركبة أخرى ذات عجلتين
UNKNOWN	نوع المركبة غير معروف.

ثوابت TripType

ثوابت 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

ثوابت 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 وقت بدء الفترة الزمنية (شامل).

السرعة ثابتة

ثوابت 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 الفهرس المستند إلى الصفر لنقطة بداية الفاصل الزمني في المسار.