Fleet Tracking - Last Mile Fleet

فئة FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");

الشركة المصنِّعة
FleetEngineDeliveryVehicleLocationProvider	FleetEngineDeliveryVehicleLocationProvider(options) المَعلمات: ‫options: FleetEngineDeliveryVehicleLocationProviderOptions الخيارات التي يتم تمريرها إلى موفّر الموقع الجغرافي تنشئ هذه الطريقة مقدّم خدمة موقع جغرافي جديد لمركبة توصيل في Fleet Engine.

الخصائص
deliveryVehicleId	النوع: string رقم تعريف المركبة التي يراقبها مقدّم خدمة الموقع الجغرافي هذا اضبط هذا الحقل لتتبُّع مركبة.
shouldShowOutcomeLocations	النوع: boolean optional يمكنك السماح للمستخدمين بعرض الموقع الجغرافي لنتيجة المهمة.
shouldShowTasks	النوع: boolean optional يمكنك السماح للمستخدمين بعرض المهام التي تم جلبها.
staleLocationThresholdMillis	النوع: number هذا الحقل متاح للقراءة فقط. الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة.
taskFilterOptions	النوع: FleetEngineTaskFilterOptions تعرض هذه الدالة خيارات الفلترة التي يجب تطبيقها عند جلب المهام.
السمات المكتسَبة: isPolling، pollingIntervalMillis

الطُرق
مكتسَبة: addListener

الفعاليات
error	function(event) الوسيطات: event: ErrorEvent الحدث الذي يتم تشغيله عندما يواجه موفّر الموقع الجغرافي خطأً.
update	function(event) الوسيطات: event: FleetEngineDeliveryVehicleLocationProviderUpdateEvent الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

FleetEngineDeliveryVehicleLocationProviderOptions interface

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

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

