Fleet Tracking - Last Mile Fleet

فئة FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

مقدّم معلومات موقع المركبة للتسليم

يمتدّ هذا الصف إلى PollingLocationProvider.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
المَعلمات: 
تُنشئ هذه الرسالة عنصرًا جديدًا لمقدّم الموقع الجغرافي لمركبة تسليم في Fleet Engine.
deliveryVehicleId
النوع:  string
رقم تعريف المركبة التي يرصدها موفّر الموقع الجغرافي هذا اضبط هذا الحقل لتتبُّع مركبة.
shouldShowOutcomeLocations
النوع:  boolean optional
السماح للمستخدمين بعرض الموقع الجغرافي لنتيجة المهمة اختياريًا
shouldShowTasks
النوع:  boolean optional
السماح للمستخدمين بعرض المهام التي تم استرجاعها اختياريًا
staleLocationThresholdMillis
النوع:  number
هذا الحقل للقراءة فقط. الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
taskFilterOptions
عرض خيارات الفلترة التي سيتم تطبيقها عند جلب المهام
مكتسَبة: isPolling، pollingIntervalMillis
مكتسَبة: addListener
error
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عندما يواجه موفِّر الموقع الجغرافي خطأ
update
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineDeliveryVehicleLocationProviderOptions

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

خيارات لمزوّد الموقع الجغرافي لمركبة التسليم
authTokenFetcher
النوع:  AuthTokenFetcher
يوفّر الرموز المميّزة بتنسيق JSON لمصادقة العميل على Fleet Engine.
projectId
النوع:  string
رقم تعريف مشروع المستهلك من Google Cloud Console
activePolylineCustomization optional
التخصيص الذي تم تطبيقه على الخط المتعدّد النشط تتوافق الخطوط المتعددة النشطة مع جزء من المسار الذي تقطعه المركبة حاليًا.

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل لون الخطوط المتعددة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخط المتعدّد بعد إنشائه، ما يؤدي إلى استبدال خياراته التلقائية في حال توفّرها.
  • في حال تحديد دالة، يتمّ استدعاؤها مرّة واحدة عند إنشاء الخطّ المتعدّد. (عند إجراء هذا الطلب، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عند تغيُّر إحداثيات الخطّ المتعدّد، أو عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا الخطّ المتعدّد قد تغيّرت.

    اطّلِع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
deliveryVehicleId optional
النوع:  string optional
رقم تعريف مركبة التسليم لتتبُّعها فورًا بعد إنشاء مثيل لموفّر الموقع الجغرافي إذا لم يتم تحديد رقم تعريف، لن يبدأ مقدّم خدمة الموقع الجغرافي تتبُّع أي مركبة. استخدِم FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId لضبط رقم التعريف وبدء التتبُّع.
deliveryVehicleMarkerCustomization optional
النوع:  (function(DeliveryVehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
تخصيص تم تطبيقه على علامة مركبة التسليم

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية في حال توفّرها.
  • في حال تحديد وظيفة، يتمّ استدعاؤها مرّة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في عملية الاستدعاء هذه، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا العلامة قد تغيّرت.

    اطّلِع على DeliveryVehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.
plannedStopMarkerCustomization optional
النوع:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
تم تطبيق تخصيص على علامة محطة مخطّط لها.

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية في حال توفّرها.
  • في حال تحديد وظيفة، يتمّ استدعاؤها مرّة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في عملية الاستدعاء هذه، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا العلامة قد تغيّرت.

    اطّلِع على PlannedStopMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.
pollingIntervalMillis optional
النوع:  number optional
الحد الأدنى للوقت بين جلب آخر المعلومات عن الموقع الجغرافي بالمللي ثانية إذا استغرق جلب تحديث الموقع الجغرافي أكثر من pollingIntervalMillis، لن يبدأ تحديث الموقع الجغرافي التالي إلى أن ينتهي التحديث الحالي.

يؤدي ضبط هذه القيمة على 0 إلى إيقاف تعديلات الموقع الجغرافي المتكررة. يتم جلب إشعار جديد بشأن الموقع الجغرافي في حال تغيّر أي من المَعلمات التي يرصدها مقدّم الموقع الجغرافي.

فترة الاستطلاع التلقائية هي 5000 مللي ثانية، وهي الحد الأدنى لفترة الاستطلاع. في حال ضبط الفاصل الزمني للاستطلاع على قيمة أقل غير صفرية، يتم استخدام القيمة 5000.
remainingPolylineCustomization optional
تم تطبيق التخصيص على الخط المتعدّد المتبقّي. تتوافق الخطوط المتعددة المتبقية مع جزء من المسار لم تبدأ المركبة في العبور منه بعد.

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل لون الخطوط المتعددة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخط المتعدّد بعد إنشائه، ما يؤدي إلى استبدال خياراته التلقائية في حال توفّرها.
  • في حال تحديد دالة، يتمّ استدعاؤها مرّة واحدة عند إنشاء الخطّ المتعدّد. (عند إجراء هذا الطلب، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عند تغيُّر إحداثيات الخطّ المتعدّد، أو عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا الخطّ المتعدّد قد تغيّرت.

    اطّلِع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
shouldShowOutcomeLocations optional
النوع:  boolean optional
قيمة منطقية لعرض أو إخفاء مواقع النتائج للمهام التي تم جلبها
shouldShowTasks optional
النوع:  boolean optional
قيمة منطقية لعرض المهام أو إخفائها سيؤدي ضبط هذا الخيار على "خطأ" إلى منع استدعاء نقطة نهاية ListTasks لجلبها. لن يتم عرض سوى محطات المركبات القادمة.
staleLocationThresholdMillis optional
النوع:  number optional
الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من 0 أو Infinity، سيتم تجاهل الحدّ الأدنى ولن يُعتبَر موقع المركبة قديمًا.
takenPolylineCustomization optional
التخصيص الذي تم تطبيقه على الخط المتعدد الذي تم إنشاؤه تتوافق الخطوط المتعددة التي تم رصدها مع جزء من المسار الذي سبق أن قطعته المركبة.

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل لون الخطوط المتعددة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخط المتعدّد بعد إنشائه، ما يؤدي إلى استبدال خياراته التلقائية في حال توفّرها.
  • في حال تحديد دالة، يتمّ استدعاؤها مرّة واحدة عند إنشاء الخطّ المتعدّد. (عند إجراء هذا الطلب، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عند تغيُّر إحداثيات الخطّ المتعدّد، أو عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا الخطّ المتعدّد قد تغيّرت.

    اطّلِع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
taskFilterOptions optional
النوع:  FleetEngineTaskFilterOptions optional
خيارات الفلترة التي سيتم تطبيقها عند جلب المهام يمكن أن تتضمّن الخيارات مركبة ووقتًا وحالة مهمة معيّنة.
taskMarkerCustomization optional
النوع:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
تخصيص تم تطبيقه على علامة مهمة يتم عرض علامة مهمة في الموقع الجغرافي المخطَّط لكل مهمة تم إسنادها إلى مركبة التسليم.

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية في حال توفّرها.
  • في حال تحديد وظيفة، يتمّ استدعاؤها مرّة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في عملية الاستدعاء هذه، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا العلامة قد تغيّرت.

    اطّلِع على TaskMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.
taskOutcomeMarkerCustomization optional
النوع:  function(TaskMarkerCustomizationFunctionParams): void optional
تخصيص تم تطبيقه على علامة نتيجة مهمة يتم عرض علامة نتيجة المهمة في الموقع الجغرافي الفعلي للنتيجة لكل مهمة تم تعيينها لمركبة التسليم.

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية في حال توفّرها.
  • في حال تحديد وظيفة، يتمّ استدعاؤها مرّة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في عملية الاستدعاء هذه، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا العلامة قد تغيّرت.

    اطّلِع على TaskMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.

واجهة FleetEngineTaskFilterOptions

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

خيارات فلترة المهام في موفِّر معلومات موقع المركبة للتوصيل
completionTimeFrom optional
النوع:  Date optional
الحد الأدنى الحصري لوقت إكمال المهمة تُستخدَم لفلترة المهام التي تم إكمالها بعد الوقت المحدّد.
completionTimeTo optional
النوع:  Date optional
الحدّ الأقصى الحصري لوقت إكمال المهمة يُستخدَم للفلترة حسب المهام التي تم إكمالها قبل الوقت المحدّد.
state optional
النوع:  string optional
حالة المهمة. القيم الصالحة هي OPEN أو CLOSED.

واجهة FleetEngineDeliveryVehicleLocationProviderUpdateEvent

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

عنصر الحدث الذي تم تمريره إلى معالِج الحدث عند بدء الحدث FleetEngineDeliveryVehicleLocationProvider.update
completedVehicleJourneySegments optional
النوع:  Array<VehicleJourneySegment> optional
أجزاء الرحلة التي قطعتها هذه المركبة لا يمكن تعديلها.
deliveryVehicle optional
النوع:  DeliveryVehicle optional
بنية بيانات مركبة التسليم التي تم عرضها في التعديل لا يمكن تعديلها.
tasks optional
النوع:  Array<Task> optional
قائمة المهام التي تُنفذها مركبة التسليم هذه لا يمكن تعديلها.

‫FleetEngineDeliveryFleetLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class

موفِّر موقع أسطول التسليم

يمتدّ هذا الصف إلى PollingLocationProvider.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
المَعلمات: 
تُنشئ هذه السمة مقدّم موقع جديد للمركبات التي يتم تتبُّعها بواسطة Fleet Engine.
deliveryVehicleFilter
النوع:  string optional
الفلتر الذي تم تطبيقه عند جلب مركبات التسليم
locationRestriction
النوع:  LatLngBounds|LatLngBoundsLiteral optional
الحدود التي يتم تتبُّع مركبات التسليم ضمنها في حال عدم ضبط حدود، لن يتم تتبُّع أيّ من مركبات التسليم. لتتبُّع جميع مركبات التسليم بغض النظر عن الموقع الجغرافي، اضبط حدودًا مكافئة لكوكب الأرض بأكمله.
staleLocationThresholdMillis
النوع:  number
هذا الحقل للقراءة فقط. الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
مكتسَبة: isPolling، pollingIntervalMillis
مكتسَبة: addListener
update
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineDeliveryFleetLocationProviderOptions

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

خيارات لمزوّد الموقع الجغرافي لأسطول التسليم
authTokenFetcher
النوع:  AuthTokenFetcher
يوفّر الرموز المميّزة بتنسيق JSON لمصادقة العميل على Fleet Engine.
projectId
النوع:  string
رقم تعريف مشروع المستهلك من Google Cloud Console
deliveryVehicleFilter optional
النوع:  string optional
طلب بحث فلتر لتطبيقه عند جلب مركبات التسليم يتم تمرير هذا الفلتر مباشرةً إلى Fleet Engine.

اطّلِع على ListDeliveryVehiclesRequest.filter للاطّلاع على التنسيقات المتوافقة.

ملاحظة: يجب أن تحتوي الفلاتر الصالحة للسمات على البادئة "attributes". على سبيل المثال، attributes.x = "y" أو attributes."x y" = "z".
deliveryVehicleMarkerCustomization optional
النوع:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
تخصيص تم تطبيقه على علامة مركبة توصيل

استخدِم هذا الحقل لتحديد التصميم المخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات).
  • في حال تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية في حال توفّرها.
  • في حال تحديد وظيفة، يتمّ استدعاؤها مرّة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في عملية الاستدعاء هذه، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true.) بالإضافة إلى ذلك، يتمّ استدعاء هذه الدالة عندما يتلقّى مقدّم الموقع الجغرافي بيانات من Fleet Engine، بغضّ النظر عمّا إذا كانت البيانات المقابلة لهذا العلامة قد تغيّرت.

    اطّلِع على DeliveryVehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.
locationRestriction optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
حدود خطوط الطول/العرض التي يتم تتبُّع المركبات ضمنها مباشرةً بعد إنشاء مثيل لموفّر الموقع الجغرافي في حال عدم ضبطها، لا يبدأ موفِّر الموقع الجغرافي بتتبُّع أي مركبات. استخدِم FleetEngineDeliveryFleetLocationProvider.locationRestriction لضبط الحدود والبدء في التتبُّع. لتتبُّع جميع مركبات التسليم بغض النظر عن الموقع الجغرافي، اضبط حدودًا مكافئة لكوكب الأرض بأكمله.
staleLocationThresholdMillis optional
النوع:  number optional
الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من الصفر أو Infinity، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار موقع المركبة قديمًا.

واجهة FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

عنصر الحدث الذي تم تمريره إلى معالِج الحدث عند بدء الحدث FleetEngineDeliveryFleetLocationProvider.update
deliveryVehicles optional
النوع:  Array<DeliveryVehicle> optional
قائمة المركبات التي تستخدمها شركة التسليم والتي يعرضها طلب البحث لا يمكن تعديلها.