Fleet Engine Entities

واجهة مهام Google

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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (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 واجهة

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

واجهة VehicleJourneySegment

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

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

واجهة VehicleLocationUpdate

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

نوع VehicleLocationUpdate
heading optional
النوع:  number optional
عنوان التحديث. يشير الصفر إلى الشمال، و180 إلى الجنوب.
location optional
النوع:  LatLngLiteral|LatLng optional
الموقع الجغرافي للتعديل
speedKilometersPerHour optional
النوع:  number optional
السرعة بالكيلومترات في الساعة
time optional
النوع:  Date optional
الوقت الذي تم فيه تلقّي هذا التعديل من المركبة

واجهة VehicleWaypoint

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

نوع 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}" يجب أن يكون 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
ARRIVED_AT_DESTINATION المركبة على بُعد 50 مترًا تقريبًا من الوجهة.
ENROUTE_TO_DESTINATION تتوفّر ميزة التنقّل باتجاهات مفصّلة، ودخلت ميزة التنقّل في تطبيق "سائق Google" في وضع GUIDED_NAV.
NO_GUIDANCE وضع التنقّل في تطبيق Driver هو FREE_NAV.
OFF_ROUTE خرجت المركبة عن المسار المقترَح.
UNKNOWN_NAVIGATION_STATUS حالة التنقّل غير محدّدة.

VehicleState الثوابت

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

الحالة الحالية لـ Vehicle

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

VehicleType الثوابت

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
النوع:  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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
NORMAL السرعة عادية، ولم يتم رصد أي إبطاء.
SLOW تم رصد تباطؤ، ولكن لم يحدث ازدحام مروري.
TRAFFIC_JAM تم رصد ازدحام مروري.

SpeedReadingInterval

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

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