Trip and Order Progress

فئة FleetEngineTripLocationProvider

class google.maps.journeySharing.FleetEngineTripLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

مقدّم خدمة الموقع الجغرافي للرحلة

const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing");
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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    يمكنك الاطّلاع على TripWaypointMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.

واجهة FleetEngineTripLocationProviderUpdateEvent

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

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