Trip and Order Progress

الفئة FleetEngineTripLocationProvider

صف واحد (google.maps.journeySharing.FleetEngineTripLocationProvider)

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

تمتد هذه الفئة إلى PollingLocationProvider.

يمكنك الوصول من خلال الاتصال على الرقم const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
المَعلمات: 
إنشاء موفِّر مواقع جغرافي جديد لرحلة إلى Fleet Engine.
tripId
النوع:  string
رقم تعريف الرحلة التي يلاحظها مقدِّم خدمة الموقع الجغرافي هذا. اضبط هذا الحقل لبدء التتبّع.
مُكتسَب: isPolling، pollingIntervalMillis
refresh
refresh()
المَعلمات: لا شيء
قيمة الإرجاع:  void
إعادة تحميل الموقع الذي يتم تتبّعه بوضوح
مُكتسَب: addListener
error
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عندما يواجه موفِّر الموقع الجغرافي خطأً.
update
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عندما ينتهي طلب تعديل بيانات Fleet Engine.
مُكتسَب: ispollingchange

واجهة FleetEngineTripLocationProviderOptions

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

خيارات موفّر خدمة الموقع الجغرافي للرحلة
authTokenFetcher
النوع:  AuthTokenFetcher
توفر رموز JSON للويب المميزة لمصادقة العميل مع Fleet Engine.
projectId
النوع:  string
رقم تعريف مشروع المستهلك من Google Cloud Console
destinationMarkerCustomization optional
النوع:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
تم تطبيق التخصيص على علامة الوجهة.

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

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

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

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

يؤدي ضبط هذه القيمة على "0" إلى إيقاف التحديثات المتكرّرة للموقع الجغرافي. يتم استرجاع تعديل موقع جغرافي جديد في حال تغيير أي من المعلمات التي لاحظها موفِّر الموقع الجغرافي.

الفاصل الزمني التلقائي للاستطلاع هو 5, 000 ملي ثانية، وهو الحد الأدنى للفاصل الزمني. وفي حال ضبط الفاصل الزمني للاستطلاع على قيمة أقل غير صفرية، سيتم استخدام 5000.
tripId optional
النوع:  string optional
رقم تعريف الرحلة المطلوب تتبُّعه على الفور بعد إنشاء مثيل لمقدِّم الموقع الجغرافي. إذا لم يتم تحديد ذلك، لن يبدأ موفِّر الموقع الجغرافي في تتبُّع أي رحلة. استخدِم FleetEngineTripLocationProvider.tripId لضبط رقم التعريف وبدء التتبُّع.
vehicleMarkerCustomization optional
النوع:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
تم تطبيق التخصيص على علامة المركبة.

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

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

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

    راجع TripWaypointMarkerCustomizationFunctionParams للحصول على قائمة بالمعلَمات المقدّمة واستخداماتها.

واجهة FleetEngineTripLocationProviderUpdateEvent

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

عنصر الحدث الذي يتم تمريره إلى معالِج الأحداث عند بدء حدث "FleetEngineTripLocationProvider.update".
trip optional
النوع:  Trip optional
هيكل الرحلة الذي يعرضه التحديث. غير قابل للتعديل.