Rendering

فئة StreetViewPanorama

google.maps.StreetViewPanorama صف

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

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

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

الشركة المصنِّعة
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 عندما يحرك المستخدم الجهاز فعليًا وكان المتصفح يتيح ذلك، ستتتبّع "الصورة البانورامية في التجوّل الافتراضي" الحركات الفعلية.
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 الحدث الذي تم تفعيله. يتم إطلاق هذا الحدث عند النقر على زر الإغلاق.
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 interface

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

الخصائص
addressControl optional	النوع:  boolean optional حالة عنصر التحكّم في العنوان، سواء كان مفعَّلاً أو غير مفعَّل
addressControlOptions optional	النوع:  StreetViewAddressControlOptions optional خيارات العرض الخاصة بعنصر التحكّم في العنوان
clickToGo optional	النوع:  boolean optional القيمة التلقائية: true حالة تفعيل/إيقاف ميزة "النقر للانتقال"، وهي لا تنطبق على الصور البانورامية المخصّصة.
controlSize optional	النوع:  number optional حجم عناصر التحكّم التي تظهر على الصورة البانورامية بالبكسل يجب تقديم هذه القيمة مباشرةً عند إنشاء Panorama، وقد يؤدي تعديل هذه القيمة لاحقًا إلى وضع عناصر التحكّم في حالة غير محدّدة. لا تنطبق إلا على عناصر التحكّم التي توفّرها واجهة برمجة التطبيقات 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 interface

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

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

PanoProviderOptions interface

google.maps.PanoProviderOptions interface

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

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

StreetViewTileData interface

google.maps.StreetViewTileData interface

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

الخصائص
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 interface

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

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

فئة StreetViewCoverageLayer

google.maps.StreetViewCoverageLayer صف

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

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

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

الشركة المصنِّعة
StreetViewCoverageLayer	StreetViewCoverageLayer() المَعلمات:  بدون تنشئ هذه الطريقة مثيلاً جديدًا من StreetViewCoverageLayer.

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