Fleet Tracking - On Demand Rides & Delivery (beta)

فئة Fleet EngineModelLocationProvider

صف واحد (google.maps.journeySharing.FleetEngineVehicleLocationProvider)

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

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

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

واجهة Fleet EngineModelLocationProviderOptions

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

الخيارات المتاحة لمزوّد الموقع الجغرافي للمركبة
authTokenFetcher
النوع:  AuthTokenFetcher
يوفر رموزًا مميّزة للويب بتنسيق JSON لمصادقة العميل على Fleet Engine.
projectId
النوع:  string
رقم تعريف مشروع المستهلك من Google Cloud Console.
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 ملي ثانية، وهو الحد الأدنى للفاصل الزمني. وفي حال ضبط الفاصل الزمني للاستطلاعات على قيمة أقل من الصفر، يتم استخدام 5, 000.
staleLocationThresholdMillis optional
النوع:  number optional
حدّ الموقع الجغرافي للمركبة القديمة إذا كان آخر موقع جغرافي معدَّل للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. الإعداد التلقائي إلى 24 ساعة بالمللي ثانية. إذا كان الحدّ الأدنى أقلّ من 0 أو لانهاية، سيتمّ تجاهل الحدّ الأدنى ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
vehicleId optional
النوع:  string optional
رقم تعريف المركبة الذي تريد تتبُّعه بعد إنشاء مثيل موفِّر الموقع الجغرافي مباشرةً. إذا لم يكن محددًا، لا يبدأ موفّر الموقع الجغرافي في تتبّع أي مركبة. استخدِم FleetEngineVehicleLocationProvider.vehicleId لضبط رقم التعريف وبدء التتبّع.
vehicleMarkerCustomization optional
النوع:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
تم تطبيق التخصيص على علامة المركبة.

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

    يُرجى الاطّلاع على VehicleMarkerCustomizationFunctionParams لقائمة من المعلّمات المقدّمة واستخداماتها.

واجهة Fleet EngineModelLocationProviderUpdateEvent

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

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

فئة Fleet EngineFleetLocationProvider

صف واحد (google.maps.journeySharing.FleetEngineFleetLocationProvider)

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

يمتد هذا الصف 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

واجهة Fleet EngineFleetLocationProviderOptions

واجهة 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.

اطّلِع على السمة ListمركباتsRequest.filter لمعرفة التنسيقات المتوافقة.

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

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

    يُرجى الاطّلاع على VehicleMarkerCustomizationFunctionParams لقائمة من المعلّمات المقدّمة واستخداماتها.

واجهة Fleet EngineFleetLocationProviderUpdateEvent

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

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