Fleet Tracking - Last Mile Fleet

فئة FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider صف

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

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

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

واجهة FleetEngineDeliveryVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions interface

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

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

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

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

    اطّلِع على DeliveryVehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
plannedStopMarkerCustomization optional
النوع:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
التخصيص الذي تم تطبيقه على علامة محطة توقّف مخطَّط لها

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

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

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

الفاصل الزمني التلقائي للاستطلاع هو 5000 مللي ثانية، وهو الحد الأدنى للفاصل الزمني. إذا ضبطت الفاصل الزمني للاستطلاع على قيمة أقل من الصفر، سيتم استخدام القيمة 5000.
remainingPolylineCustomization optional
التخصيص الذي تم تطبيقه على الخط المتعدد المتبقي يتوافق خط متعدد متبقٍ مع جزء من المسار لم تبدأ المركبة في التنقّل فيه بعد.

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

    راجِع DeliveryVehiclePolylineCustomizationFunctionParams للاطّلاع على قائمة بالمعلمات المقدَّمة واستخداماتها.
shouldShowOutcomeLocations optional
النوع:  boolean optional
قيمة منطقية لعرض مواقع النتائج أو إخفائها للمهام التي تم استرجاعها
shouldShowTasks optional
النوع:  boolean optional
قيمة منطقية لإظهار المهام أو إخفائها. سيؤدي ضبط هذا الخيار على "خطأ" إلى منع استدعاء نقطة نهاية ListTasks لجلب المهام. سيتم عرض محطات توقّف المركبة القادمة فقط.
staleLocationThresholdMillis optional
النوع:  number optional
الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملّي ثانية. إذا كان الحدّ الأدنى أقل من 0 أو Infinity، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
takenPolylineCustomization optional
التخصيص الذي تم تطبيقه على الخط المتعدد الذي تم التقاطه يتوافق الخط المتعدد الذي تمّت إضافته مع جزء من المسار الذي سبق أن سلكته المركبة.

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

    راجِع DeliveryVehiclePolylineCustomizationFunctionParams للاطّلاع على قائمة بالمعلمات المقدَّمة واستخداماتها.
taskFilterOptions optional
النوع:  FleetEngineTaskFilterOptions optional
خيارات الفلترة التي يجب تطبيقها عند استرداد المهام يمكن أن تتضمّن الخيارات مركبة معيّنة ووقتًا وحالة المهمة.
taskMarkerCustomization optional
النوع:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
التخصيص المطبَّق على علامة مهمة يتم عرض علامة مهمة في الموقع الجغرافي المخطط لكل مهمة تم تعيينها لمركبة التوصيل.

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

    اطّلِع على TaskMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
taskOutcomeMarkerCustomization optional
النوع:  function(TaskMarkerCustomizationFunctionParams): void optional
التخصيص الذي تم تطبيقه على علامة نتيجة مهمة يتم عرض علامة نتيجة المهمة في الموقع الجغرافي الفعلي لنتيجة كل مهمة تم تعيينها لمركبة التوصيل.

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

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

واجهة FleetEngineTaskFilterOptions

google.maps.journeySharing.FleetEngineTaskFilterOptions interface

خيارات الفلترة للمهام في "موفّر بيانات الموقع الجغرافي لمركبة التوصيل"
completionTimeFrom optional
النوع:  Date optional
الحد الأدنى الحصري لوقت إكمال المهمة. يُستخدَم لفلترة المهام التي تم إكمالها بعد الوقت المحدّد.
completionTimeTo optional
النوع:  Date optional
الحدّ الأعلى الحصري لوقت إكمال المهمة. يُستخدَم لفلترة المهام التي تم إكمالها قبل الوقت المحدّد.
state optional
النوع:  string optional
تمثّل هذه السمة حالة المهمة. القيم الصالحة هي OPEN أو CLOSED.

واجهة FleetEngineDeliveryVehicleLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent interface

كائن الحدث الذي يتم تمريره إلى معالج الحدث عند بدء الحدث FleetEngineDeliveryVehicleLocationProvider.update.
completedVehicleJourneySegments optional
النوع:  Array<VehicleJourneySegment> optional
شرائح الرحلة التي أكملتها هذه المركبة غير قابلة للتعديل
deliveryVehicle optional
النوع:  DeliveryVehicle optional
بنية بيانات مركبة التوصيل التي تم عرضها بعد التعديل غير قابلة للتعديل
tasks optional
النوع:  Array<Task> optional
قائمة المهام التي تنفّذها مركبة التوصيل هذه غير قابلة للتعديل

فئة FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider صف

مقدّم خدمة الموقع الجغرافي لأسطول التسليم

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

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

FleetEngineDeliveryFleetLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions interface

خيارات لمزوّد خدمة تحديد الموقع الجغرافي لأسطول التوصيل
authTokenFetcher
النوع:  AuthTokenFetcher
توفّر رموز JSON المميزة للويب لمصادقة العميل على Fleet Engine.
projectId
النوع:  string
معرّف مشروع المستهلك من Google Cloud Console
deliveryVehicleFilter optional
النوع:  string optional
طلب بحث فلتر يتم تطبيقه عند استرداد مركبات التوصيل. يتم تمرير هذا الفلتر مباشرةً إلى Fleet Engine.

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

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

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

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

FleetEngineDeliveryFleetLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent interface

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