Shipment Tracking

فئة FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider الصف الدراسي

مزوِّد مواقع الشحن

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

الوصول من خلال الاتصال بـ 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.
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 أو بلا نهاية أو قيمة سلبية إلى إيقاف التحديثات التلقائية للمواقع الجغرافية. ويتم جلب تحديث موقع جديد مرة واحدة في حالة تغيير معلمة رقم تعريف التتبع (على سبيل المثال، الرقم التعريفي لتتبع الشحن التابع لموفر موقع الشحن)، أو خيار التصفية (على سبيل المثال، حدود إطار العرض أو فلاتر السمات لموفري مواقع مجموعة المركبات).

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

واجهة FleetEngineShipmentLocationProviderUpdateEvent

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

يتم تمرير كائن الحدث إلى معالج الحدث عند تشغيل الحدث FleetEngineShipmentLocationProvider.update.
taskTrackingInfo optional
النوع:  TaskTrackingInfo optional
بنية معلومات تتبع المهام التي يعرضها التحديث. غير قابلة للتعديل.