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 لعرض موقع التجوّل الافتراضي للصورة البانورامية الحالية.
getMotionTracking	getMotionTracking() المَعلمات: لا شيء قيمة الإرجاع:  boolean تعرض حالة متتبع الحركة. وإذا true عندما يحرّك المستخدم الجهاز فعليًا وكان المتصفّح يدعمه، ستتتبّع بانوراما "التجوّل الافتراضي" الحركات الفعلية.
getPano	getPano() المَعلمات: لا شيء قيمة الإرجاع:  string لعرض معرف البانوراما الحالية للصورة البانورامية للتجوّل الافتراضي. هذا المعرّف ثابت ضمن الجلسة الحالية للمتصفّح فقط.
getPhotographerPov	getPhotographerPov() المَعلمات: لا شيء قيمة الإرجاع:  StreetViewPov تعرض عنوان المصوِّر ودرجة الصوت عند التقاط هذه البانوراما. بالنسبة إلى الصور البانورامية في ميزة "التجوّل الافتراضي" على الطريق، يكشف هذا أيضًا عن الاتجاه الذي تسير فيه السيارة. تتوفّر هذه البيانات بعد حدث "pano_changed".
getPosition	getPosition() المَعلمات: لا شيء قيمة الإرجاع:  LatLng|null لعرض موضع LatLng الحالي للصورة البانورامية 360 درجة في التجوّل الافتراضي.
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 الحالي للصورة البانورامية 360 درجة في التجوّل الافتراضي.
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 تكبير/تصغير الصورة البانورامية، المحدد كرقم. الحصول على مجال رؤية يبلغ 180 درجة عند التكبير أو التصغير بمقدار 0.
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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

الطُرق
getMap	getMap() المَعلمات: لا شيء قيمة الإرجاع:  Map|null لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
setMap	setMap(map) المَعلمات:  map:  Map optional قيمة الإرجاع: لا شيء يعرض الطبقة على الخريطة المحددة. إذا تم تعيين الخريطة على قيمة فارغة، فستتم إزالة الطبقة.
المحتوى المُكتسَب: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll