Fleet Tracking - On Demand Rides & Delivery (beta)

‫FleetEngineVehicleLocationProvider class

google.maps.journeySharing.FleetEngineVehicleLocationProvider class

موفِّر الموقع الجغرافي للمركبة

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
المَعلمات: 
تُنشئ هذه العملية مقدّم موقع جغرافي جديدًا لمركبة Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
المَعلمات: 
القيمة المعروضة:  لا شيء
دالة تخصيص الخطوط المتعددة التي تُلوّن الخط المتعدد النشط وفقًا لقراءة سرعته حدِّد هذه الدالة على أنّها FleetEngineVehicleLocationProviderOptions.activePolylineCustomization لعرض خط متعدد يراعي حركة المرور للخط المتعدد النشط.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
المَعلمات: 
القيمة المعروضة:  لا شيء
وظيفة تخصيص الخطوط المتعددة التي تُلوّن الخطوط المتعددة المتبقية وفقًا لقراءة سرعتها حدِّد هذه الدالة على أنّها FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization لعرض خط متعدد يراعي حركة المرور للخط المتعدد المتبقّي.
staleLocationThresholdMillis
النوع:  number
هذا الحقل للقراءة فقط. الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
vehicleId
النوع:  string
رقم تعريف المركبة التي يرصدها موفّر الموقع الجغرافي هذا اضبط هذا الحقل لتتبُّع مركبة.
مكتسَبة: isPolling، pollingIntervalMillis
مكتسَبة: addListener
error
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عندما يواجه موفِّر الموقع الجغرافي خطأ
update
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineVehicleLocationProviderOptions

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

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

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

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

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

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

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

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

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

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

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

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

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

    اطّلِع على VehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
staleLocationThresholdMillis optional
النوع:  number optional
الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من 0 أو Infinity، سيتم تجاهل الحدّ الأدنى ولن يُعتبَر موقع المركبة قديمًا.
takenPolylineCustomization optional
النوع:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
التخصيص الذي تم تطبيقه على الخط المتعدد الذي تم إنشاؤه تتوافق الخطوط المتعددة التي تم رصدها مع جزء من المسار الذي سبق أن قطعته المركبة.

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

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

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

    اطّلِع على VehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.

واجهة FleetEngineVehicleLocationProviderUpdateEvent

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

عنصر الحدث الذي تم تمريره إلى معالِج الحدث عند بدء الحدث FleetEngineVehicleLocationProvider.update
trips optional
النوع:  Array<Trip> optional
قائمة الرحلات التي أكملت هذه المركبة لا يمكن تعديلها.
vehicle optional
النوع:  Vehicle optional
بنية بيانات المركبة التي تم عرضها في التحديث لا يمكن تعديلها.

‫FleetEngineFleetLocationProvider class

google.maps.journeySharing.FleetEngineFleetLocationProvider class

موفِّر الموقع الجغرافي للمركبات

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
المَعلمات: 
تُنشئ هذه السمة مقدّم موقع جديد للمركبات التي يتم تتبُّعها بواسطة Fleet Engine.
locationRestriction
النوع:  LatLngBounds|LatLngBoundsLiteral optional
الحدود التي يتم تتبُّع المركبات ضمنها في حال عدم ضبط أي حدود، لن يتم تتبُّع أي مركبات. لتتبُّع جميع المركبات بغض النظر عن الموقع الجغرافي، اضبط حدودًا مكافئة لكوكب الأرض بأكمله.
staleLocationThresholdMillis
النوع:  number
هذا الحقل للقراءة فقط. الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
vehicleFilter
النوع:  string optional
الفلتر الذي تم تطبيقه عند جلب المركبات
مكتسَبة: isPolling، pollingIntervalMillis
مكتسَبة: addListener
update
function(event)
الوسيطات: 
الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

واجهة FleetEngineFleetLocationProviderOptions

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

خيارات مزوّد بيانات الموقع الجغرافي للأسطول
authTokenFetcher
النوع:  AuthTokenFetcher
يوفّر الرموز المميّزة بتنسيق JSON لمصادقة العميل على Fleet Engine.
projectId
النوع:  string
رقم تعريف مشروع المستهلك من Google Cloud Console
locationRestriction optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
حدود خطوط الطول/العرض التي يتم تتبُّع المركبات ضمنها مباشرةً بعد إنشاء مثيل لموفّر الموقع الجغرافي في حال عدم ضبطها، لا يبدأ موفِّر الموقع الجغرافي بتتبُّع أي مركبات. استخدِم FleetEngineFleetLocationProvider.locationRestriction لضبط الحدود والبدء في التتبُّع. لتتبُّع جميع المركبات بغض النظر عن الموقع الجغرافي، اضبط حدودًا مكافئة لكوكب الأرض بأكمله.
staleLocationThresholdMillis optional
النوع:  number optional
الحدّ الأدنى لعمر الموقع الجغرافي للمركبة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من الصفر أو Infinity، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار موقع المركبة قديمًا.
vehicleFilter optional
النوع:  string optional
طلب بحث فلتر لتطبيقه عند جلب المركبات يتم تمرير هذا الفلتر مباشرةً إلى Fleet Engine.

اطّلِع على ListVehiclesRequest.filter للاطّلاع على التنسيقات المتوافقة.

يُرجى العلم أنّ الفلاتر الصالحة للسمات يجب أن تحتوي على البادئة "attributes". على سبيل المثال، attributes.x = "y" أو attributes."x y" = "z".
vehicleMarkerCustomization optional
النوع:  function(VehicleMarkerCustomizationFunctionParams): void optional
تخصيص تم تطبيقه على علامة مركبة

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

    اطّلِع على VehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدّمة واستخداماتها.

واجهة FleetEngineFleetLocationProviderUpdateEvent

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

عنصر الحدث الذي تم تمريره إلى معالِج الحدث عند بدء الحدث FleetEngineFleetLocationProvider.update
vehicles optional
النوع:  Array<Vehicle> optional
قائمة المركبات التي يعرضها طلب البحث لا يمكن تعديلها.