Fleet Tracking

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider الصف الدراسي

موفّر خدمة توصيل المركبات

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

تحميل باستخدام معلمة عنوان URL &libraries=journeySharing. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة FleetEngineDeliveryVehicleLocationProviderProvider

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

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

واجهة FleetEngineDeliveryDeliveryLocationLocationUpdateEvent

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

تحميل باستخدام معلمة عنوان URL &libraries=journeySharing. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {FleetEngineDeliveryFleetLocationProvider} = await google.map.importLibrary("journeySharing"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
المعلّمات:
لإنشاء موفر موقع جديد للمركبات التي يتم تتبعها بواسطة Fleet Engine.
deliveryVehicleFilter
النوع: string optional
يتم تطبيق الفلتر عند جلب مركبات التسليم.
locationRestriction
النوع: LatLngBounds|LatLngBoundsLiteral optional
الحدود المسموح بها لتتبّع مركبات التسليم في حال عدم ضبط حدود، لن يتم تتبُّع مركبات التسليم. لتتبع جميع مركبات التسليم بغض النظر عن الموقع، عيّن حدودًا تعادل الأرض كلها.
pollingIntervalMillis
النوع: number optional
الحد الأدنى من الوقت بين جلب تحديثات الموقع بالمللي ثانية. إذا استغرق جلب تحديث موقع أكثر من pollingIntervalMillis، فلن يبدأ تحديث الموقع التالي حتى ينتهي التحديث الحالي.

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

الفاصل الزمني التلقائي للاقتراع هو 5, 000 مللي ثانية، وهو الحد الأدنى للفاصل الزمني. وفي حال ضبط الفاصل الزمني للاستقصاء على قيمة أقل من الصفر، يتم استخدام 5, 000.
staleLocationThresholdMillis
النوع: number
هذا الحقل للقراءة فقط. حدّ الموقع الجغرافي للمركبة القديمة. وإذا كان تاريخ آخر موقع للمركبة أقدم من هذا الحد، لن يتم عرض المركبة.
موروثة: isPolling
موروثة: addListener
update
function(event)
الوسيطات:
الحدث الذي يتم تشغيله عند انتهاء طلب تحديث بيانات محرك 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
قائمة مركبات التسليم التي يعرضها طلب البحث غير قابلة للتعديل.