Rendering

التجوّل الافتراضي البانورامية

google.maps.StreetViewPanorama الصف الدراسي

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

يمتد هذا الصف MVCObject.

الوصول من خلال الاتصال بـ const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
StreetViewPanorama
StreetViewPanorama(container[, opts])
المعلّمات: 
لإنشاء بانوراما باستخدام StreetViewPanoramaOptions التي تم تمريرها.
controls
النوع:  Array<MVCArray<HTMLElement>>
عناصر تحكم إضافية للإرفاق بالبانوراما. لإضافة عنصر تحكم إلى الصورة البانورامية، أضف عنصر التحكم <div> إلى MVCArray المقابل لـ ControlPosition حيث يجب عرضه.
focus
focus()
المعلّمات: بدون
قيمة الإرجاع: بدون
لضبط التركيز على StreetViewPanorama هذا. قد ترغب في استخدام هذه الطريقة بالإضافة إلى حدث visible_changed للتأكد من أن StreetViewPanorama مرئي قبل ضبط التركيز عليه. لا يمكن التركيز على StreetViewPanorama غير المرئي.
getLocation
getLocation()
المعلّمات: بدون
قيمة الإرجاع:  StreetViewLocation
لعرض StreetViewLocation للصورة البانورامية الحالية.
getMotionTracking
getMotionTracking()
المعلّمات: بدون
قيمة الإرجاع:  boolean
لعرض حالة متتبع الحركة. إذا كان true عندما يحرّك المستخدم الجهاز فعليًا ويدعم المتصفّح هذا، تتتبّع بانوراما "التجوّل الافتراضي" الحركات الفعلية.
getPano
getPano()
المعلّمات: بدون
قيمة الإرجاع:  string
لعرض معرف البانوراما الحالي للصورة البانورامية للتجوّل الافتراضي. وهذا المعرّف ثابت خلال الجلسة الحالية للمتصفّح فقط.
getPhotographerPov
getPhotographerPov()
المعلّمات: بدون
قيمة الإرجاع:  StreetViewPov
لعرض العنوان ودرجة الصوت للمصوّر عند التقاط هذه البانوراما. بالنسبة إلى الصور البانورامية للتجوّل الافتراضي على الطريق، يوضح هذا أيضًا الاتجاه الذي تسير فيه السيارة. هذه البيانات متاحة بعد حدث pano_changed.
getPosition
getPosition()
المعلّمات: بدون
قيمة الإرجاع:  LatLng
لعرض موضع LatLng الحالي للصورة البانورامية للتجوّل الافتراضي.
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 الحالي للصورة البانورامية للتجوّل الافتراضي.
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
الحجم بالبكسل الذي يظهر في عناصر التحكم التي تظهر في البانوراما. يجب تقديم هذه القيمة مباشرةً عند إنشاء بانوراما، وقد يؤدي تحديث هذه القيمة لاحقًا إلى تحويل عناصر التحكم إلى حالة غير محددة. تحكم فقط عناصر التحكم التي تم إنشاؤها بواسطة 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
تفعيل ميزة "تتبُّع الحركة" أو إيقافها وينطبق هذا بشكل أساسي على أجهزة الجوّال. في حال ضبط 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 درجة.
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 هو الإحداثي 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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
StreetViewCoverageLayer
StreetViewCoverageLayer()
المعلّمات: بدون
لإنشاء مثيل جديد من StreetViewCoverageLayer.
getMap
getMap()
المعلّمات: بدون
قيمة الإرجاع:  Map|null
لعرض الخريطة التي تُعرض عليها هذه الطبقة.
setMap
setMap(map)
المعلّمات: 
  • map:  Map optional
قيمة الإرجاع: بدون
لعرض الطبقة على الخريطة المحددة. إذا تم تعيين الخريطة على "فارغة"، فستتم إزالة الطبقة.
موروث: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll