Fleet Engine Entities

واجهة المهمة

google.maps.journeySharing.Task interface

تفاصيل مهمة تعرضها 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 interface

نوع TaskInfo، ويستخدمه DeliveryVehicleStop.
extraDurationMillis optional
النوع:  number optional
الوقت الإضافي الذي يستغرقه تنفيذ المهمة، بالمللي ثانية
id optional
النوع:  string optional
معرّف المهمة.
targetTimeWindow optional
النوع:  TimeWindow optional
الفترة الزمنية التي يجب إكمال المهمة خلالها

واجهة TaskTrackingInfo

google.maps.journeySharing.TaskTrackingInfo interface

تفاصيل عنصر معلومات تتبُّع المهمة الذي تعرضه 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
تشير هذه السمة إلى الوقت الذي حدّد فيه مقدّم الخدمة نتيجة المهمة.

واجهة الرحلة

google.maps.journeySharing.Trip interface

تفاصيل الرحلة التي تعرضها 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 interface

google.maps.journeySharing.DeliveryVehicle interface

تعرض هذه السمة تفاصيل مركبة التسليم التي تعرضها 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 interface

google.maps.journeySharing.DeliveryVehicleStop interface

نوع 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").
اطّلِع على المكتبات في Maps JavaScript API.
ARRIVED تم الوصول إلى المحطة. يفترض هذا الحقل أنّه عند توجيه المركبة إلى المحطة التالية، تكون جميع المحطات السابقة قد اكتملت.
ENROUTE تم تعيينها ويتم توجيهها بنشاط.
NEW تم إنشاؤه، ولكن لا يتم التوجيه بنشاط.
UNSPECIFIED غير معروف.

VehicleJourneySegment interface

google.maps.journeySharing.VehicleJourneySegment interface

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

واجهة VehicleLocationUpdate

google.maps.journeySharing.VehicleLocationUpdate interface

نوع 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 interface

نوع VehicleWaypoint.
distanceMeters optional
النوع:  number optional
تمثّل هذه السمة مسافة المسار بين نقطة الطريق السابقة (أو الموقع الجغرافي الحالي للمركبة، إذا كانت نقطة الطريق هذه هي الأولى في قائمة نقاط الطريق) ونقطة الطريق هذه بالأمتار.
durationMillis optional
النوع:  number optional
وقت التنقّل بين نقطة الطريق السابقة (أو الموقع الجغرافي الحالي للمركبة، إذا كانت نقطة الطريق هذه هي الأولى في قائمة نقاط الطريق) ونقطة الطريق هذه بالمللي ثانية.
location optional
النوع:  LatLngLiteral optional
الموقع الجغرافي لنقطة الطريق
path optional
النوع:  Array<LatLngLiteral> optional
المسار من نقطة الطريق السابقة (أو الموقع الجغرافي الحالي للمركبة، إذا كانت نقطة الطريق هذه هي الأولى في قائمة نقاط الطريق) إلى نقطة الطريق هذه.
speedReadingIntervals optional
النوع:  Array<SpeedReadingInterval> optional
قائمة بسرعات حركة المرور على طول المسار من نقطة الطريق السابقة (أو الموقع الجغرافي للمركبة) إلى نقطة الطريق الحالية يصف كل فاصل زمني في القائمة عدد الزيارات على جزء متجاور من المسار، ويحدد الفاصل الزمني نقطتَي البداية والنهاية للجزء من خلال الفهارس. يُرجى الاطّلاع على تعريف SpeedReadingInterval لمزيد من التفاصيل.

واجهة المركبة

google.maps.journeySharing.Vehicle interface

تفاصيل مركبة تعرضها 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
آخر مرة تم فيها تعديل حقل نقاط الطريق

ثوابت VehicleNavigationStatus

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

تمثّل هذه السمة حالة التنقّل الحالية في Vehicle.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing").
اطّلِع على المكتبات في Maps JavaScript API.
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").
اطّلِع على المكتبات في Maps JavaScript API.
OFFLINE لا تقبل السيارة رحلات جديدة.
ONLINE المركبة تقبل رحلات جديدة.
UNKNOWN_VEHICLE_STATE حالة المركبة غير معروفة.

VehicleType VehicleType

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

نوع Vehicle

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

ثوابت TripType

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

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

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

TripWaypoint interface

google.maps.journeySharing.TripWaypoint interface

نوع 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

google.maps.journeySharing.WaypointType الثوابت

أنواع نقاط الطريق المتوافقة مع Vehicle

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {WaypointType} = await google.maps.importLibrary("journeySharing").
اطّلِع على المكتبات في Maps JavaScript API.
DROP_OFF_WAYPOINT_TYPE نقاط التوقّف لتوصيل الركاب
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE نقاط على المسار لوجهات وسيطة في رحلة تتضمّن وجهات متعدّدة
PICKUP_WAYPOINT_TYPE نقاط توقّف لاصطحاب الركّاب
UNKNOWN_WAYPOINT_TYPE نوع نقطة الطريق غير معروف.

واجهة TimeWindow

google.maps.journeySharing.TimeWindow interface

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

ثوابت السرعة

google.maps.journeySharing.Speed الثوابت

تصنيف سرعة الخطوط المتعددة استنادًا إلى بيانات حركة المرور

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Speed} = await google.maps.importLibrary("journeySharing").
اطّلِع على المكتبات في Maps JavaScript API.
NORMAL السرعة عادية، ولم يتم رصد أي تباطؤ.
SLOW تم رصد تباطؤ في حركة المرور، ولكن لم يحدث ازدحام.
TRAFFIC_JAM تم رصد ازدحام مروري.

واجهة SpeedReadingInterval

google.maps.journeySharing.SpeedReadingInterval interface

مؤشر كثافة الزيارات على جزء متجاور من المسار يحدّد الفاصل الزمني نقطتَي البداية والنهاية للمقطع من خلال الفهارس.
endPolylinePointIndex
النوع:  number
الفهرس الصفري لنقطة نهاية الفاصل الزمني في المسار
speed
النوع:  Speed
سرعة حركة المرور في هذه الفترة
startPolylinePointIndex
النوع:  number
الفهرس الصفري لنقطة بداية الفاصل الزمني في المسار