Image overlays

میانای MapType

میانا google.maps.MapType

این میانای نوع نقشه را تعریف می‌کند و معمولاً برای انواع نقشه سفارشی استفاده می‌شود. تغییرناپذیر.

maxZoom
نوع: number
حداکثر سطح بزرگ‌نمایی برای نقشه هنگام نمایش این MapType. برای MapTypes پایه لازم است، برای MapTypes رونهاد نادیده گرفته می‌شود.
minZoom
نوع: number
حداقل سطح بزرگ‌نمایی برای نقشه هنگام نمایش این MapType. اختیاری؛ پیش‌فرض ۰ است.
radius
نوع: number
شعاع سیاره برای نقشه، به متر. اختیاری؛ به‌طور پیش‌فرض روی شعاع استوایی زمین (۶۳۷۸۱۳۷ متر) تنظیم شده است.
alt
اختیاری
نوع: string optional
متن جایگزین برای نمایش وقتی که نشانگر روی دکمه MapType در MapTypeControl نگه داشته می‌شود. اختیاری.
name
اختیاری
نوع: string optional
نامی که در MapTypeControl نمایش داده می‌شود. اختیاری.
projection
اختیاری
نوع: Projection optional
طرحی که برای ارائه این MapType استفاده می‌شود. اختیاری؛ پیش‌فرض روی Mercator است.
tileSize
اختیاری
نوع: Size optional
ابعاد هر کاشی. الزامی.
getTile
getTile(tileCoord, zoom, ownerDocument)
پارامترها:
  • ‫tileCoord: Point مختصات کاشی.
  • ‫zoom: number بزرگ‌نمایی کاشی.
  • ownerDocument: Document سندی که این کاشی به آن تعلق دارد.
مقدار برگشتی: Element|null کاشی حاصل.
کاشی‌ای را برای مختصات کاشی (x, y) و سطح بزرگ‌نمایی داده‌شده برمی‌گرداند. این کاشی به ownerDocument داده‌شده اضافه خواهد شد. برای انواع نقشه مبنا دردسترس نیست.
releaseTile
releaseTile(tile)
پارامترها:
  • ‫tile: کاشی Element optional برای انتشار.
مقدار برگشتی: void
کاشی داده‌شده را آزاد می‌کند و هرگونه پاک‌سازی لازم را انجام می‌دهد. کاشی ارائه‌شده قبلاً از سند برداشته شده است. اختیاری.

میانای پخش محتوا

میانا google.maps.Projection

میانای پیش‌بینی.

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
پارامترها:
مقدار برگشتی: Point|null
از استوانه LatLng به صفحه Point ترجمه می‌کند. این رابط تابعی را مشخص می‌کند که ترجمه از مقادیر LatLng داده‌شده به مختصات جهانی را در تصویر نقشه پیاده‌سازی می‌کند. وقتی Maps API نیاز به ترسیم مکان‌ها روی صفحه‌نمایش دارد، این روش را فراخوانی می‌کند. اشیاء Projection باید این روش را اجرا کنند، اما اگر تصویر نتواند Point را محاسبه کند، ممکن است null را برگرداند.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
پارامترها:
  • ‫pixel:‏ Point
  • ‫noClampNoWrap:‏ boolean optional
مقدار برگشتی: LatLng|null
این میانای کاربری تابعی را مشخص می‌کند که ترجمه از مختصات جهانی در تصویر نقشه به مقادیر LatLng را پیاده‌سازی می‌کند. ‫Maps API وقتی نیاز دارد کنش‌های روی صفحه را به موقعیت‌های روی نقشه ترجمه کند، این روش را فراخوانی می‌کند. اشیاء Projection باید این روش را اجرا کنند، اما اگر تصویر نتواند LatLng را محاسبه کند، ممکن است null را برگرداند.

کلاس ImageMapType

google.maps.ImageMapType class
extends MVCObject
implements MapType
library "maps"

