Map View

فئة JourneySharingMapView

google.maps.journeySharing.JourneySharingMapView صف
مكتبة "journeySharing"

عرض الخريطة

const {JourneySharingMapView} = await google.maps.importLibrary("journeySharing");
JourneySharingMapView
JourneySharingMapView(options)
المَعلمات:
لإنشاء مثيل لعرض الخريطة
automaticViewportMode
هذا الحقل متاح للقراءة فقط. وضع إطار العرض التلقائي
element
النوع: Element
هذا الحقل متاح للقراءة فقط. عنصر DOM الذي يدعم العرض
enableTraffic
النوع: boolean
تفعيل طبقة حركة المرور أو إيقافها
locationProviders
النوع: Array<LocationProvider> optional
هذا الحقل متاح للقراءة فقط. مصادر المواقع الجغرافية التي يتم تتبّعها ليتم عرضها في عرض خريطة التتبّع لإضافة مقدّمي خدمات الموقع الجغرافي أو إزالتهم، استخدِم الطريقتَين JourneySharingMapView.addLocationProvider وJourneySharingMapView.removeLocationProvider.
map
النوع: Map
هذا الحقل متاح للقراءة فقط. عنصر الخريطة المضمّن في عرض الخريطة
mapOptions
النوع: MapOptions
هذا الحقل متاح للقراءة فقط. خيارات الخريطة التي تم تمريرها إلى الخريطة من خلال عرض الخريطة
locationProvider
النوع: LocationProvider optional
هذا الحقل متاح للقراءة فقط. مصدر للمواقع الجغرافية التي يتم تتبّعها ليتم عرضها في عرض خريطة التتبّع
destinationMarkerSetup
النوع: MarkerSetup
لضبط خيارات علامة الموقع الجغرافي للوجهة يتم استدعاؤها كلما تم عرض علامة وجهة جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
originMarkerSetup
النوع: MarkerSetup
لضبط خيارات علامة الموقع الجغرافي لنقطة الانطلاق يتم استدعاؤها كلما تم عرض علامة أصل جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
taskOutcomeMarkerSetup
النوع: MarkerSetup
تتيح ضبط خيارات علامة الموقع الجغرافي لنتيجة المهمة. يتم استدعاؤها كلما تم عرض علامة موقع جغرافي جديدة لنتيجة مهمة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
unsuccessfulTaskMarkerSetup
النوع: MarkerSetup
يتيح هذا الإعداد ضبط خيارات علامة موقع جغرافي لمهمة غير ناجحة. يتم استدعاؤها كلما تم عرض علامة مهمة جديدة غير ناجحة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
vehicleMarkerSetup
النوع: MarkerSetup
لضبط خيارات علامة الموقع الجغرافي للمركبة يتم استدعاؤها عند عرض علامة مركبة جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
waypointMarkerSetup
النوع: MarkerSetup
لضبط خيارات علامة الموقع الجغرافي لنقطة على المسار. يتم استدعاؤها كلما تم عرض علامة نقطة مسار جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
anticipatedRoutePolylineSetup
النوع: PolylineSetup
لضبط خيارات الخطوط المتعدّدة للمسار المتوقّع يتم استدعاؤها كلما تم عرض شكل متعدّد الخطوط لمسار متوقّع جديد.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultPolylineOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.PolylineOptions، وإرجاعه كـ polylineOptions في عنصر PolylineSetupOptions الناتج.

إنّ تحديد عنصر PolylineSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض هذا العنصر الثابت.

لا تُعِد استخدام عنصر PolylineSetupOptions نفسه في دوال أو قيم ثابتة مختلفة لـ PolylineSetup، ولا تُعِد استخدام عنصر google.maps.PolylineOptions نفسه لمفتاح polylineOptions في عناصر PolylineSetupOptions مختلفة. إذا لم يتم ضبط polylineOptions أو visible أو كانت قيمتهما فارغة، سيتم استبدالهما بالقيمة التلقائية. سيتم تجاهل أي قيم تم ضبطها لـ polylineOptions.map أو polylineOptions.path.
takenRoutePolylineSetup
النوع: PolylineSetup
لضبط خيارات الخطوط المتعدّدة للمسار الذي تم اتّباعه يتم استدعاؤها كلما تم عرض خطوط متعدّدة جديدة للمسار الذي تم اتّباعه.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultPolylineOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.PolylineOptions، وإرجاعه كـ polylineOptions في عنصر PolylineSetupOptions الناتج.

