Fleet Tracking - On Demand Rides & Delivery (beta)

الفئة FleetEngineVehicleLocationProvider

صف واحد (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

واجهة 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" إلى إيقاف التحديثات المتكرّرة للموقع الجغرافي. يتم استرجاع تعديل موقع جغرافي جديد في حال تغيير أي من المعلمات التي لاحظها موفِّر الموقع الجغرافي.

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

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

    يُرجى الاطّلاع على VehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمعلَمات التي تم توفيرها واستخداماتها.
staleLocationThresholdMillis optional
النوع:  number optional
حد موقع مركبة قديم إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. ضبط الإعداد التلقائي على 24 ساعة بالمللي ثانية. إذا كان الحدّ أقل من 0 أو العدد اللانهائي، سيتم تجاهل الحدّ ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
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

صف واحد (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

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

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

يُرجى العِلم أنّ الفلاتر الصالحة للسمات يجب أن تحتوي على البادئة "السمات". على سبيل المثال، 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
تمثّل هذه السمة قائمة المركبات التي يعرضها الاستعلام. غير قابل للتعديل.