Shipment Tracking

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة FleetEngineShipmentLocationProvider

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

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

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

تحميل باستخدام معلمة عنوان URL &libraries=journeySharing. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {FleetEngineShipmentLocationProvider} = await google.map.importLibrary("journeySharing"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
المعلّمات: 
إنشاء موفر موقع جديد لتتبع شحنة Fleet Engine.
trackingId
النوع:  string
رقم تعريف التتبّع للمهمة التي يلتزم بها مزوّد الموقع الجغرافي هذا. تعيين هذا الحقل لبدء التتبع.
موروثة: isPolling
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
بنية معلومات تتبع المهام التي يعرضها التحديث. غير قابلة للتعديل.