إنّ تحديد عنصر PolylineSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض هذا العنصر الثابت.

لا تُعِد استخدام عنصر PolylineSetupOptions نفسه في دوال أو قيم ثابتة مختلفة لـ PolylineSetup، ولا تُعِد استخدام عنصر google.maps.PolylineOptions نفسه لمفتاح polylineOptions في عناصر PolylineSetupOptions مختلفة.

سيتم تجاهل أي قيم تم ضبطها لـ polylineOptions.map أو polylineOptions.path. سيتم استبدال أي قيمة غير محدّدة أو فارغة بالقيمة التلقائية.
pingMarkerSetup
النوع: MarkerSetup
يتيح هذا الإعداد ضبط خيارات علامة الموقع الجغرافي لعملية اختبار الاتصال. يتم استدعاؤها كلما تم عرض علامة اختبار اتصال جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
successfulTaskMarkerSetup
النوع: MarkerSetup
لضبط خيارات علامة موقع جغرافي ناجحة للمهمة. يتم استدعاؤها كلما تم عرض علامة مهمة جديدة ناجحة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدث عند تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
destinationMarkers
النوع: Array<Marker>
تعرض هذه السمة علامات الوجهة، إن توفّرت.
originMarkers
النوع: Array<Marker>
تعرض هذه السمة علامات المصدر، إن توفّرت.
successfulTaskMarkers
النوع: Array<Marker>
تعرض هذه الدالة علامات المهام الناجحة، إن توفّرت.
taskOutcomeMarkers
النوع: Array<Marker>
تعرض هذه الدالة علامات نتائج المهمة، إن توفّرت.
unsuccessfulTaskMarkers
النوع: Array<Marker>
تعرض هذه الدالة علامات المهام غير الناجحة، إن وُجدت.
vehicleMarkers
النوع: Array<Marker>
تعرض هذه الدالة علامات المركبات، إن توفّرت.
waypointMarkers
النوع: Array<Marker>
تعرض هذه السمة علامات النقاط على المسار، إن وُجدت.
anticipatedRoutePolylines
النوع: Array<Polyline>
تعرض هذه السمة الخطوط المتعدّدة للمسار المتوقّع، إن توفّرت.
takenRoutePolylines
النوع: Array<Polyline>
تعرض هذه السمة الخطوط المتعدّدة للمسار الذي تم اتّباعه، إن توفّرت.
addLocationProvider
addLocationProvider(locationProvider)
المَعلمات:
  • locationProvider: LocationProvider موفّر الموقع الجغرافي المطلوب إضافته.
القيمة المعروضة: لا شيء
تضيف هذه السمة موفّر موقع جغرافي إلى عرض الخريطة. إذا سبق أن تمت إضافة مقدّم خدمة الموقع الجغرافي، لن يتم اتخاذ أي إجراء.
removeLocationProvider
removeLocationProvider(locationProvider)
المَعلمات:
  • ‫locationProvider: LocationProvider مزوّد الموقع الجغرافي المطلوب إزالته.
القيمة المعروضة: لا شيء
تزيل هذه الطريقة موفّر موقع جغرافي من عرض الخريطة. إذا لم تتم إضافة موفّر الموقع الجغرافي إلى عرض الخريطة، لن يتم تنفيذ أي إجراء.

واجهة JourneySharingMapViewOptions

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

خيارات عرض الخريطة

element
النوع: Element
عنصر DOM الذي يدعم العرض. الحقل مطلوب.
anticipatedRoutePolylineSetup
اختياري
النوع: PolylineSetup optional
لضبط خيارات الخطوط المتعدّدة للمسار المتوقّع يتم استدعاؤها كلما تم عرض شكل متعدّد الخطوط لمسار متوقّع جديد.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultPolylineOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.PolylineOptions، وإرجاعه كـ polylineOptions في عنصر PolylineSetupOptions الناتج.

إنّ تحديد عنصر PolylineSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض هذا العنصر الثابت.

