Rendering

فئة StreetViewPanorama

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

يعرض هذا الخيار البانوراما لـ LatLng معيّن أو رقم تعريف بانوراما معيّن. يوفّر عنصر StreetViewPanorama "عارض" ميزة "التجوّل الافتراضي" الذي يمكن أن يكون مستقلاً داخل عنصر <div> منفصل أو مرتبطًا بعنصر Map.

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");

الشركة المصنِّعة
StreetViewPanorama	StreetViewPanorama(container[, opts]) المَعلمات: container: HTMLElement opts: StreetViewPanoramaOptions optional يتم إنشاء صورة بانورامية باستخدام StreetViewPanoramaOptions الذي تم تمريره.

الخصائص
controls	النوع: Array<MVCArray<HTMLElement>> عناصر تحكّم إضافية لإرفاقها بالصورة البانورامية لإضافة عنصر تحكّم إلى الصورة البانورامية، أضِف <div> عنصر التحكّم إلى MVCArray المقابل لـ ControlPosition حيث يجب عرضه.

الطُرق
focus	focus() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: لا شيء يضبط التركيز على StreetViewPanorama. يمكنك استخدام هذه الطريقة مع حدث visible_changed للتأكّد من أنّ StreetViewPanorama مرئي قبل التركيز عليه. لا يمكن التركيز على StreetViewPanorama غير مرئي.
getLinks	getLinks() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: Array<StreetViewLink optional>|null تعرض هذه الدالة مجموعة روابط التنقّل لبانوراما في "التجوّل الافتراضي".
getLocation	getLocation() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: StreetViewLocation تعرض هذه الدالة StreetViewLocation للصورة البانورامية الحالية.
getMotionTracking	getMotionTracking() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: boolean تعرض هذه الدالة حالة أداة تتبُّع الحركة. إذا كانت القيمة true عندما يحرّك المستخدم الجهاز فعليًا وكان المتصفّح يتيح ذلك، تتتبّع بانوراما في "التجوّل الافتراضي" الحركات الفعلية.
getPano	getPano() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: string تعرض هذه الطريقة معرّف البانوراما الحالي لبانوراما في "التجوّل الافتراضي". يكون هذا المعرّف ثابتًا ضمن الجلسة الحالية للمتصفّح فقط.
getPhotographerPov	getPhotographerPov() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: StreetViewPov تعرض هذه السمة اتجاه المصوّر ومستوى ميله عند التقاط هذه الصورة البانورامية. بالنسبة إلى صور بانوراما في "التجوّل الافتراضي" على الطريق، يكشف هذا أيضًا عن الاتجاه الذي كانت تسير فيه السيارة. تتوفّر هذه البيانات بعد حدث "pano_changed".
getPosition	getPosition() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: LatLng|null لعرض موضع LatLng الحالي للبانوراما في "التجوّل الافتراضي"
getPov	getPov() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: StreetViewPov تعرض هذه الدالة نقطة العرض الحالية للبانوراما في "التجوّل الافتراضي".
getStatus	getStatus() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: StreetViewStatus تعرض هذه السمة حالة الصورة البانورامية عند اكتمال طلب setPosition() أو setPano().
getVisible	getVisible() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: boolean تعرض هذه الدالة true إذا كانت الصورة البانورامية مرئية. ولا يحدّد ما إذا كانت صور "التجوّل الافتراضي" متاحة في الموقع الجغرافي المحدّد.
getZoom	getZoom() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: number تعرض مستوى التكبير/التصغير للصورة البانورامية. ويكون المستوى 0 هو المستوى الذي يتم فيه التصغير بالكامل، حيث يبلغ مجال الرؤية 180 درجة. يؤدي التكبير إلى زيادة مستوى التكبير.
registerPanoProvider	registerPanoProvider(provider[, opt_options]) المَعلمات: provider: function(string): (StreetViewPanoramaData optional) opt_options: PanoProviderOptions optional القيمة المعروضة: لا شيء يتم ضبط موفّر الصور البانورامية المخصّصة الذي يتم استدعاؤه عند تغيير الصورة البانورامية لتحميل الصور البانورامية المخصّصة.
setLinks	setLinks(links) المَعلمات: links: Array<StreetViewLink> القيمة المعروضة: لا شيء لضبط مجموعة روابط التنقّل في بانوراما في "التجوّل الافتراضي"
setMotionTracking	setMotionTracking(motionTracking) المَعلمات: motionTracking: boolean القيمة المعروضة: لا شيء لضبط حالة أداة تتبُّع الحركة إذا كانت القيمة true عندما يحرّك المستخدم الجهاز فعليًا وكان المتصفّح يتيح ذلك، تتتبّع بانوراما في "التجوّل الافتراضي" الحركات الفعلية.
setOptions	setOptions(options) المَعلمات: options: StreetViewPanoramaOptions optional القيمة المعروضة: لا شيء لضبط مجموعة من أزواج المفاتيح والقيم
setPano	setPano(pano) المَعلمات: pano: string القيمة المعروضة: لا شيء يضبط معرّف البانوراما الحالي للبانوراما في "التجوّل الافتراضي".
setPosition	setPosition(latLng) المَعلمات: latLng: LatLng|LatLngLiteral optional القيمة المعروضة: لا شيء يضبط هذا الخيار الموضع الحالي لـ "LatLng" في بانوراما "التجوّل الافتراضي".
setPov	setPov(pov) المَعلمات: pov: StreetViewPov القيمة المعروضة: لا شيء يضبط زاوية الرؤية للبانوراما في "التجوّل الافتراضي".
setVisible	setVisible(flag) المَعلمات: flag: boolean القيمة المعروضة: لا شيء يتم ضبطها على true لإظهار الصورة البانورامية. في حال ضبطها على false، سيتم إخفاء الصورة البانورامية سواء كانت مضمّنة في الخريطة أو في <div> الخاص بها.
setZoom	setZoom(zoom) المَعلمات: zoom: number القيمة المعروضة: لا شيء يضبط مستوى التكبير/التصغير للصورة البانورامية. ويكون المستوى 0 هو المستوى الذي يتم فيه التصغير بالكامل، حيث يبلغ مجال الرؤية 180 درجة. يؤدي التكبير إلى زيادة مستوى التكبير.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الفعاليات
closeclick	function(event) الوسيطات: event: Event optional تم تفعيل الحدث. يتم تنشيط هذا الحدث عند النقر على زر الإغلاق.
pano_changed	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عندما يتغيّر رقم تعريف الصورة البانورامية. قد تتغيّر الصورة البانورامية أثناء تنقّل المستخدم في الصورة البانورامية أو عند ضبط الموضع يدويًا. يُرجى العِلم أنّ بعض التغييرات في الموضع لا تؤدي إلى ظهور pano_changed.
position_changed	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير موضع الصورة البانورامية. يتغيّر الموضع أثناء تنقّل المستخدم في الصورة البانورامية أو يتم ضبطه يدويًا.
pov_changed	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيُّر زاوية الرؤية في الصورة البانورامية. تتغيّر وجهة النظر مع تغيُّر درجة الميل أو التكبير أو الاتجاه.
resize	function() الوسيطات: لا تتوفّر أي وسيطات على المطوّرين تشغيل هذا الحدث على الصورة البانورامية عندما يتغيّر حجم div: google.maps.event.trigger(panorama, 'resize').
status_changed	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث بعد كل عملية بحث عن بانوراما حسب المعرّف أو الموقع الجغرافي، من خلال setPosition() أو setPano().
visible_changed	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير مستوى ظهور الصورة البانورامية. يتم تغيير مستوى العرض عند سحب "دليل التجوّل الافتراضي" إلى الخريطة أو النقر على زر الإغلاق أو استدعاء setVisible().
zoom_changed	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير مستوى التكبير في الصورة البانورامية.

