Rendering

کلاس StreetViewPanorama

google.maps . 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
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])
پارامترها:
ارزش بازگشتی: ندارد
ارائه دهنده پانورامای سفارشی را با نام تغییر pano تنظیم کنید تا پانورامای سفارشی بارگیری شود.
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 رابط google.maps . StreetViewPanoramaOptions

گزینه هایی که ویژگی های یک شی StreetViewPanorama را تعریف می کنند.

addressControl optional
نوع: boolean optional
وضعیت فعال/غیرفعال کنترل آدرس.
addressControlOptions optional
گزینه های نمایش برای کنترل آدرس.
clickToGo optional
نوع: boolean optional
پیش فرض: true
حالت فعال/غیرفعال کلیک برای رفتن. برای پانورامای سفارشی قابل استفاده نیست.
controlSize optional
نوع: number optional
اندازه پیکسل‌های کنترل‌هایی که در پانوراما ظاهر می‌شوند. این مقدار باید به طور مستقیم هنگام ایجاد پانوراما ارائه شود، به روز رسانی این مقدار بعداً ممکن است کنترل ها را به حالت نامشخصی برساند. فقط کنترل های ایجاد شده توسط خود Maps API را کنترل می کند. توسعه‌دهنده کنترل‌های سفارشی ایجاد کرده مقیاس نمی‌کند.
disableDefaultUI optional
نوع: boolean optional
همه UI پیش فرض را فعال/غیرفعال می کند. ممکن است به صورت جداگانه لغو شود.
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 (نقطه دید) جهت گیری دستگاه را دنبال می کند. این در درجه اول برای دستگاه های تلفن همراه قابل اجرا است. اگر در حالی که motionTrackingControl فعال است، motionTracking روی false تنظیم شود، کنترل ردیابی حرکت ظاهر می شود اما ردیابی خاموش است. کاربر می تواند روی کنترل ردیابی حرکت ضربه بزند تا این گزینه را تغییر دهد. اگر در حالی که مجوز لازم است اما هنوز درخواست نشده است، motionTracking روی true تنظیم شود، کنترل ردیابی حرکت ظاهر می شود اما ردیابی خاموش است. کاربر می تواند برای درخواست مجوز روی کنترل ردیابی حرکت ضربه بزند. اگر motionTracking روی true تنظیم شود در حالی که کاربر مجوز آن را رد کرده است، کنترل ردیابی حرکت غیرفعال به نظر می رسد و ردیابی خاموش است.
motionTrackingControl optional
نوع: boolean 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 رابط google.maps . StreetViewAddressControlOptions

گزینه هایی برای ارائه کنترل آدرس نمای خیابان.

position optional
نوع: ControlPosition optional
شناسه موقعیت این شناسه برای تعیین موقعیت کنترل روی نقشه استفاده می شود. موقعیت پیش فرض TOP_LEFT است.

رابط PanoProviderOptions

google.maps . PanoProviderOptions رابط google.maps . PanoProviderOptions

گزینه هایی برای ارائه دهنده Pano سفارشی.

cors optional
نوع: boolean optional
اگر تنظیم شود، رندر از فناوری‌هایی (مانند webgl) استفاده می‌کند که فقط زمانی کار می‌کنند که هدرهای cors به‌طور مناسب روی تصاویر ارائه‌شده تنظیم شده باشند. وظیفه توسعه دهنده این است که تصاویر را به درستی در ترکیب با این پرچم ارائه دهد، که در غیر این صورت ممکن است منجر به خطاهای امنیتی شود.

رابط StreetViewTileData

google.maps . 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 تصویر کاشی را برای کاشی مشخص شده دریافت می کند.
این یک روش سفارشی است که باید برای تامین کاشی های سفارشی خود پیاده سازی کنید. API این متد را فراخوانی می کند و پارامترهای زیر را ارائه می کند:
pano شناسه پانورامای کاشی نمای خیابان است.
tileZoom سطح زوم کاشی است.
tileX مختصات x کاشی است.
tileY مختصات y کاشی است.
روش سفارشی شما باید URL تصویر کاشی را برگرداند.

رابط StreetViewPov

google.maps . StreetViewPov رابط google.maps . StreetViewPov

یک شی نقطه دید که جهت دوربین را در موقعیت پانورامای نمای خیابان مشخص می کند. نقطه نظر به عنوان عنوان و زمین تعریف می شود.

heading
نوع: number
دوربین بر حسب درجه نسبت به شمال true حرکت می کند. شمال واقعی 0 درجه، شرق 90 درجه، جنوب 180 درجه، غرب 270 درجه است.
pitch
نوع: number
گام دوربین بر حسب درجه، نسبت به وسیله نقلیه نمای خیابان. محدوده از 90 درجه (مستقیم به سمت بالا) تا -90 درجه (مستقیم به سمت پایین).

کلاس StreetViewCoverageLayer

google.maps . 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
مقدار بازگشتی: undefined
لایه را روی نقشه مشخص شده رندر می کند. اگر نقشه روی null تنظیم شود، لایه حذف می شود.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll