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

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

الفاصل الزمني التلقائي والأدنى للاستطلاع هو 5,000 ملي ثانية. وفي حال ضبط الفاصل الزمني للاستطلاع على قيمة موجبة أقل، سيتم تخزين واستخدام 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
بنية معلومات تتبُّع المهام التي يعرضها التعديل غير قابل للتعديل.