این کلاس میانای MapType را پیاده‌سازی می‌کند و برای ارائه کاشی‌های تصویر ارائه شده است.

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
پارامترها:
ImageMapType را بااستفاده از ImageMapTypeOptions ارائه‌شده می‌سازد
alt
نوع: string optional
maxZoom
نوع: number
minZoom
نوع: number
name
نوع: string optional
projection
نوع: Projection optional
radius
نوع: number
tileSize
نوع: Size optional
getOpacity
getOpacity()
پارامترها: هیچ
مقدار برگشتی: number ماتی ماتی فعلی.
سطح ماتی (0 (شفاف) تا 1.0) کاشی‌های ImageMapType را برمی‌گرداند.
getTile
getTile(tileCoord, zoom, ownerDocument)
پارامترها:
  • ‫tileCoord: Point optional مختصات کاشی.
  • ‫zoom: number بزرگ‌نمایی کاشی.
  • ownerDocument: Document optional سندی که این کاشی به آن تعلق دارد.
مقدار برگشتی: Element|null کاشی حاصل.
releaseTile
releaseTile(tileDiv)
پارامترها:
  • ‫tileDiv: کاشی Element optional برای انتشار.
مقدار برگشتی: هیچ
setOpacity
setOpacity(opacity)
پارامترها:
  • ‫opacity: number ماتی جدید.
مقدار برگشتی: هیچ
سطح ماتی (0 (شفاف) تا 1.0) کاشی‌های ImageMapType را تنظیم می‌کند.
به‌ارث‌رسیده: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
tilesloaded
function()
متغیرهای مستقل: هیچ
این رویداد زمانی فعال می‌شود که بار کردن کاشی‌های نمایان به‌پایان رسیده باشد.

میانای ImageMapTypeOptions

میانا google.maps.ImageMapTypeOptions

این کلاس برای ایجاد MapType استفاده می‌شود که کاشی‌های تصویر را ارائه می‌دهد.

alt
اختیاری
نوع: string optional
متن جایگزین برای نمایش وقتی که نشانگر روی دکمه MapType در MapTypeControl نگه داشته می‌شود.
getTileUrl
اختیاری
نوع: function(Point, number): (string optional) optional
رشته‌ای (نشانی وب) برای مختصات کاشی (x،‏ y) و سطح بزرگ‌نمایی داده‌شده برمی‌گرداند.
maxZoom
اختیاری
نوع: number optional
حداکثر سطح بزرگ‌نمایی برای نقشه هنگام نمایش این MapType.
minZoom
اختیاری
نوع: number optional
حداقل سطح بزرگ‌نمایی برای نقشه هنگام نمایش این MapType. اختیاری.
name
اختیاری
نوع: string optional
نامی که در MapTypeControl نمایش داده می‌شود.
opacity
اختیاری
نوع: number optional
ماتی‌ای که باید روی کاشی‌ها اعمال شود. کدری باید به‌عنوان مقدار ممیز شناور بین ۰ و ۱٫۰ مشخص شود، که ۰ کاملاً شفاف و ۱ کاملاً کدر است.
tileSize
اختیاری
نوع: Size optional
اندازه کاشی.

کلاس GroundOverlay

google.maps.GroundOverlay class
extends MVCObject
library "maps"

رونهاد تصویر مستطیلی روی نقشه.

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
پارامترها:
یک هم‌پوشانی زمین از نشانی وب تصویر ارائه‌شده و LatLngBounds آن ایجاد می‌کند. تصویر برای مطابقت با مرزهای فعلی مقیاس‌بندی‌شده است و بااستفاده از تصویر نقشه فعلی نمایش داده می‌شود.
getBounds
getBounds()
پارامترها: هیچ
مقدار برگشتی: LatLngBounds|null
LatLngBounds این رونهاد را دریافت می‌کند.
getMap
getMap()
پارامترها: هیچ
مقدار برگشتی: Map|null
نقشه‌ای را که این رونهاد زمین روی آن نمایش داده می‌شود برمی‌گرداند.
getOpacity
getOpacity()
پارامترها: هیچ
مقدار برگشتی: number
ماتی این برهم‌گذاری زمین را برمی‌گرداند.
getUrl
getUrl()
پارامترها: هیچ
مقدار برگشتی: string
نشانی وب تصویر پیش‌بینی‌شده را دریافت می‌کند.
setMap
setMap(map)
پارامترها:
  • ‫map:‏ Map optional