واجهة StreetViewPanoramaOptions

واجهة google.maps.StreetViewPanoramaOptions

خيارات تحدّد سمات عنصر StreetViewPanorama

الخصائص
addressControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في العنوان
addressControlOptions اختياري	النوع: StreetViewAddressControlOptions optional خيارات العرض لعنصر التحكّم في العنوان
clickToGo اختياري	النوع: boolean optional القيمة التلقائية: true حالة تفعيل/إيقاف ميزة "النقر للانتقال"، ولا تنطبق على الصور البانورامية المخصّصة
controlSize اختياري	النوع: number optional حجم عناصر التحكّم التي تظهر على الصورة البانورامية بالبكسل يجب تقديم هذه القيمة مباشرةً عند إنشاء "بانوراما"، وقد يؤدي تعديل هذه القيمة لاحقًا إلى جعل عناصر التحكّم في حالة غير محدّدة. تتحكّم هذه السياسة فقط في عناصر التحكّم التي توفّرها واجهة برمجة التطبيقات Maps API نفسها. لا يغيّر حجم عناصر التحكّم المخصّصة التي أنشأها المطوّر.
disableDefaultUI اختياري	النوع: boolean optional لتفعيل/إيقاف جميع واجهات المستخدم التلقائية ويمكن إلغاؤها بشكل فردي.
disableDoubleClickZoom اختياري	النوع: boolean optional القيمة التلقائية: true تتيح هذه السياسة تفعيل ميزة التكبير أو التصغير عند النقر مرّتين أو إيقافها.
enableCloseButton اختياري	النوع: boolean optional القيمة التلقائية: false إذا كانت القيمة هي true، سيتم عرض زر الإغلاق.
fullscreenControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في وضع ملء الشاشة
fullscreenControlOptions اختياري	النوع: FullscreenControlOptions optional خيارات العرض لعنصر التحكّم في وضع ملء الشاشة
imageDateControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في تاريخ الحصول على الصور يكون هذا الخيار غير مفعَّل تلقائيًا.
linksControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في الروابط
motionTracking اختياري	النوع: boolean optional يشير هذا الحقل إلى ما إذا كان تتبُّع الحركة مفعَّلاً أو غير مفعَّل. ويكون مفعَّلاً تلقائيًا عندما يكون عنصر التحكّم في تتبُّع الحركة متاحًا ويمنح المستخدم الإذن أو لا يكون مطلوبًا، بحيث يتّبع فيديو POV (وجهة نظر صانع المحتوى) اتجاه الجهاز. ينطبق ذلك بشكل أساسي على الأجهزة الجوّالة. إذا تم ضبط سياسة motionTracking على false أثناء تفعيل سياسة motionTrackingControl، سيظهر عنصر التحكّم في تتبُّع الحركة ولكن سيتم إيقاف التتبُّع، ويمكن للمستخدم النقر على عنصر التحكّم في تتبُّع الحركة لتفعيل هذا الخيار أو إيقافه. إذا تم ضبط motionTracking على true وكان الإذن مطلوبًا ولكن لم يتم طلبه بعد، سيظهر عنصر التحكّم في تتبُّع الحركة ولكن سيتم إيقاف التتبُّع. يمكن للمستخدم النقر على عنصر التحكّم في تتبُّع الحركة لطلب الإذن. إذا تم ضبط السياسة motionTracking على true ورفض المستخدم منح الإذن، سيظهر عنصر التحكّم في تتبُّع الحركة غير مفعّل مع إيقاف التتبُّع.
motionTrackingControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في تتبُّع الحركة يتم تفعيل هذه الميزة تلقائيًا عندما يتضمّن الجهاز بيانات حركة، بحيث يظهر عنصر التحكّم على الخريطة. ينطبق ذلك بشكل أساسي على الأجهزة الجوّالة.
motionTrackingControlOptions اختياري	النوع: MotionTrackingControlOptions optional خيارات العرض لعنصر التحكّم في تتبُّع الحركة
panControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في العرض الشامل
panControlOptions اختياري	النوع: PanControlOptions optional خيارات العرض لعنصر التحكّم في العرض الشامل
pano اختياري	النوع: string optional رقم تعريف البانوراما، والذي يجب ضبطه عند تحديد بانوراما مخصّصة.
position اختياري	النوع: LatLng|LatLngLiteral optional الموضع LatLng للبانوراما في "التجوّل الافتراضي"
pov اختياري	النوع: StreetViewPov optional اتجاه الكاميرا، المحدّد كعنوان وميل، للصورة البانورامية.
scrollwheel اختياري	النوع: boolean optional القيمة التلقائية: true إذا كانت القيمة false، يتم إيقاف التكبير أو التصغير باستخدام عجلة التمرير في "التجوّل الافتراضي".
showRoadLabels اختياري	النوع: boolean optional القيمة التلقائية: true عرض أسماء الشوارع على الصورة البانورامية إذا لم يتم تحديد هذه القيمة أو تم ضبطها على true، يتم عرض أسماء الشوارع في الصورة البانورامية. في حال ضبط السياسة على false، لن يتم عرض أسماء الشوارع.
visible اختياري	النوع: boolean optional إذا كانت القيمة true، ستظهر بانوراما "التجوّل الافتراضي" عند التحميل.
zoom اختياري	النوع: number optional مستوى تكبير الصورة البانورامية، ويتم تحديده كرقم. يؤدي مستوى التكبير 0 إلى توفير مجال رؤية بزاوية 180 درجة.
zoomControl اختياري	النوع: boolean optional حالة تفعيل/إيقاف عنصر التحكّم في التكبير/التصغير
zoomControlOptions اختياري	النوع: ZoomControlOptions optional خيارات العرض لعنصر التحكّم في التكبير/التصغير

