Rendering

‫StreetViewPanorama class

google.maps.StreetViewPanorama class

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

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
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> تعرِض هذه السمة مجموعة روابط التنقّل في بانوراما "التجوّل الافتراضي".
getLocation	getLocation() المَعلمات:  بدون القيمة المعروضة:  StreetViewLocation تعرِض هذه السمة موقع StreetViewLocation للصورة البانورامية الحالية.
getMotionTracking	getMotionTracking() المَعلمات:  بدون القيمة المعروضة:  boolean تعرِض هذه السمة حالة أداة تتبُّع الحركة. إذا true عندما يحرك المستخدم الجهاز جسديًا وكان المتصفّح يتيح ذلك، تتتبّع ميزة "التجوّل الافتراضي بزاوية 360 درجة" الحركات الجسدية.
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 عندما يحرك المستخدم الجهاز جسديًا وكان المتصفّح يتيح ذلك، تتتبّع ميزة "التجوّل الافتراضي بزاوية 360 درجة" الحركات الجسدية.
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 تم بدء الحدث. يتم تشغيل هذا الحدث عند النقر على زر الإغلاق.
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() الوسيطات:  بدون يتم تنشيط هذا الحدث عند تغيير مستوى رؤية البانوراما. يتم تغيير مستوى العرض عند سحب Pegman إلى الخريطة أو النقر على زر الإغلاق أو استدعاء setVisible().
zoom_changed	function() الوسيطات:  بدون يتم تنشيط هذا الحدث عند تغيير مستوى التكبير/التصغير في الصورة البانورامية.

واجهة StreetViewPanoramaOptions

google.maps.StreetViewPanoramaOptions واجهة

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

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

واجهة StreetViewAddressControlOptions

google.maps.StreetViewAddressControlOptions واجهة

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

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

واجهة PanoProviderOptions

google.maps.PanoProviderOptions واجهة

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

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

واجهة 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 هو الإحداثي السيني للوحدة المربّعة. tileY هو الإحداثي y للوحدة المربّعة. يجب أن تعرِض الطريقة المخصّصة عنوان URL لصورة المربّع.

واجهة StreetViewPov

google.maps.StreetViewPov واجهة

عنصر نقطة نظر يحدّد اتجاه الكاميرا في موضع الصورة البانورامية في "التجوّل الافتراضي" يتم تعريف نقطة النظر على أنّها الاتجاه والميل.

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

فئة StreetViewCoverageLayer

google.maps.StreetViewCoverageLayer class

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

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

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

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