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.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
المَعلمات: 
القيمة المعروضة:  لا شيء
دالة تخصيص الخطوط المتعددة التي تلوّن الخط المتعدد النشط وفقًا لقراءة السرعة حدِّد هذه الدالة على أنّها FleetEngineTripLocationProviderOptions.activePolylineCustomization لعرض خط متعدد الأضلاع يراعي حركة المرور للخط المتعدد الأضلاع النشط.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
المَعلمات: 
القيمة المعروضة:  لا شيء
دالة تخصيص الخطوط المتعددة التي تلوّن الخطوط المتعددة المتبقية وفقًا لقراءة السرعة حدِّد هذه الدالة كـ FleetEngineTripLocationProviderOptions.remainingPolylineCustomization لعرض خط متعدد الأضلاع يراعي حركة المرور للخطوط المتعددة الأضلاع المتبقية.
tripId
النوع:  string
معرّف الرحلة التي يراقبها موفّر بيانات الموقع الجغرافي هذا. اضبط هذا الحقل لبدء التتبُّع.
موروثة: isPolling, pollingIntervalMillis
refresh
refresh()
المَعلمات:  بدون
قيمة العائد:  void
تعمل هذه الطريقة على إعادة تحميل الموقع الجغرافي الذي يتم تتبّعه بشكل صريح.
موروثة: addListener
error
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عندما يواجه موفّر الموقع الجغرافي خطأً.
update
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine.
موروثة: ispollingchange

واجهة FleetEngineTripLocationProviderOptions

google.maps.journeySharing.FleetEngineTripLocationProviderOptions interface

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

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

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

الفاصل الزمني التلقائي للاستطلاع هو 5000 مللي ثانية، وهو الحد الأدنى للفاصل الزمني. إذا ضبطت الفاصل الزمني للاستطلاع على قيمة أقل من الصفر، سيتم استخدام القيمة 5000.
remainingPolylineCustomization optional
النوع:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
التخصيص الذي تم تطبيقه على الخط المتعدد المتبقي يتوافق خط متعدد متبقٍ مع جزء من المسار لم تبدأ المركبة في التنقّل فيه بعد.

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

    راجِع TripPolylineCustomizationFunctionParams للاطّلاع على قائمة بالمعلمات المقدَّمة واستخداماتها.
takenPolylineCustomization optional
النوع:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
التخصيص الذي تم تطبيقه على الخط المتعدد الذي تم التقاطه يتوافق الخط المتعدد الذي تمّت إضافته مع جزء من المسار الذي سبق أن سلكته المركبة.

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

    راجِع TripPolylineCustomizationFunctionParams للاطّلاع على قائمة بالمعلمات المقدَّمة واستخداماتها.
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 interface

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