واجهة StreetViewAddressControlOptions

واجهة google.maps.StreetViewAddressControlOptions

خيارات عرض عنصر التحكّم في عنوان "التجوّل الافتراضي"

الخصائص
position اختياري	النوع: ControlPosition optional رقم تعريف الموضع يُستخدم رقم التعريف هذا لتحديد موضع عنصر التحكّم على الخريطة. الموضع التلقائي هو TOP_LEFT.

واجهة PanoProviderOptions

واجهة google.maps.PanoProviderOptions

خيارات موفِّر الصور البانورامية المخصّصة

الخصائص
cors اختياري	النوع: boolean optional في حال ضبط هذا الخيار، سيستخدم العارض تقنيات (مثل webgl) لا تعمل إلا عند ضبط عناوين CORS بشكل مناسب على الصور المقدَّمة. وتتمثّل مهمة المطوّر في عرض الصور بشكل صحيح مع هذه العلامة، وإلا قد يؤدي ذلك إلى حدوث أخطاء SecurityErrors.

واجهة StreetViewTileData

واجهة google.maps.StreetViewTileData

سمات مجموعة المربّعات المستخدَمة في بانوراما في "التجوّل الافتراضي"

الخصائص
centerHeading	النوع: number الاتجاه (بالدرجات) في وسط المربّعات البانورامية
tileSize	النوع: Size الحجم (بالبكسل) الذي سيتم عرض المربّعات به
worldSize	النوع: Size حجم (بالبكسل) "عالم" الصورة البانورامية بالكامل

