Shipment Tracking

فئة FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");
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
اختياري
النوع: (function(ShipmentPolylineCustomizationFunctionParams): void)|PolylineOptions optional
التخصيص المطبَّق على الخطوط المتعدّدة النشطة يتوافق الخط المتعدّد النشط مع جزء من المسار الذي تسلكه المركبة حاليًا.

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

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

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

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

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

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

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

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

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

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

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

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

واجهة FleetEngineShipmentLocationProviderUpdateEvent

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

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