Maps

کلاس MapElement

google.maps . MapElement کلاس google.maps . MapElement

MapElement یک زیر کلاس HTMLElement برای رندر کردن نقشه ها است. پس از بارگذاری کتابخانه maps ، می توان یک نقشه در HTML ایجاد کرد. به عنوان مثال:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

در داخل، از Map استفاده می کند که با ویژگی MapElement.innerMap قابل دسترسی است.

عنصر سفارشی:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

این کلاس HTMLElement را گسترش می دهد.

این کلاس MapElementOptions را پیاده سازی می کند.

با فراخوانی const {MapElement} = await google.maps.importLibrary("maps") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

MapElement
MapElement([options])
پارامترها:
center
نوع: LatLng | LatLngLiteral optional
طول و عرض جغرافیایی مرکز نقشه.
ویژگی HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
نوع: boolean optional
پیش فرض: false
آیا نقشه باید به کاربر اجازه کنترل عنوان دوربین (چرخش) را بدهد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
ویژگی HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
نوع: Map
اشاره ای به Map که MapElement به صورت داخلی از آن استفاده می کند.
internalUsageAttributionIds
نوع: Iterable <string> optional
پیش فرض: null
شناسه انتساب استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه انتساب استفاده، می‌توانید این ویژگی را حذف کنید یا مقدار را با یک رشته خالی جایگزین کنید. فقط مقادیر منحصر به فرد ارسال خواهد شد. ممکن است تغییرات این مقدار پس از نمونه سازی نادیده گرفته شود.
ویژگی HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
نوع: string optional
شناسه نقشه نقشه این پارامتر را نمی توان پس از نمونه سازی نقشه تنظیم یا تغییر داد. Map.DEMO_MAP_ID می تواند برای آزمایش ویژگی هایی استفاده شود که به شناسه نقشه نیاز دارند اما نیازی به فعال کردن ابر ندارند.
ویژگی HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
نوع: RenderingType optional
پیش فرض: RenderingType.VECTOR
این که آیا نقشه باید یک نقشه شطرنجی یا برداری باشد. این پارامتر را نمی توان پس از نمونه سازی نقشه تنظیم یا تغییر داد. اگر تنظیم نشود، پیکربندی ابری برای شناسه نقشه، نوع رندر را تعیین می‌کند (در صورت وجود). لطفاً توجه داشته باشید که نقشه‌های برداری ممکن است برای همه دستگاه‌ها و مرورگرها در دسترس نباشند و نقشه در صورت لزوم به یک نقشه شطرنجی برمی‌گردد.
ویژگی HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
نوع: boolean optional
پیش فرض: false
آیا نقشه باید به کاربر اجازه کنترل شیب دوربین را بدهد یا خیر. این گزینه فقط زمانی قابل اجرا است که نقشه یک نقشه برداری باشد. اگر در کد تنظیم نشده باشد، از پیکربندی ابر برای شناسه نقشه استفاده خواهد شد (در صورت موجود بودن).
ویژگی HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
نوع: number optional
سطح زوم نقشه مقادیر بزرگنمایی معتبر اعدادی از صفر تا حداکثر سطح بزرگنمایی پشتیبانی شده هستند. مقادیر بزرگنمایی بزرگتر با وضوح بالاتر مطابقت دارد.
ویژگی HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
عنصر شکافدار را در موقعیت ControlPosition.BLOCK_END_INLINE_CENTER قرار می دهد.
control-block-end-inline-end
عنصر شکافدار را در موقعیت ControlPosition.BLOCK_END_INLINE_END قرار می دهد.
control-block-end-inline-start
عنصر شکافدار را در موقعیت ControlPosition.BLOCK_END_INLINE_START قرار می‌دهد.
control-block-start-inline-center
عنصر شکافدار را در موقعیت ControlPosition.BLOCK_START_INLINE_CENTER قرار می دهد.
control-block-start-inline-end
عنصر شکافدار را در موقعیت ControlPosition.BLOCK_START_INLINE_END قرار می دهد.
control-block-start-inline-start
عنصر شکافدار را در موقعیت ControlPosition.BLOCK_START_INLINE_START قرار می دهد.
control-inline-end-block-center
عنصر شکافدار را در موقعیت ControlPosition.INLINE_END_BLOCK_CENTER قرار می دهد.
control-inline-end-block-end
عنصر شکافدار را در موقعیت ControlPosition.INLINE_END_BLOCK_END قرار می دهد.
control-inline-end-block-start
عنصر شکافدار را در موقعیت ControlPosition.INLINE_END_BLOCK_START قرار می دهد.
control-inline-start-block-center
عنصر شکافدار را در موقعیت ControlPosition.INLINE_START_BLOCK_CENTER قرار می دهد.
control-inline-start-block-end
عنصر شکافدار را در موقعیت ControlPosition.INLINE_START_BLOCK_END قرار می دهد.
control-inline-start-block-start
عنصر شکافدار را در موقعیت ControlPosition.INLINE_START_BLOCK_START قرار می دهد.
default
می‌توانید اجزای قابل استفاده مجدد را در اطراف Maps JavaScript Web Components، مانند AdvancedMarkerElement ، با استفاده از عناصر سفارشی ایجاد کنید. به‌طور پیش‌فرض، هر عنصر سفارشی که مستقیماً به MapElement اضافه می‌شود، در MapPanes.overlayMouseTarget شکاف داده می‌شود و رندر می‌شود. با این حال، Maps JavaScript API Web Components ممکن است دوباره در اسلات های داخلی MapElement قرار گیرد.
addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-zoomchange
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که ویژگی بزرگنمایی نقشه تغییر کند.

رابط MapElementOptions

