Rendering

فئة StreetViewPanorama

google.maps.StreetViewPanorama صف

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

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {StreetViewPanorama} = await google.maps.importLibrary("streetView").
اطّلِع على المكتبات في Maps JavaScript API.
StreetViewPanorama
StreetViewPanorama(container[, opts])
المَعلمات: 
تنشئ هذه الطريقة بانوراما باستخدام StreetViewPanoramaOptions الذي تم تمريره.
controls
النوع:  Array<MVCArray<HTMLElement>>
عناصر تحكّم إضافية يمكن إرفاقها بالصورة البانورامية لإضافة عنصر تحكّم إلى الصورة البانورامية، أضِف <div> عنصر التحكّم إلى MVCArray الذي يتوافق مع ControlPosition حيث يجب عرض عنصر التحكّم.
focus
focus()
المَعلمات:  بدون
القيمة المعروضة:  لا شيء
يضبط التركيز على StreetViewPanorama هذا. ننصحك باستخدام هذه الطريقة مع حدث visible_changed للتأكّد من أنّ StreetViewPanorama مرئي قبل ضبط التركيز عليه. لا يمكن التركيز على StreetViewPanorama غير مرئي.
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])
المَعلمات: 
القيمة المعروضة:  لا شيء
اضبط موفّر الصور البانورامية المخصّص الذي يتم استدعاؤه عند تغيير الصورة البانورامية لتحميل صور بانورامية مخصّصة.
setMotionTracking
setMotionTracking(motionTracking)
المَعلمات: 
  • motionTracking:  boolean
القيمة المعروضة:  لا شيء
تضبط هذه السمة حالة أداة تتبُّع الحركة. إذا كان true عندما يحرك المستخدم الجهاز فعليًا وكان المتصفح يتيح ذلك، ستتتبّع "الصورة البانورامية في التجوّل الافتراضي" الحركات الفعلية.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة مجموعة من أزواج المفاتيح والقيم.
setPano
setPano(pano)
المَعلمات: 
  • pano:  string
القيمة المعروضة:  لا شيء
تضبط رقم تعريف البانوراما الحالي لبانوراما "التجوّل الافتراضي".
setPosition
setPosition(latLng)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة موضع LatLng الحالي في بانوراما "التجوّل الافتراضي".
setPov
setPov(pov)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة نقطة العرض لبانوراما "التجوّل الافتراضي".
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