Rendering

StreetViewPanorama الصنف

google.maps.StreetViewPanorama الصنف

لعرض البانوراما لـ 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 لعرض موقع التجول الافتراضي للبانوراما الحالية.
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]) المَعلمات:  provider:  function(string): (StreetViewPanoramaData optional) opt_options:  PanoProviderOptions optional القيمة المعروضة: ما مِن قيمة قم بتعيين مزود البانوراما المخصص الذي تم استدعاؤه عند تغيير pano لتحميل صور بانوراما مخصصة.
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() الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يتغير مستوى رؤية العرض البانورامي. ويتم تغيير مستوى الرؤية عند سحب "الدليل" إلى الخريطة أو النقر على زر الإغلاق أو عند استدعاء "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