google.maps . MapElementOptions رابط google.maps . MapElementOptions

شی MapElementOptions برای تعریف ویژگی هایی که می توانند روی MapElement تنظیم شوند استفاده می شود.

center optional
نوع: LatLng | LatLngLiteral optional
MapElement.center را ببینید.
headingInteractionDisabled optional
نوع: boolean optional
MapElement.headingInteractionDisabled را ببینید.
internalUsageAttributionIds optional
نوع: Iterable <string> optional
MapElement.internalUsageAttributionIds را ببینید.
mapId optional
نوع: string optional
MapElement.mapId ببینید.
renderingType optional
نوع: RenderingType optional
MapElement.renderingType ببینید.
tiltInteractionDisabled optional
نوع: boolean optional
MapElement.tiltInteractionDisabled را ببینید.
zoom optional
نوع: number optional
MapElement.zoom ببینید.

کلاس ZoomChangeEvent

google.maps . ZoomChangeEvent کلاس google.maps . ZoomChangeEvent

این رویداد از نظارت بر تغییر بزرگنمایی ایجاد شده است.

این کلاس Event را گسترش می دهد.

با فراخوانی const {ZoomChangeEvent} = await google.maps.importLibrary("maps") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

کلاس نقشه

google.maps . Map کلاس google.maps . Map

این کلاس MVCObject را گسترش می دهد.

با فراخوانی const {Map} = await google.maps.importLibrary("maps") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

Map
Map(mapDiv[, opts])
پارامترها:
  • mapDiv : HTMLElement نقشه برای پر کردن این عنصر رندر می شود.
  • opts : MapOptions optional
یک نقشه جدید در داخل ظرف HTML داده شده ایجاد می کند که معمولاً یک عنصر DIV است.
DEMO_MAP_ID شناسه نقشه که می تواند برای نمونه کدهایی که نیاز به شناسه نقشه دارند استفاده شود. این شناسه نقشه برای استفاده در برنامه‌های تولیدی در نظر گرفته نشده است و نمی‌تواند برای ویژگی‌هایی که نیاز به پیکربندی ابری دارند (مانند Cloud Styling) استفاده شود.
controls
نوع: Array < MVCArray < HTMLElement >>
کنترل های اضافی برای پیوست کردن به نقشه. برای افزودن یک کنترل به نقشه، <div> کنترل را به MVCArray مربوط به ControlPosition که باید در آن رندر شود، اضافه کنید.
data
نوع: Data
نمونه ای از Data که به نقشه متصل شده است. ویژگی هایی را به این شی Data اضافه کنید تا به راحتی آنها را در این نقشه نشان دهید.
mapTypes
رجیستری از نمونه های MapType با شناسه رشته.
overlayMapTypes
نوع: MVCArray < MapType optional >
انواع نقشه های اضافی برای همپوشانی. انواع نقشه های همپوشانی به ترتیبی که در آرایه overlayMapTypes ظاهر می شوند، در بالای نقشه پایه ای که به آن متصل شده اند، نمایش داده می شوند (همپوشانی هایی با مقادیر شاخص بالاتر در مقابل همپوشانی هایی با مقادیر شاخص کمتر نمایش داده می شوند).
fitBounds
fitBounds(bounds[, padding])
پارامترها:
  • bounds : LatLngBounds | LatLngBoundsLiteral Bounds برای نشان دادن.
  • padding : number| Padding optional Padding در پیکسل. محدوده ها در قسمتی از نقشه که پس از حذف padding باقی می ماند، متناسب خواهند بود. یک مقدار عددی در هر 4 طرف یک لایه را ایجاد می کند. برای ایجاد یک fitBounds در نتیجه getBounds، عدد 0 را در اینجا عرضه کنید.
ارزش بازگشتی: ندارد
ویوپورت را به گونه ای تنظیم می کند که محدوده های داده شده را داشته باشد.
توجه: هنگامی که نقشه روی display: none ، تنظیم شده است، تابع fitBounds اندازه نقشه را 0x0 می‌خواند و بنابراین کاری انجام نمی‌دهد. برای تغییر درگاه دید در حالی که نقشه پنهان است، نقشه را روی visibility: hidden قرار دهید، بنابراین مطمئن شوید که div نقشه اندازه واقعی دارد. برای نقشه های برداری، این روش شیب و سرفصل نقشه را روی مقادیر صفر پیش فرض تنظیم می کند. فراخوانی این روش ممکن است باعث ایجاد یک انیمیشن روان شود زیرا نقشه حرکت می کند و بزرگنمایی می کند تا با محدوده ها مطابقت داشته باشد. اینکه آیا این روش متحرک می شود یا نه به یک اکتشافی داخلی بستگی دارد.
getBounds
getBounds()
پارامترها: ندارد
مقدار بازگشتی: LatLngBounds |undefined مرزهای lat/lng نمای فعلی.
مرزهای lat/lng درگاه نمای فعلی را برمی‌گرداند. اگر بیش از یک نسخه از جهان قابل مشاهده باشد، محدوده در طول جغرافیایی از 180- تا 180 درجه متغیر است. اگر نقشه هنوز مقداردهی اولیه نشده باشد یا مرکز و بزرگنمایی تنظیم نشده باشد، نتیجه undefined است. برای نقشه‌های برداری با شیب یا عنوان غیر صفر، کرانهای lat/lng برگشتی نشان‌دهنده کوچک‌ترین کادر مرزی است که شامل ناحیه قابل مشاهده درگاه دید نقشه است. برای بدست آوردن ناحیه قابل مشاهده دقیق از نمای نقشه به MapCanvasProjection.getVisibleRegion مراجعه کنید.