الخصائص
authTokenFetcher	النوع: AuthTokenFetcher يوفّر رموز JSON المميّزة للويب لمصادقة العميل في Fleet Engine.
projectId	النوع: string رقم تعريف مشروع المستهلك من Google Cloud Console
activePolylineCustomization اختياري	النوع: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional التخصيص المطبَّق على الخطوط المتعدّدة النشطة يتوافق الخط المتعدّد النشط مع جزء من المسار الذي تسلكه المركبة حاليًا. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعدّدة) والتفاعل (مثل معالجة النقرات). في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخطوط المتعدّدة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية إذا كانت موجودة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخطوط المتعدّدة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في كائن مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعدّدة أو عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه الخطوط المتعدّدة قد تغيّرت. يُرجى الاطّلاع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
deliveryVehicleId اختياري	النوع: string optional رقم تعريف مركبة التوصيل المطلوب تتبُّعها فورًا بعد إنشاء مثيل لمقدّم خدمة الموقع الجغرافي في حال عدم تحديد هذه السمة، لن يبدأ مقدّم خدمة الموقع الجغرافي في تتبُّع أي مركبة. استخدِم FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId لضبط رقم التعريف وبدء التتبُّع.
deliveryVehicleMarkerCustomization اختياري	النوع: (function(DeliveryVehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على محدّد مركبة التسليم استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على DeliveryVehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
plannedStopMarkerCustomization اختياري	النوع: (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على علامة محطة مخطَّط لها استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على PlannedStopMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
pollingIntervalMillis اختياري	النوع: number optional الحد الأدنى للوقت بين جلب إشعارات بشأن الموقع الجغرافي بالمللي ثانية إذا استغرق جلب إشعار بشأن الموقع الجغرافي أكثر من pollingIntervalMillis، لن يبدأ الإشعار التالي بشأن الموقع الجغرافي إلا بعد انتهاء الإشعار الحالي. يؤدي ضبط هذه القيمة على 0 إلى إيقاف الإشعارات المتكرّرة بشأن الموقع الجغرافي. يتم جلب إشعار جديد بشأن الموقع الجغرافي في حال تغيّرت أي من المَعلمات التي يراقبها موفّر الموقع الجغرافي. الفاصل الزمني التلقائي للاستطلاع هو 5000 مللي ثانية، وهو الحد الأدنى للفاصل الزمني. إذا ضبطت الفاصل الزمني للاقتراع على قيمة أقل من الصفر، يتم استخدام 5000.
remainingPolylineCustomization اختياري	النوع: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional تم تطبيق التخصيص على الخطوط المتعدّدة المتبقية. يتوافق الخط المتعدّد المتبقي مع جزء من المسار الذي لم تبدأ المركبة في عبوره بعد. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعدّدة) والتفاعل (مثل معالجة النقرات). في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخطوط المتعدّدة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية إذا كانت موجودة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخطوط المتعدّدة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في كائن مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعدّدة أو عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه الخطوط المتعدّدة قد تغيّرت. يُرجى الاطّلاع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
shouldShowOutcomeLocations اختياري	النوع: boolean optional قيمة منطقية لإظهار أو إخفاء المواقع الجغرافية للنتائج الخاصة بالمهام التي تم جلبها
shouldShowTasks اختياري	النوع: boolean optional قيمة منطقية لإظهار المهام أو إخفائها سيؤدي ضبط هذا الخيار على "خطأ" إلى منع استدعاء نقطة نهاية ListTasks لجلب المهام. سيتم عرض محطات توقّف المركبة القادمة فقط.
staleLocationThresholdMillis اختياري	النوع: number optional الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من 0 أو ما لا نهاية، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
takenPolylineCustomization اختياري	النوع: (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional التخصيص المطبَّق على الخطوط المتعددة التي تم استخدامها يتوافق الخط المتعدّد الذي تم اتّباعه مع جزء من المسار الذي سبق أن سلكته المركبة. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعدّدة) والتفاعل (مثل معالجة النقرات). في حال تحديد عنصر PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخطوط المتعدّدة بعد إنشائها، ما يؤدي إلى استبدال خياراتها التلقائية إذا كانت موجودة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخطوط المتعدّدة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في كائن مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعدّدة أو عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه الخطوط المتعدّدة قد تغيّرت. يُرجى الاطّلاع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
taskFilterOptions اختياري	النوع: FleetEngineTaskFilterOptions optional خيارات الفلترة التي يجب تطبيقها عند جلب المهام يمكن أن تشمل الخيارات مركبة معيّنة ووقتًا وحالة مهمة.
taskMarkerCustomization اختياري	النوع: (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional التخصيص المطبَّق على علامة مهمة يتم عرض علامة مهمة في الموقع المخطّط لكل مهمة تم إسنادها إلى مركبة التوصيل. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على TaskMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
taskOutcomeMarkerCustomization اختياري	النوع: function(TaskMarkerCustomizationFunctionParams): void optional التخصيص المطبّق على علامة نتيجة المهمة. يتم عرض علامة نتيجة المهمة في الموقع الجغرافي الفعلي لنتيجة كل مهمة تم إسنادها إلى مركبة التوصيل. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على TaskMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.

FleetEngineTaskFilterOptions interface

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

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

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

واجهة FleetEngineDeliveryVehicleLocationProviderUpdateEvent

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

كائن الحدث الذي تم تمريره إلى معالج الحدث عند بدء الحدث FleetEngineDeliveryVehicleLocationProvider.update.

الخصائص
completedVehicleJourneySegments اختياري	النوع: Array<VehicleJourneySegment> optional أجزاء الرحلة التي أكملتها هذه المركبة لا يمكن تعديلها.
deliveryVehicle اختياري	النوع: DeliveryVehicle optional بنية بيانات مركبة التوصيل التي تم عرضها من خلال التعديل لا يمكن تعديلها.
tasks اختياري	النوع: Array<Task> optional قائمة المهام التي تؤديها مركبة التوصيل هذه لا يمكن تعديلها.

فئة FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class
extends PollingLocationProvider
library "journeySharing"

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

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");

الشركة المصنِّعة
FleetEngineDeliveryFleetLocationProvider	FleetEngineDeliveryFleetLocationProvider(options) المَعلمات: ‫options: FleetEngineDeliveryFleetLocationProviderOptions الخيارات التي يتم تمريرها إلى موفّر الموقع الجغرافي تنشئ هذه الطريقة مقدّم خدمة موقع جغرافي جديد للمركبات التي يتتبّعها Fleet Engine.

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

الطُرق
مكتسَبة: addListener

الفعاليات
update	function(event) الوسيطات: event: FleetEngineDeliveryFleetLocationProviderUpdateEvent الحدث الذي يتم تشغيله عند انتهاء طلب تعديل بيانات Fleet Engine
مكتسَبة: ispollingchange

FleetEngineDeliveryFleetLocationProviderOptions interface

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

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

الخصائص
authTokenFetcher	النوع: AuthTokenFetcher يوفّر رموز JSON المميّزة للويب لمصادقة العميل في Fleet Engine.
projectId	النوع: string رقم تعريف مشروع المستهلك من Google Cloud Console
deliveryVehicleFilter اختياري	النوع: string optional طلب فلترة يتم تطبيقه عند استرجاع مركبات التوصيل يتم تمرير هذا الفلتر مباشرةً إلى Fleet Engine. يُرجى الاطّلاع على ListDeliveryVehiclesRequest.filter لمعرفة التنسيقات المتوافقة. يُرجى العِلم أنّ الفلاتر الصالحة للسمات يجب أن تتضمّن البادئة "attributes". على سبيل المثال، attributes.x = "y" أو attributes."x y" = "z".
deliveryVehicleMarkerCustomization اختياري	النوع: function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional التخصيص المطبَّق على محدّد مركبة توصيل استخدِم هذا الحقل لتحديد نمط مخصّص (مثل رمز العلامة) والتفاعل (مثل معالجة النقرات). إذا تم تحديد عنصر MarkerOptions، يتم تطبيق التغييرات المحدّدة فيه على العلامة بعد إنشائها، مع استبدال خياراتها التلقائية إذا كانت موجودة. في حال تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء العلامة، قبل إضافتها إلى عرض الخريطة. (في هذا الاستدعاء، يتم ضبط المَعلمة isNew في عنصر مَعلمات الدالة على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عندما يتلقّى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عمّا إذا كانت البيانات المقابلة لهذه العلامة قد تغيّرت. يمكنك الاطّلاع على DeliveryVehicleMarkerCustomizationFunctionParams للحصول على قائمة بالمَعلمات المقدَّمة واستخداماتها.
locationRestriction اختياري	النوع: LatLngBounds|LatLngBoundsLiteral optional حدود خطوط العرض/الطول التي يتم تتبُّع المركبات ضمنها فور إنشاء مثيل لموفّر الموقع الجغرافي. في حال عدم ضبطه، لن يبدأ موفّر الموقع الجغرافي في تتبُّع أي مركبات. استخدِم FleetEngineDeliveryFleetLocationProvider.locationRestriction لضبط الحدود وبدء التتبُّع. لتتبُّع جميع مركبات التوصيل بغض النظر عن الموقع الجغرافي، اضبط حدودًا تعادل الكرة الأرضية بأكملها.
staleLocationThresholdMillis اختياري	النوع: number optional الحدّ الأدنى للموقع الجغرافي القديم للمركبة إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. القيمة التلقائية هي 24 ساعة بالملي ثانية. إذا كان الحدّ الأدنى أقل من صفر أو ما لا نهاية، سيتم تجاهل الحدّ الأدنى ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.

واجهة FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

كائن الحدث الذي تم تمريره إلى معالج الحدث عند بدء الحدث FleetEngineDeliveryFleetLocationProvider.update.

الخصائص
deliveryVehicles اختياري	النوع: Array<DeliveryVehicle> optional قائمة مركبات التوصيل التي يعرضها طلب البحث لا يمكن تعديلها.