Trip and Order Progress

‫FleetEngineTripLocationProvider class

google.maps.journeySharing.FleetEngineTripLocationProvider class

موفِّر موقع الرحلة

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
FleetEngineTripLocationProvider	FleetEngineTripLocationProvider(options) المَعلمات:  options:  FleetEngineTripLocationProviderOptions خيارات لمقدّم الموقع الجغرافي تُنشئ هذه الرسالة مورّد موقع جديد لرحلة في Fleet Engine.

الطرق الثابتة
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params) المَعلمات:  params:  TripPolylineCustomizationFunctionParams المَعلمات المقدَّمة لدالة تخصيص الخطوط المتعددة. القيمة المعروضة:  لا شيء دالة تخصيص الخطوط المتعددة التي تُلوّن الخط المتعدد النشط وفقًا لقراءة سرعته حدِّد هذه الدالة على أنّها FleetEngineTripLocationProviderOptions.activePolylineCustomization لعرض خط متعدد يراعي حركة المرور للخط المتعدد النشط.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params) المَعلمات:  params:  TripPolylineCustomizationFunctionParams المَعلمات المقدَّمة لدالة تخصيص الخطوط المتعددة. القيمة المعروضة:  لا شيء وظيفة تخصيص الخطوط المتعددة التي تُلوّن الخطوط المتعددة المتبقية وفقًا لقراءة سرعتها حدِّد هذه الدالة على أنّها FleetEngineTripLocationProviderOptions.remainingPolylineCustomization لعرض خط متعدد يراعي حركة المرور للخط المتعدد المتبقّي.

الخصائص
tripId	النوع:  string معرّف الرحلة التي يرصدها موفّر الموقع الجغرافي هذا. اضبط هذا الحقل لبدء التتبّع.
مكتسَبة: isPolling، pollingIntervalMillis

الطُرق
refresh	refresh() المَعلمات:  بدون القيمة المعروضة:  void تُعيد تحميل الموقع الجغرافي الذي يتم تتبُّعه صراحةً.
مكتسَبة: addListener

الفعاليات
error	function(event) الوسيطات:  event:  ErrorEvent الحدث الذي يتم تشغيله عندما يواجه موفِّر الموقع الجغرافي خطأ
update	function(event) الوسيطات:  event:  FleetEngineTripLocationProviderUpdateEvent الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineTripLocationProviderOptions

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

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

الخصائص
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 واجهة

عنصر الحدث الذي تم تمريره إلى معالِج الحدث عند بدء الحدث FleetEngineTripLocationProvider.update

الخصائص
trip optional	النوع:  Trip optional بنية الرحلة التي يعرضها التعديل لا يمكن تعديلها.