Shipment Tracking

فئة FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider class

موفِّر الموقع الجغرافي للشحنة

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

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

واجهة FleetEngineShipmentLocationProviderOptions

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

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

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

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

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

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

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

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

يؤدي ضبط هذه القيمة على 0 أو Infinity أو قيمة سلبية إلى إيقاف التحديثات التلقائية للمواقع الجغرافية. يتم جلب إشعار جديد بشأن الموقع الجغرافي مرة واحدة في حال تغيّر مَعلمة رقم تعريف التتبّع (على سبيل المثال، رقم تعريف تتبُّع الشحنة لموفّر الموقع الجغرافي للشحنة) أو خيار فلترة (على سبيل المثال، حدود مساحة العرض أو فلاتر السمات لموفّري المواقع الجغرافية للأسطول).

الفاصل الزمني التلقائي والحد الأدنى له هو 5000 مللي ثانية. في حال ضبط الفاصل الزمني للاستطلاع على قيمة موجبة أقل، يتم تخزين القيمة 5000 واستخدامها.
remainingPolylineCustomization optional
النوع:  (function(ShipmentPolylineCustomizationFunctionParams): void)|PolylineOptions optional
تم تطبيق التخصيص على الخط المتعدّد المتبقّي. تتوافق الخطوط المتعددة المتبقية مع جزء من المسار لم تبدأ المركبة في العبور منه بعد.

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

    اطّلِع على ShipmentPolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
takenPolylineCustomization optional
النوع:  (function(ShipmentPolylineCustomizationFunctionParams): void)|PolylineOptions optional
التخصيص الذي تم تطبيقه على الخط المتعدد الذي تم إنشاؤه تتوافق الخطوط المتعددة التي تم رصدها مع جزء من المسار الذي سبق أن قطعته المركبة.

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

    اطّلِع على ShipmentPolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
trackingId optional
النوع:  string optional
رقم تعريف التتبّع للمهمة التي سيتم تتبُّعها فور إنشاء مثيل لموفّر الموقع الجغرافي في حال عدم تحديده، لا يبدأ موفِّر الموقع الجغرافي تتبُّع أي مهمة. استخدِم FleetEngineShipmentLocationProvider.trackingId لضبط معرّف التتبُّع وبدء التتبُّع.

واجهة FleetEngineShipmentLocationProviderUpdateEvent

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

عنصر الحدث الذي تم تمريره إلى معالِج الحدث عند بدء الحدث FleetEngineShipmentLocationProvider.update
taskTrackingInfo optional
النوع:  TaskTrackingInfo optional
بنية معلومات تتبُّع المهام التي يعرضها التعديل لا يمكن تعديلها.