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
معلومات عن الأجزاء المتبقية لإكمال هذه المهمة.
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
أجزاء الرحلة المخصّصة لمركبة التوصيل هذه، بدءًا من آخر موقع جغرافي تم الإبلاغ عنه للمركبة لا تتم تعبئة هذا الحقل إلا عند تقديم عنصر بيانات 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
حالة التنقّل الحالية للمركبة
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
الفهرس المستند إلى الصفر لنقطة بداية الفاصل الزمني في المسار.