Rendering

StreetViewPanorama الصنف

google.maps.StreetViewPanorama الصنف

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

هذه الفئة تمتد MVCObject

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
StreetViewPanorama
StreetViewPanorama(container[, opts])
المَعلمات: 
ينشئ بانوراما باستخدام StreetViewPanoramaOptions التي تم تمريرها.
controls
النوع:  Array<MVCArray<HTMLElement>>
عناصر تحكم إضافية لإرفاقها بالبانوراما. لإضافة عنصر تحكم إلى البانوراما، أضف <div> لعنصر التحكم إلى MVCArray المقابل لـ ControlPosition حيث يجب عرضها.
focus
focus()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة: ما مِن قيمة
لضبط التركيز على StreetViewPanorama هذا. ننصحك باستخدام هذه الطريقة مع حدث visible_changed للتأكّد من أنّ StreetViewPanorama مرئي قبل ضبط التركيز عليه. لا يمكن التركيز على StreetViewPanorama غير المرئي.
getLocation
getLocation()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  StreetViewLocation
لعرض موقع التجول الافتراضي للبانوراما الحالية.
getMotionTracking
getMotionTracking()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  boolean
تعرض حالة جهاز تتبُّع الحركة. في حال true عندما يحرّك المستخدم الجهاز فعليًا وكان المتصفّح يتيح استخدامه، تتتبّع بانوراما التجوّل الافتراضي الحركات الجسدية.
getPano
getPano()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  string
لعرض معرف البانوراما الحالي لصورة بانوراما التجوّل الافتراضي. هذا المعرّف ثابت ضمن جلسة المتصفّح الحالية فقط.
getPhotographerPov
getPhotographerPov()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  StreetViewPov
لعرض عنوان المصور ودرجة درجته عند التقاط هذه البانوراما. بالنسبة إلى الصور البانورامية لميزة "التجوّل الافتراضي" على الطريق، يكشف ذلك أيضًا الاتجاه الذي تسير فيه السيارة. وتتوفّر هذه البيانات بعد حدث pano_changed.
getPosition
getPosition()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  LatLng|null
عرض موضع LatLng الحالي للصورة البانورامية في ميزة "التجوّل الافتراضي".
getPov
getPov()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  StreetViewPov
لعرض وجهة النظر الحالية للصورة البانورامية 360 درجة.
getStatus
getStatus()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  StreetViewStatus
يعرض حالة البانوراما عند اكتمال طلب setPosition() أو setPano().
getVisible
getVisible()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  boolean
عرض true إذا كانت البانوراما مرئية. ولا تحدِّد هذه السياسة ما إذا كانت صور "التجوّل الافتراضي" متاحة في الموقع المحدّد.
getZoom
getZoom()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  number
لعرض مستوى التكبير/ التصغير للبانوراما. ويكون التصغير بالكامل هو المستوى 0، حيث يكون مجال الرؤية 180 درجة. يؤدّي التكبير إلى رفع مستوى التكبير.
registerPanoProvider
registerPanoProvider(provider[, opt_options])
المَعلمات: 
القيمة المعروضة: ما مِن قيمة
قم بتعيين مزود البانوراما المخصص الذي تم استدعاؤه عند تغيير pano لتحميل صور بانوراما مخصصة.
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()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عندما يتغير مستوى رؤية العرض البانورامي. ويتم تغيير مستوى الرؤية عند سحب "الدليل" إلى الخريطة أو النقر على زر الإغلاق أو عند استدعاء "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
الحجم بالبكسل لعناصر التحكم التي تظهر على البانوراما. يجب تقديم هذه القيمة مباشرةً عند إنشاء البانوراما، وقد يؤدي تحديث هذه القيمة لاحقًا إلى تحويل عناصر التحكم إلى حالة غير محددة. تحكم فقط عناصر التحكم التي تقدمها واجهة برمجة تطبيقات الخرائط نفسها. لا يتم قياس عناصر التحكّم المخصّصة التي أنشأها المطوِّر.
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 واحدة

خيارات موفِّر Pano المخصّص.
cors optional
النوع:  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 الصنف

google.maps.StreetViewCoverageLayer الصنف

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

هذه الفئة تمتد MVCObject

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
StreetViewCoverageLayer
StreetViewCoverageLayer()
المَعلمات: ما مِن مَعلمات
تنشئ مثيلاً جديدًا من StreetViewCoverageLayer.
getMap
getMap()
المَعلمات: ما مِن مَعلمات
القيمة المعروضة:  Map|null
لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
setMap
setMap(map)
المَعلمات: 
  • map:  Map optional
القيمة المعروضة:  undefined
لعرض الطبقة على الخريطة المحددة. إذا تم تعيين الخريطة على قيمة فارغة، فستتم إزالة الطبقة.
مُكتسَب: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll