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
المعلومات حول الأجزاء المتبقية لإكمالها لهذه المهمة.
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
رقم تعريف التتبّع لمهمة
  • يجب أن تكون سلسلة Unicode صالحة.
  • تقتصر على 64 حرفًا كحد أقصى.
  • تتم تسويتها وفقًا لنموذج تسوية Unicode.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
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}". يجب أن يكون 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
أقسام الرحلة المخصّصة لمركبة التسليم هذه، بدءًا من أحدث موقع جغرافي تم الإبلاغ عنه للمركبة لا تتم تعبئة هذه البيانات إلا عند توفير عنصر البيانات DeliveryVehicle من خلال FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
النوع:  LatLngLiteral optional
الموقع الذي ينتهي فيه جزء المسار الحالي.
latestVehicleLocationUpdate optional
النوع:  VehicleLocationUpdate optional
آخر موقع جغرافي تم الإبلاغ عنه لمركبة التسليم.
remainingDurationMillis optional
النوع:  number optional
مدة القيادة المتبقية في جزء المسار الحالي بالمللي ثانية

واجهة DeliveryVehicleStop

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

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

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

نوع CompanyJourneysegment

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

واجهة VehicleLocationUpdate

واجهة google.maps.journeySharing.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

نوع نقطة اتصال المركبة.

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

تعرض هذه السمة تفاصيل المركبة التي تم إرجاعها من قِبل Fleet Engine.

attributes
النوع:  Object<string, *>
سمات المركبات المخصّصة
name
النوع:  string
بالتنسيق "providers/{provider_id}/vehicles/{vehicle_id}". يجب أن تكون سمة coupon_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 يتم التنقل في تطبيق Drive في وضع 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

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

واجهة 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

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

نطاق زمني

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

مؤشر كثافة حركة المرور على جزء مسار متجاورة ويحدد الفاصل نقاط البداية والنهاية للمقطع من خلال مؤشراتها.

endPolylinePointIndex
النوع:  number
الفهرس المستند إلى الصفر لنقطة النهاية للفاصل الزمني في المسار.
speed
النوع:  Speed
سرعة حركة المرور في هذا الفاصل الزمني.
startPolylinePointIndex
النوع:  number
الفهرس المستند إلى الصفر لنقطة بداية الفاصل الزمني في المسار.