Rendering

فئة StreetViewبانوراما

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

واجهة StreetViewبانوراماOptions

واجهة google.maps.StreetViewPanoramaOptions

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

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

واجهة 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)

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

يمتد هذا الصف 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