لا تُعِد استخدام عنصر PolylineSetupOptions نفسه في دوال أو قيم ثابتة مختلفة لـ PolylineSetup، ولا تُعِد استخدام عنصر google.maps.PolylineOptions نفسه لمفتاح polylineOptions في عناصر PolylineSetupOptions مختلفة. إذا لم يتم ضبط polylineOptions أو visible أو كانت قيمتهما فارغة، سيتم استبدالهما بالقيمة التلقائية. سيتم تجاهل أي قيم تم ضبطها لـ polylineOptions.map أو polylineOptions.path.
automaticViewportMode
اختياري
النوع: AutomaticViewportMode optional
وضع إطار العرض التلقائي القيمة التلقائية هي FIT_ANTICIPATED_ROUTE، والتي تتيح لعرض الخريطة تعديل إطار العرض تلقائيًا ليناسب علامات المركبات وعلامات المواقع الجغرافية وأي خطوط متعدّدة مرئية للمسار المتوقّع. اضبط هذا الخيار على NONE لإيقاف الملاءمة التلقائية.
destinationMarkerSetup
اختياري
النوع: MarkerSetup optional
تضبط هذه السمة خيارات علامة الموقع الجغرافي للوجهة. يتم استدعاؤها كلما تم عرض علامة وجهة جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
locationProvider
اختياري
النوع: LocationProvider optional
مصدر للمواقع الجغرافية التي يتم تتبّعها ليتم عرضها في عرض خريطة التتبّع اختيارية:
locationProviders
اختياري
النوع: Array<LocationProvider> optional
مصادر المواقع الجغرافية التي يتم تتبّعها ليتم عرضها في عرض خريطة التتبّع اختيارية:
mapOptions
اختياري
النوع: MapOptions optional
خيارات الخريطة التي تم تمريرها إلى دالة الإنشاء google.maps.Map.
originMarkerSetup
اختياري
النوع: MarkerSetup optional
لضبط خيارات علامة الموقع الجغرافي لنقطة الانطلاق يتم استدعاؤها كلما تم عرض علامة مصدر جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
pingMarkerSetup
اختياري
النوع: MarkerSetup optional
يتيح هذا الإعداد ضبط خيارات علامة الموقع الجغرافي لعملية اختبار الاتصال. يتم استدعاؤها كلما تم عرض علامة اختبار اتصال جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
successfulTaskMarkerSetup
اختياري
النوع: MarkerSetup optional
لضبط خيارات علامة موقع جغرافي ناجحة للمهمة. يتم استدعاؤها كلما تم عرض علامة مهمة جديدة ناجحة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
takenRoutePolylineSetup
اختياري
النوع: PolylineSetup optional
لضبط خيارات الخطوط المتعدّدة للمسار الذي تم اتّباعه يتم استدعاؤها كلما تم عرض خطوط متعدّدة جديدة للمسار الذي تم اتّباعه.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultPolylineOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.PolylineOptions، وإرجاعه كـ polylineOptions في عنصر PolylineSetupOptions الناتج.

إنّ تحديد عنصر PolylineSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض هذا العنصر الثابت.

لا تُعِد استخدام عنصر PolylineSetupOptions نفسه في دوال أو قيم ثابتة مختلفة لـ PolylineSetup، ولا تُعِد استخدام عنصر google.maps.PolylineOptions نفسه لمفتاح polylineOptions في عناصر PolylineSetupOptions مختلفة.

سيتم تجاهل أي قيم تم ضبطها لـ polylineOptions.map أو polylineOptions.path. سيتم استبدال أي قيمة غير محدّدة أو فارغة بالقيمة التلقائية.
taskOutcomeMarkerSetup
اختياري
النوع: MarkerSetup optional
تتيح ضبط خيارات علامة الموقع الجغرافي لنتيجة المهمة. يتم استدعاؤها كلما تم عرض علامة موقع جغرافي جديدة لنتيجة مهمة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
unsuccessfulTaskMarkerSetup
اختياري
النوع: MarkerSetup optional
يتيح هذا الإعداد ضبط خيارات علامة موقع جغرافي لمهمة غير ناجحة. يتم استدعاؤها كلما تم عرض علامة مهمة جديدة غير ناجحة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدث عند تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
vehicleMarkerSetup
اختياري
النوع: MarkerSetup optional
لضبط خيارات علامة الموقع الجغرافي للمركبة يتم استدعاؤها عند عرض علامة مركبة جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.
waypointMarkerSetup
اختياري
النوع: MarkerSetup optional
لضبط خيارات علامة الموقع الجغرافي لنقطة على المسار. يتم استدعاؤها كلما تم عرض علامة نقطة مسار جديدة.

