Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider class

google.maps.journeySharing.FleetEngineVehicleLocationProvider صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing").
اطّلِع على المكتبات في Maps JavaScript API.
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 interface

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions interface

خيارات مقدّم خدمة الموقع الجغرافي للمركبة
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 interface

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent interface

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

فئة FleetEngineFleetLocationProvider

google.maps.journeySharing.FleetEngineFleetLocationProvider صف

موفِّر الموقع الجغرافي لمجموعة الأجهزة

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing").
اطّلِع على المكتبات في Maps JavaScript API.
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 interface

خيارات مزوّد خدمة الموقع الجغرافي للأسطول
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 interface

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent interface

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