Fleet Engine Entities

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مهمة واجهة

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

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

name
النوع: string
اسم المهمة بالتنسيق "providers/{provider_id}/tasks/{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
الموقع الجغرافي الذي سيتم فيه إكمال المهمة.
trackingId optional
النوع: string optional
رقم تعريف تتبّع الشحنة
vehicleId optional
النوع: string optional
رقم تعريف المركبة التي تنفّذ هذه المهمة.

TaskTrackingInfo

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

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

name
النوع: string
الاسم بالتنسيق "providers/{provider_id}/taskTrackingInfo/{tracking_id}"، حيث يمثل tracking_id رقم تعريف التتبع.
trackingId
النوع: string
رقم تعريف تتبع المهمة.
  • يجب أن تكون سلسلة Unicode صالحة.
  • يقتصر على 64 حرفًا كحد أقصى.
  • تمت تسويته وفقًا لـ نموذج تسوية Unicode 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
حالة التنفيذ الحالية للمهمة.
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 أو مكتمل أو ملغى.
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
الموقع الذي يشير إليه العميل بأنه سيتم توصيله.

DeliveryVehicle واجهة

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

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

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

DeliveryVehicleStop واجهة

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

نوع DeliveryVehicleStop

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

DeliveryVehicleStopState الثوابت

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

الحالة الحالية لـ DeliveryVehicleStop.

تحميل باستخدام معلمة عنوان URL &libraries=journeySharing. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {DeliveryVehicleStopState} = await google.map.importLibrary("journeySharing"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة VehicleJourneySegment

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

نوع المركبات في رحلة السيارة

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