Fleet Engine Entities

واجهة مهمة

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

تفاصيل مهمة عرضها Fleet Engine

attributes
النوع:  Object<string, *>
السمات المُسنَدة إلى المهمة.
name
النوع:  string
اسم المهمة بالتنسيق "providers/{provider_id}/tasks/{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
رقم تعريف المركبة التي تنفّذ هذه المهمة

واجهة TaskTrackingInfo

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

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

attributes
النوع:  Object<string, *>
السمات المُسنَدة إلى المهمة.
name
النوع:  string
الاسم بالتنسيق "providers/{provider_id}/taskTrackingInfo/{tracking_id}"، حيث يمثّل tracking_id رقم تعريف التتبّع.
trackingId
النوع:  string
رقم تعريف التتبُّع لإحدى المهام.
  • يجب أن يكون سلسلة يونيكود صالحة.
  • يجب ألا يزيد عدد الأحرف عن 64 حرفًا.
  • تمت تسويته وفقًا لنموذج تعديل يونيكود.
  • لا يجوز أن يحتوي على أي من أحرف 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}". يجب أن تكون معرّف_الرحلة معرّفًا فريدًا.
passengerCount
النوع:  number
عدد الركاب في هذه الرحلة، ولا يشمل ذلك السائق
remainingWaypoints
النوع:  Array<VehicleWaypoint>
مصفوفة من نقاط الطريق التي تشير إلى المسار من الموقع الحالي إلى نقطة الانسحاب.
status
النوع:  string
الحالة الراهنة للرحلة القيم المحتملة هي UNKNOWN_TRIP_STATUS، جديدة، ENROUTE_TO_PICKUP، ARRIVED_AT_PICKUP، ARRIVED_AT_INTERMEDIATE_DESTINATION، ENROUTE_TO_INTERMEDIATE_DESTINATION أو ENROUTE_TO_DROPoff أو إكمال أو إلغاء.
type
النوع:  string
نوع الرحلة. القيم المحتملة هي UNKNOWN_TRIP_TYPE أو SHARED أو غير حصرية.
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
الموقع الجغرافي الذي يشير إليه العميل عند استلامه

واجهة مركبة التسليم

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

تفاصيل مركبة التسليم التي تعرضها شركة Fleet Engine

attributes
النوع:  Object<string, string optional>
سمات مخصّصة لمركبات التسليم
name
النوع:  string
بالتنسيق "providers/{provider_id}/deliveryمركبات/{delivery_vehicle_id}"). يجب أن تكون معرّف التسليم_vehicle_id معرّفًا فريدًا.
navigationStatus
النوع:  string
حالة التنقّل الحالية للمركبة
remainingDistanceMeters
النوع:  number
المسافة المتبقية في القيادة في جزء المسار الحالي بالمتر
remainingVehicleJourneySegments
شرائح الرحلة التي تم تخصيصها لمركبة التسليم هذه، بدءًا من أحدث موقع جغرافي للمركبة تم الإبلاغ عنه
currentRouteSegmentEndPoint optional
النوع:  LatLngLiteral optional
الموقع الجغرافي الذي تنتهي فيه شريحة المسار الحالية
latestVehicleLocationUpdate optional
النوع:  VehicleLocationUpdate optional
آخر موقع جغرافي لمركبة التسليم التي تم الإبلاغ عنها
remainingDurationMillis optional
النوع:  number optional
مدة القيادة المتبقية في جزء المسار الحالي بالملي ثانية.

واجهة توصيل المركبةالمركبة

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

نوع:المركبة توقف

tasks
النوع:  Array<{
  id:string optional,
  extraDurationMillis:number optional
}>
قائمة المهام التي سيتم تنفيذها في هذه المحطة
  • id: رقم تعريف المهمة
  • extraDurationMillis: الوقت الإضافي الذي يستغرقه تنفيذ المهمة بالمللي ثانية

توصيلات السيارة الثابتة

google.maps.journeySharing.DeliveryVehicleStopState ثوابت

الحالة الراهنة لـ DeliveryVehicleStop

يمكنك الوصول من خلال الاتصال بـ const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

ARRIVED وصلت إلى المحطة. لنفترض أنه عند توجيه المركبة إلى المحطة التالية، تكون هذه المحطات مكتملة.
ENROUTE يتم تحديده وتوجيهه بشكلٍ نشط.
NEW تم الإنشاء لكن ليس توجيهًا نشطًا.
UNSPECIFIED غير معروف.

واجهة vehicleJourneyتقسيم

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

نوع السيارة

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

واجهة vehicleLocationUpdate

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

نوع تحديث LocationLocation

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
المسار من نقطة الطريق السابقة (أو الموقع الحالي للمركبة، إذا كانت نقطة الطريق هذه هي الأولى في قائمة نقاط الطريق)،

واجهة TimeWindow

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

نطاق زمني

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