Fleet Tracking - Last Mile Fleet

الفئة FleetEngineDeliveryVehicleLocationProvider

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

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

تمتد هذه الفئة إلى PollingLocationProvider.

يمكنك الوصول من خلال الاتصال على الرقم const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
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

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

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

أماكن إقامة
authTokenFetcher	النوع:  AuthTokenFetcher توفر رموز JSON للويب المميزة لمصادقة العميل مع Fleet Engine.
projectId	النوع:  string رقم تعريف مشروع المستهلك من Google Cloud Console
activePolylineCustomization optional	النوع:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions 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" إلى إيقاف التحديثات المتكرّرة للموقع الجغرافي. يتم استرجاع تعديل موقع جغرافي جديد في حال تغيير أي من المعلمات التي لاحظها موفِّر الموقع الجغرافي. الفاصل الزمني التلقائي للاستطلاع هو 5, 000 ملي ثانية، وهو الحد الأدنى للفاصل الزمني. وفي حال ضبط الفاصل الزمني للاستطلاع على قيمة أقل غير صفرية، سيتم استخدام 5000.
remainingPolylineCustomization optional	النوع:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional تم تطبيق التخصيص على الخطوط المتعددة المتبقية. يتوافق خط متعدد الخطوط المتبقي مع جزء من المسار الذي لم تبدأ المركبة في اجتيازه بعد. استخدِم هذا الحقل لتحديد نمط مخصّص (مثل لون الخطوط المتعددة) والتفاعل (مثل معالجة النقر). في حال تحديد كائن PolylineOptions، يتم تطبيق التغييرات المحدّدة فيه على الخط المتعدد بعد إنشاء الخط المتعدد، ما يؤدّي إلى استبدال خياراته التلقائية إذا كانت متوفّرة. إذا تم تحديد دالة، يتم استدعاؤها مرة واحدة عند إنشاء الخط المتعدد. (في هذا الاستدعاء، يتم ضبط المعلَمة isNew في كائن الدالة معلَمات على true). بالإضافة إلى ذلك، يتم استدعاء هذه الدالة عند تغيير إحداثيات الخطوط المتعددة، أو عندما يتلقى موفّر الموقع الجغرافي بيانات من Fleet Engine، بغض النظر عما إذا كانت البيانات المقابلة لهذا الخطوط المتعددة قد تغيرت أم لا. يُرجى الاطّلاع على DeliveryVehiclePolylineCustomizationFunctionParams للحصول على قائمة بالمعلَمات التي تم توفيرها واستخداماتها.
shouldShowOutcomeLocations optional	النوع:  boolean optional قيمة منطقية لإظهار مواقع النتائج أو إخفائها للمهام التي تم استرجاعها
shouldShowTasks optional	النوع:  boolean optional ويمكنك استخدام قيمة منطقية لإظهار المهام أو إخفائها. وفي حال ضبط السياسة على "خطأ"، سيتم منع طلب نقطة نهاية ListTasks من أجل استرجاع المهام. ستظهر فقط محطات التوقف القادمة للمركبات.
staleLocationThresholdMillis optional	النوع:  number optional حد موقع مركبة قديم إذا كان آخر موقع جغرافي تم تعديله للمركبة أقدم من هذا الحدّ، لن يتم عرض المركبة. ضبط الإعداد التلقائي على 24 ساعة بالمللي ثانية. إذا كان الحدّ أقل من 0 أو العدد اللانهائي، سيتم تجاهل الحدّ ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.
takenPolylineCustomization optional	النوع:  (function(DeliveryVehiclePolylineCustomizationFunctionParams): void)|PolylineOptions 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

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

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

واجهة FleetEngineDeliveryVehicleLocationProviderUpdateEvent

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

عنصر الحدث الذي يتم تمريره إلى معالِج الأحداث عند بدء حدث "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) المَعلمات:  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

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

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

أماكن إقامة
authTokenFetcher	النوع:  AuthTokenFetcher توفر رموز JSON للويب المميزة لمصادقة العميل مع Fleet Engine.
projectId	النوع:  string رقم تعريف مشروع المستهلك من Google Cloud Console
deliveryVehicleFilter optional	النوع:  string optional استعلام فلتر ليتم تطبيقه عند جلب مركبات التسليم. يتم تمرير هذا الفلتر مباشرةً إلى Fleet Engine. يُرجى الاطّلاع على ListDeliveryVehiclesRequest.filter للتعرّف على التنسيقات المتوافقة. يُرجى العِلم أنّ الفلاتر الصالحة للسمات يجب أن تتضمن البادئة "السمات". على سبيل المثال، 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 ساعة بالمللي ثانية. إذا كان الحدّ أقل من صفر أو العدد اللانهائي، سيتم تجاهل الحدّ ولن يتم اعتبار الموقع الجغرافي للمركبة قديمًا.

واجهة FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

عنصر الحدث الذي يتم تمريره إلى معالِج الأحداث عند بدء حدث "FleetEngineDeliveryFleetLocationProvider.update".

أماكن إقامة
deliveryVehicles optional	النوع:  Array<DeliveryVehicle> optional قائمة مركبات التسليم التي يعرضها الاستعلام. غير قابل للتعديل.