الطُرق

getTileUrl

getTileUrl(pano, tileZoom, tileX, tileY) المَعلمات: pano: string tileZoom: number tileX: number tileY: number القيمة المعروضة: string للحصول على عنوان URL لصورة المربّع المحدّد‫ هذه طريقة مخصّصة يجب تنفيذها لتوفير المربّعات المخصّصة. تستدعي واجهة برمجة التطبيقات هذه الطريقة، وتوفّر المَعلمات التالية: pano هو رقم تعريف الصورة البانورامية لمربّع "التجوّل الافتراضي".‫ tileZoom هو مستوى التكبير/التصغير للمربّع. tileX هو الإحداثي السيني (X) للمربّع.‫ tileY هو الإحداثي الصادي للمربّع. يجب أن تعرض الطريقة المخصّصة عنوان URL لصورة المربّع.

واجهة StreetViewPov

واجهة google.maps.StreetViewPov

تمثّل هذه السمة عنصر وجهة نظر يحدّد اتجاه الكاميرا في موضع بانوراما في "التجوّل الافتراضي". يتم تحديد وجهة النظر من خلال الاتجاه والميل.

الخصائص
heading	النوع: number اتجاه الكاميرا بالدرجات بالنسبة إلى الشمال true الشمال الحقيقي هو 0 درجة، والشرق هو 90 درجة، والجنوب هو 180 درجة، والغرب هو 270 درجة.
pitch	النوع: number تمثّل هذه السمة درجة ميل الكاميرا بالنسبة إلى مركبة "التجوّل الافتراضي". يتراوح من 90 درجة (للأعلى مباشرةً) إلى -90 درجة (للأسفل مباشرةً).

فئة StreetViewCoverageLayer

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

طبقة توضّح المواقع الجغرافية التي تتوفّر فيها ميزة "التجوّل الافتراضي"

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");

الشركة المصنِّعة
StreetViewCoverageLayer	StreetViewCoverageLayer() المَعلمات: لا تتوفّر أي مَعلمات يتم إنشاء مثيل جديد من StreetViewCoverageLayer.

الطُرق
getMap	getMap() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: Map|null تعرض هذه الدالة الخريطة التي تظهر عليها هذه الطبقة.
setMap	setMap(map) المَعلمات: map: Map optional القيمة المعروضة: undefined تعرض هذه الدالة الطبقة على الخريطة المحدّدة. إذا تم ضبط الخريطة على قيمة فارغة، ستتم إزالة الطبقة.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll