Shipment Tracking

فئة FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing").
اطّلِع على المكتبات في Maps JavaScript API.
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 interface

خيارات مقدّم خدمة تحديد موقع الشحنة
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 interface

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent interface

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