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 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 سطح بزرگ‌نمایی تمام‌نما را برمی‌گرداند. نمای کاملاً کوچک‌شده سطح ۰ است که در آن میدان دید ۱۸۰ درجه است. زوم‌پیش کردن سطح بزرگ‌نمایی را افزایش می‌دهد.
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 مقدار برگشتی:  هیچ سطح بزرگ‌نمایی تمام‌نما را تنظیم می‌کند. نمای کاملاً کوچک‌شده سطح ۰ است که در آن میدان دید ۱۸۰ درجه است. زوم‌پیش کردن سطح بزرگ‌نمایی را افزایش می‌دهد.
به‌ارث‌رسیده: 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() متغیرهای مستقل:  هیچ این رویداد زمانی فعال می‌شود که رؤیت‌پذیری تمام‌نما تغییر کند. وقتی Pegman روی نقشه کشیده می‌شود، روی دکمه بستن کلیک می‌شود، یا 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 اندازه کنترل‌هایی که در تمام‌نما نشان داده می‌شود، به پیکسل. این مقدار باید مستقیماً هنگام ایجاد «تمام‌نما» ارائه شود، به‌روزرسانی این مقدار در آینده ممکن است کنترل‌ها را به حالت تعریف‌نشده‌ای ببرد. فقط بر کنترل‌های ایجادشده توسط خود Maps 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 بزرگ‌نمایی تمام‌نما، که به‌صورت عدد مشخص می‌شود. بزرگ‌نمایی ۰ «میدان دید» ۱۸۰ درجه‌ای ارائه می‌دهد.
zoomControl optional	نوع:  boolean optional وضعیت فعال/غیرفعال کنترل بزرگ‌نمایی.
zoomControlOptions optional	نوع:  ZoomControlOptions optional گزینه‌های نمایش برای کنترل بزرگ‌نمایی.

StreetViewAddressControlOptions میانای

میانا google.maps.StreetViewAddressControlOptions

گزینه‌هایی برای پردازش کنترل نشانی «نمای خیابان».

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

میانای PanoProviderOptions

میانا google.maps.PanoProviderOptions

گزینه‌های «ارائه‌دهنده پانورامای سفارشی».

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

میانای StreetViewPov

میانا google.maps.StreetViewPov

شیء نقطه دید که جهت دوربین را در موقعیت تمام‌نمای «نمای خیابان» مشخص می‌کند. نقطه دید به‌عنوان جهت و زاویه تعریف می‌شود.

مشخصات
heading	نوع:  number جهت دوربین به درجه نسبت به شمال true. شمال واقعی ۰ درجه، شرق ۹۰ درجه، جنوب ۱۸۰ درجه، و غرب ۲۷۰ درجه است.
pitch	نوع:  number زاویه دوربین برحسب درجه، نسبت به خودرو «نمای خیابان». محدوده از ۹۰ درجه (مستقیماً به‌سمت بالا) تا ۹۰- درجه (مستقیماً به‌سمت پایین) است.

کلاس 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