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|