Fleet Tracking - On Demand Rides & Delivery

فئة FleetEngineVehicleLocationProvider

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

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

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");

الشركة المصنِّعة
FleetEngineVehicleLocationProvider	FleetEngineVehicleLocationProvider(options) المَعلمات: options: FleetEngineVehicleLocationProviderOptions الخيارات التي يتم تمريرها إلى موفّر الموقع الجغرافي تنشئ هذه الطريقة مقدّم خدمة موقع جغرافي جديد لمركبة في Fleet Engine.

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

الخصائص
staleLocationThresholdMillis	النوع: number هذا الحقل متاح للقراءة فقط. الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
vehicleId	النوع: string رقم تعريف المركبة التي يراقبها مقدّم خدمة الموقع الجغرافي هذا اضبط هذا الحقل لتتبُّع مركبة.
السمات المكتسَبة: isPolling، pollingIntervalMillis

الطُرق
مكتسَبة: addListener

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

FleetEngineVehicleLocationProviderOptions interface

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

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

الخصائص
authTokenFetcher	النوع: AuthTokenFetcher يوفّر رموز JSON المميّزة للويب لمصادقة العميل في Fleet Engine.
projectId	النوع: string رقم تعريف مشروع المستهلك من Google Cloud Console
activePolylineCustomization اختياري	النوع: (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional التخصيص المطبَّق على الخطوط المتعدّدة النشطة يتوافق الخط المتعدّد النشط مع جزء من المسار الذي تسلكه المركبة حاليًا. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعدّدة) والتفاعل (مثل معالجة النقرات). في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخطوط المتعدّدة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية إذا كانت موجودة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخطوط المتعدّدة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في كائن مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعدّدة أو عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه الخطوط المتعدّدة قد تغيّرت. يُرجى الاطّلاع على VehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
destinationMarkerCustomization اختياري	النوع: (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على علامة وجهة رحلة المركبة استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على VehicleWaypointMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
intermediateDestinationMarkerCustomization اختياري	النوع: (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على علامات الوجهات الوسيطة لرحلة المركبة استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على VehicleWaypointMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
originMarkerCustomization اختياري	النوع: (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على محدّد نقطة انطلاق رحلة المركبة استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على VehicleWaypointMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
pollingIntervalMillis اختياري	النوع: number optional الحد الأدنى للوقت بين جلب إشعارات بشأن الموقع الجغرافي بالمللي ثانية إذا استغرق جلب إشعار بشأن الموقع الجغرافي أكثر من pollingIntervalMillis، لن يبدأ الإشعار التالي بشأن الموقع الجغرافي إلا بعد انتهاء الإشعار الحالي. يؤدي ضبط هذه القيمة على 0 إلى إيقاف الإشعارات المتكرّرة بشأن الموقع الجغرافي. يتم جلب إشعار جديد بشأن الموقع الجغرافي في حال تغيّرت أي من المَعلمات التي يراقبها موفّر الموقع الجغرافي. الفاصل الزمني التلقائي للاستطلاع هو 5000 مللي ثانية، وهو الحد الأدنى للفاصل الزمني. إذا ضبطت الفاصل الزمني للاقتراع على قيمة أقل من الصفر، يتم استخدام 5000.
remainingPolylineCustomization اختياري	النوع: (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional تم تطبيق التخصيص على الخطوط المتعدّدة المتبقية. يتوافق الخط المتعدّد المتبقي مع جزء من المسار الذي لم تبدأ المركبة في عبوره بعد. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعدّدة) والتفاعل (مثل معالجة النقرات). في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخطوط المتعدّدة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية إذا كانت موجودة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخطوط المتعدّدة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في كائن مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعدّدة أو عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه الخطوط المتعدّدة قد تغيّرت. يُرجى الاطّلاع على VehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
staleLocationThresholdMillis اختياري	النوع: number optional الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من 0 أو ما لا نهاية، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
takenPolylineCustomization اختياري	النوع: (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional التخصيص المطبَّق على الخطوط المتعددة التي تم استخدامها يتوافق الخط المتعدّد الذي تم اتّباعه مع جزء من المسار الذي سبق أن سلكته المركبة. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعدّدة) والتفاعل (مثل معالجة النقرات). في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخطوط المتعدّدة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية إذا كانت موجودة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخطوط المتعدّدة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في كائن مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعدّدة أو عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه الخطوط المتعدّدة قد تغيّرت. يُرجى الاطّلاع على VehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
vehicleId اختياري	النوع: string optional رقم تعريف المركبة المطلوب تتبُّعها فور إنشاء مثيل لموفّر الموقع الجغرافي في حال عدم تحديد هذه السمة، لن يبدأ مقدّم خدمة الموقع الجغرافي في تتبُّع أي مركبة. استخدِم FleetEngineVehicleLocationProvider.vehicleId لضبط رقم التعريف وبدء التتبُّع.
vehicleMarkerCustomization اختياري	النوع: (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على علامة المركبة استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على VehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.

واجهة FleetEngineVehicleLocationProviderUpdateEvent

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

كائن الحدث الذي تم تمريره إلى معالج الحدث عند بدء الحدث FleetEngineVehicleLocationProvider.update.

الخصائص
trips اختياري	النوع: Array<Trip> optional قائمة الرحلات التي أكملتها هذه المركبة لا يمكن تعديلها.
vehicle اختياري	النوع: Vehicle optional بنية بيانات المركبة التي تم عرضها من خلال التعديل لا يمكن تعديلها.

فئة FleetEngineFleetLocationProvider

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

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

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");

الشركة المصنِّعة
FleetEngineFleetLocationProvider	FleetEngineFleetLocationProvider(options) المَعلمات: options: FleetEngineFleetLocationProviderOptions الخيارات التي يتم تمريرها إلى موفّر الموقع الجغرافي تنشئ هذه الطريقة مقدّم خدمة موقع جغرافي جديد للمركبات التي يتتبّعها Fleet Engine.

الخصائص
locationRestriction	النوع: LatLngBounds|LatLngBoundsLiteral optional الحدود التي يتم تتبُّع المركبات ضمنها في حال عدم ضبط أي حدود، لن يتم تتبُّع أي مركبات. لتتبُّع جميع المركبات بغض النظر عن موقعها الجغرافي، اضبط حدودًا تعادل الكرة الأرضية بأكملها.
staleLocationThresholdMillis	النوع: number هذا الحقل متاح للقراءة فقط. الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
vehicleFilter	النوع: string optional الفلتر الذي تم تطبيقه عند جلب المركبات
السمات المكتسَبة: isPolling، pollingIntervalMillis

الطُرق
مكتسَبة: addListener

الفعاليات
update	function(event) الوسيطات: event: FleetEngineFleetLocationProviderUpdateEvent الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineFleetLocationProviderOptions

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

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

الخصائص
authTokenFetcher	النوع: AuthTokenFetcher يوفّر رموز JSON المميّزة للويب لمصادقة العميل في Fleet Engine.
projectId	النوع: string رقم تعريف مشروع المستهلك من Google Cloud Console
locationRestriction اختياري	النوع: LatLngBounds|LatLngBoundsLiteral optional حدود خطوط العرض/الطول التي يتم تتبُّع المركبات ضمنها فور إنشاء مثيل لموفّر الموقع الجغرافي. في حال عدم ضبطه، لن يبدأ موفّر الموقع الجغرافي في تتبُّع أي مركبات. استخدِم FleetEngineFleetLocationProvider.locationRestriction لضبط الحدود وبدء التتبُّع. لتتبُّع جميع المركبات بغض النظر عن موقعها الجغرافي، اضبط حدودًا تعادل الكرة الأرضية بأكملها.
staleLocationThresholdMillis اختياري	النوع: number optional الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من صفر أو ما لا نهاية، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
vehicleFilter اختياري	النوع: string optional طلب فلترة يتم تطبيقه عند جلب المركبات يتم تمرير هذا الفلتر مباشرةً إلى Fleet Engine. اطّلِع على ListVehiclesRequest.filter لمعرفة التنسيقات المتاحة. يُرجى العِلم أنّ الفلاتر الصالحة للسمات يجب أن تتضمّن البادئة "attributes". على سبيل المثال، attributes.x = "y" أو attributes."x y" = "z".
vehicleMarkerCustomization اختياري	النوع: function(VehicleMarkerCustomizationFunctionParams): void optional التخصيص المطبَّق على علامة المركبة استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على VehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.

واجهة FleetEngineFleetLocationProviderUpdateEvent

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

كائن الحدث الذي تم تمريره إلى معالج الحدث عند بدء الحدث FleetEngineFleetLocationProvider.update.

الخصائص
vehicles اختياري	النوع: Array<Vehicle> optional قائمة المركبات التي يعرضها طلب البحث لا يمكن تعديلها.