Trip and Order Progress

فئة FleetEngineTripLocationProvider

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

مزوِّد مواقع الرحلات.

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

الوصول من خلال الاتصال بـ const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
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 مللي ثانية، وهو الحد الأدنى للفاصل الزمني. وفي حال ضبط الفاصل الزمني للاستقصاء على قيمة أقل من الصفر، يتم استخدام 5, 000.
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
بنية الرحلة الناتجة عن التعديل غير قابلة للتعديل.