مقدار برگشتی: هیچ
رونهاد زمین را روی نقشه مشخص‌شده رندر می‌کند. اگر نقشه روی null تنظیم شده باشد، هم‌پوشانی برداشته می‌شود.
setOpacity
setOpacity(opacity)
پارامترها:
  • ‫opacity:‏ number
مقدار برگشتی: هیچ
ماتی این برهم‌گذاری زمین را تنظیم می‌کند.
به‌ارث‌رسیده: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
click
function(event)
متغیرهای مستقل:
این رویداد زمانی فعال می‌شود که رویداد کلیک DOM در GroundOverlay فعال شود.
dblclick
function(event)
متغیرهای مستقل:
این رویداد زمانی فعال می‌شود که رویداد dblclick مدل شیء سند در GroundOverlay فعال شود.

میانای GroundOverlayOptions

میانا google.maps.GroundOverlayOptions

این شیء ویژگی‌هایی را تعریف می‌کند که می‌توانند روی شیء GroundOverlay تنظیم شوند.

clickable
اختیاری
نوع: boolean optional
اگر true باشد، هم‌پوشانی زمین می‌تواند رویدادهای موشواره را دریافت کند.
map
اختیاری
نوع: Map optional
نقشه‌ای که هم‌پوشانی روی آن نمایش داده می‌شود.
opacity
اختیاری
نوع: number optional
پیش‌فرض: 1.0
کدری هم‌پوشانی، که به‌صورت عددی بین ۰ و ۱ بیان می‌شود. اختیاری.

کلاس StyledMapType

google.maps.StyledMapType class
extends MVCObject
implements MapType
library "maps"

MapType با سبک سفارشی ایجاد می‌کند.

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
پارامترها:
MapType دارای سبک با گزینه‌های مشخص‌شده ایجاد می‌کند. StyledMapType آرایه‌ای از MapTypeStyleها را می‌گیرد، که هر MapTypeStyle به‌طور متوالی روی نقشه اعمال می‌شود. MapTypeStyle بعدی که همان MapTypeStyler را برای همان انتخاب‌کننده‌ها اعمال می‌کند، MapTypeStyleMapTypeStyle قبلی را لغو می‌کند.

توجه داشته باشید که وقتی شناسه نقشه تنظیم شده باشد، از StyledMapType پشتیبانی نمی‌شود. وقتی از هر دو باهم استفاده می‌کنید، هشدار کنسول دریافت خواهید کرد.
alt
نوع: string
maxZoom
نوع: number
minZoom
نوع: number
name
نوع: string
projection
نوع: Projection optional
radius
نوع: number
tileSize
نوع: Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
پارامترها:
  • ‫tileCoord: Point optional مختصات کاشی.
  • ‫zoom: number بزرگ‌نمایی کاشی.
  • ownerDocument: Document optional سندی که این کاشی به آن تعلق دارد.
مقدار برگشتی: Element|null کاشی حاصل.
releaseTile
releaseTile(tile)
پارامترها:
  • ‫tile: کاشی Element optional برای انتشار.
مقدار برگشتی: هیچ
به‌ارث‌رسیده: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

میانای StyledMapTypeOptions

میانا google.maps.StyledMapTypeOptions

این کلاس برای مشخص کردن گزینه‌ها هنگام ایجاد StyledMapType استفاده می‌شود. این گزینه‌ها را نمی‌توان پس‌از نمونه‌سازی StyledMapType تغییر داد.

alt
اختیاری
نوع: string optional
نوشتاری که وقتی نشانگر روی دکمه این MapType در کنترل نوع نقشه نگه داشته می‌شود نمایش داده می‌شود.
maxZoom
اختیاری
نوع: number optional
حداکثر سطح بزرگ‌نمایی برای نقشه هنگام نمایش این MapType. اختیاری.
minZoom
اختیاری
نوع: number optional
حداقل سطح بزرگ‌نمایی برای نقشه هنگام نمایش این MapType. اختیاری.
name
اختیاری
نوع: string optional
نامی که در کنترل نوع نقشه نمایش داده می‌شود.