في حال تحديد دالة، يمكن للدالة تعديل حقل defaultMarkerOptions الخاص بالإدخال والذي يحتوي على عنصر google.maps.MarkerOptions، وإرجاعه كـ markerOptions في عنصر MarkerSetupOptions الناتج.

إنّ تحديد عنصر MarkerSetupOptions له التأثير نفسه الذي يحدثه تحديد دالة تعرض ذلك العنصر الثابت.

لا تُعِد استخدام عنصر MarkerSetupOptions نفسه في دوال MarkerSetup أو قيم ثابتة مختلفة، ولا تُعِد استخدام عنصر google.maps.MarkerOptions نفسه لمفتاح markerOptions في عناصر MarkerSetupOptions مختلفة. إذا لم يتم ضبط markerOptions أو كانت قيمته فارغة، سيتم استبداله بالقيمة التلقائية. سيتم تجاهل أي قيمة تم ضبطها لـ markerOptions.map أو markerOptions.position.

AutomaticViewportMode

google.maps.journeySharing.AutomaticViewportMode ثوابت
مكتبة "journeySharing"

وضع إطار العرض التلقائي

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع AutomaticViewportModeString.

const {AutomaticViewportMode} = await google.maps.importLibrary("journeySharing");
FIT_ANTICIPATED_ROUTE ضبط إطار العرض تلقائيًا ليلائم العلامات وأي خطوط متعدّدة للمسارات المتوقّعة المرئية وهذا هو الخيار التلقائي.
NONE عدم ضبط إطار العرض تلقائيًا

فئة مجرّدة LocationProvider

google.maps.journeySharing.LocationProvider فئة مجرّدة

الفئة الرئيسية لجميع موفّري المواقع الجغرافية

addListener
addListener(eventName, handler)
المَعلمات:
  • ‫eventName: string اسم الحدث المطلوب الاستماع إليه
  • ‫handler: Function معالج الأحداث
القيمة المعروضة: MapsEventListener
يضيف MapsEventListener لحدث تم تشغيله بواسطة موفّر الموقع الجغرافي هذا. تعرض هذه الدالة معرّفًا لهذا المستمع يمكن استخدامه مع event.removeListener.

PollingLocationProvider فئة مجرّدة

google.maps.journeySharing.PollingLocationProvider abstract class
extends LocationProvider

الفئة الرئيسية لمقدّمي خدمات أماكن الاقتراع

isPolling
النوع: boolean
تكون القيمة "صحيح" إذا كان موفّر الموقع الجغرافي هذا يستطلع الآراء. للقراءة فقط.
pollingIntervalMillis
النوع: number
الحد الأدنى للوقت بين جلب إشعارات بشأن الموقع الجغرافي بالمللي ثانية إذا استغرق جلب إشعار بشأن الموقع الجغرافي أكثر من pollingIntervalMillis، لن يبدأ الإشعار التالي بشأن الموقع الجغرافي إلا بعد انتهاء الإشعار الحالي.

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

الفاصل الزمني التلقائي والأدنى للاستطلاع هو 5000 مللي ثانية. إذا ضبطت الفاصل الزمني للاستطلاع على قيمة موجبة أقل، يتم تخزين القيمة 5000 واستخدامها.
مكتسَبة: addListener
ispollingchange
function(event)
حدث يتم تشغيله عند تعديل حالة الاستطلاع لموفّر الموقع الجغرافي. استخدِم PollingLocationProvider.isPolling لتحديد حالة الاستطلاع الحالية.

واجهة PollingLocationProviderIsPollingChangeEvent

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

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

error
اختياري
النوع: Error optional
الخطأ الذي تسبّب في تغيير حالة الاستطلاع، إذا كان تغيير الحالة ناتجًا عن خطأ. تكون هذه القيمة غير محدّدة إذا كان تغيير الحالة ناتجًا عن عمليات عادية.