Fleet Engine Entities

واجهة مهمة

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

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

أماكن إقامة
attributes	النوع:  Object<string, *> السمات المُسنَدة إلى المهمة.
name	النوع:  string اسم المهمة بالتنسيق "providers/{provider_id}/tasks/{task_id}". يجب أن تكون معرّف_المهمة هو معرّف فريد وليس رقم تعريف تتبع. لتخزين رقم تعريف التتبّع للشحن، استخدِم الحقلtracking_id. يمكن أن يكون للمهام المتعددة نفس رقم تعريف_التتبّع.
remainingVehicleJourneySegments	النوع:  Array<VehicleJourneySegment> معلومات عن الشرائح المتبقية لإكمال هذه المهمة
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 رقم تعريف التتبُّع لإحدى المهام. يجب أن يكون سلسلة يونيكود صالحة. يجب ألا يزيد عدد الأحرف عن 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	النوع:  Array<VehicleJourneySegment> شرائح الرحلة التي تم تخصيصها لمركبة التسليم هذه، بدءًا من أحدث موقع جغرافي للمركبة تم الإبلاغ عنه لا تتم تعبئة هذا الحقل إلا عند توفير عنصر بيانات DeliveryVehicle من خلال FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional	النوع:  LatLngLiteral optional الموقع الجغرافي الذي تنتهي فيه شريحة المسار الحالية
latestVehicleLocationUpdate optional	النوع:  VehicleLocationUpdate optional آخر موقع جغرافي لمركبة التسليم التي تم الإبلاغ عنها
remainingDurationMillis optional	النوع:  number optional مدة القيادة المتبقية في جزء المسار الحالي بالملي ثانية.

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

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

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

أماكن إقامة
tasks	النوع:  Array<TaskInfo> قائمة المهام التي سيتم تنفيذها في هذه المحطة id: رقم تعريف المهمة extraDurationMillis: الوقت الإضافي الذي يستغرقه تنفيذ المهمة بالمللي ثانية
plannedLocation optional	النوع:  LatLngLiteral optional موقع المحطة.
state optional	النوع:  DeliveryVehicleStopState optional حالة المحطة

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

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 وقت بدء الفترة الزمنية (شاملة)