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
لعرض موقع التجوّل الافتراضي للصورة البانورامية الحالية.
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])
المَعلمات: 
قيمة الإرجاع: لا شيء
يمكنك تعيين موفر صورة بانورامية مخصص يُسمى تغيير البانوراما لتحميل صور بانوراما مخصصة.
setMotionTracking
setMotionTracking(motionTracking)
المَعلمات: 
  • motionTracking:  boolean
قيمة الإرجاع: لا شيء
يضبط حالة جهاز تتبُّع الحركة. وإذا true عندما يحرّك المستخدم الجهاز فعليًا وكان المتصفّح يدعمه، ستتتبّع بانوراما "التجوّل الافتراضي" الحركات الفعلية.
setOptions
setOptions(options)
المَعلمات: 
قيمة الإرجاع: لا شيء
تحدِّد هذه السياسة مجموعة من أزواج المفتاح/القيمة.
setPano
setPano(pano)
المَعلمات: 
  • pano:  string
قيمة الإرجاع: لا شيء
لتعيين معرف البانوراما الحالية للبانوراما المخصصة للتجوّل الافتراضي.
setPosition
setPosition(latLng)
المَعلمات: 
قيمة الإرجاع: لا شيء
لضبط موضع LatLng الحالي للصورة البانورامية 360 درجة في التجوّل الافتراضي.
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
تكبير/تصغير الصورة البانورامية، المحدد كرقم. الحصول على مجال رؤية يبلغ 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