Fleet Tracking - Last Mile Fleet

فئة FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

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

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

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

الشركة المصنِّعة
FleetEngineDeliveryVehicleLocationProvider	FleetEngineDeliveryVehicleLocationProvider(options) المَعلمات:  options:  FleetEngineDeliveryVehicleLocationProviderOptions خيارات لإرسالها إلى مقدّم الموقع الجغرافي تُنشئ هذه الرسالة عنصرًا جديدًا لمقدّم الموقع الجغرافي لمركبة تسليم في Fleet Engine.

الخصائص
deliveryVehicleId	النوع:  string رقم تعريف المركبة التي يرصدها موفّر الموقع الجغرافي هذا اضبط هذا الحقل لتتبُّع مركبة.
shouldShowOutcomeLocations	النوع:  boolean optional السماح للمستخدمين بعرض الموقع الجغرافي لنتيجة المهمة اختياريًا
shouldShowTasks	النوع:  boolean optional السماح للمستخدمين بعرض المهام التي تم استرجاعها اختياريًا
staleLocationThresholdMillis	النوع:  number هذا الحقل للقراءة فقط. الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
taskFilterOptions	النوع:  FleetEngineTaskFilterOptions عرض خيارات الفلترة التي سيتم تطبيقها عند جلب المهام
مكتسَبة: isPolling، pollingIntervalMillis

الطُرق
مكتسَبة: addListener

الفعاليات
error	function(event) الوسيطات:  event:  ErrorEvent الحدث الذي يتم تشغيله عندما يواجه موفِّر الموقع الجغرافي خطأ
update	function(event) الوسيطات:  event:  FleetEngineDeliveryVehicleLocationProviderUpdateEvent الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineDeliveryVehicleLocationProviderOptions

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

خيارات لمزوّد الموقع الجغرافي لمركبة التسليم

الخصائص
authTokenFetcher	النوع:  AuthTokenFetcher يوفّر الرموز المميّزة بتنسيق JSON لمصادقة العميل على Fleet Engine.
projectId	النوع:  string رقم تعريف مشروع المستهلك من Google Cloud Console
activePolylineCustomization optional	النوع:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions 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	النوع:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions 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	النوع:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions 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) المَعلمات:  options:  FleetEngineDeliveryFleetLocationProviderOptions خيارات لإرسالها إلى مقدّم الموقع الجغرافي تُنشئ هذه السمة مقدّم موقع جديد للمركبات التي يتم تتبُّعها بواسطة Fleet Engine.

الخصائص
deliveryVehicleFilter	النوع:  string optional الفلتر الذي تم تطبيقه عند جلب مركبات التسليم
locationRestriction	النوع:  LatLngBounds|LatLngBoundsLiteral optional الحدود التي يتم تتبُّع مركبات التسليم ضمنها في حال عدم ضبط حدود، لن يتم تتبُّع أيّ من مركبات التسليم. لتتبُّع جميع مركبات التسليم بغض النظر عن الموقع الجغرافي، اضبط حدودًا مكافئة لكوكب الأرض بأكمله.
staleLocationThresholdMillis	النوع:  number هذا الحقل للقراءة فقط. الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
مكتسَبة: isPolling، pollingIntervalMillis

الطُرق
مكتسَبة: addListener

الفعاليات
update	function(event) الوسيطات:  event:  FleetEngineDeliveryFleetLocationProviderUpdateEvent الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات 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 قائمة المركبات التي تستخدمها شركة التسليم والتي يعرضها طلب البحث لا يمكن تعديلها.