Marker (legacy)

کلاس نشانگر

google.maps . Marker کلاس google.maps . Marker

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

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

Marker
Marker([opts])
پارامترها:
  • opts : MarkerOptions optional آرگومانهای اختیاری نامگذاری شده
یک نشانگر با گزینه های مشخص شده ایجاد می کند. اگر نقشه مشخص شده باشد، نشانگر پس از ساخت به نقشه اضافه می شود. توجه داشته باشید که موقعیت باید برای نمایش نشانگر تنظیم شود.
MAX_ZINDEX حداکثر z-index پیش‌فرض که API به یک نشانگر اختصاص می‌دهد. ممکن است برای آوردن نشانگر به جلو، z-index بالاتری تنظیم کنید.
getAnimation
getAnimation()
پارامترها: ندارد
مقدار بازگشتی: Animation |null|undefined
انیمیشن در حال اجرا را دریافت کنید.
getClickable
getClickable()
پارامترها: ندارد
مقدار بازگشتی: اگر نشانگر قابل کلیک باشد، boolean است.
وضعیت قابل کلیک Marker را دریافت کنید.
getCursor
getCursor()
پارامترها: ندارد
مقدار بازگشتی: string|null|undefined
نوع نشانگر ماوس نشان داده شده در شناور را دریافت کنید.
getDraggable
getDraggable()
پارامترها: ندارد
مقدار بازگشتی: اگر نشانگر قابل کشیدن باشد، boolean است.
وضعیت قابل کشیدن Marker را دریافت کنید.
getIcon
getIcon()
پارامترها: ندارد
مقدار بازگشتی: string| Icon | Symbol |null|undefined
نماد Marker را دریافت کنید. به MarkerOptions.icon مراجعه کنید.
getLabel
getLabel()
پارامترها: ندارد
مقدار بازگشتی: MarkerLabel |string|null|undefined
برچسب Marker را دریافت کنید. به MarkerOptions.label مراجعه کنید.
getMap
getMap()
پارامترها: ندارد
مقدار برگشتی: Map | StreetViewPanorama
نقشه یا پانارومای که Marker روی آن رندر شده است را دریافت کنید.
getOpacity
getOpacity()
پارامترها: ندارد
مقدار بازگشتی: number|null|undefined عددی بین 0.0 و 1.0.
کدورت Marker را دریافت کنید.
getPosition
getPosition()
پارامترها: ندارد
مقدار بازگشتی: LatLng |null|undefined
موقعیت Marker را بدست آورید.
getShape
getShape()
پارامترها: ندارد
مقدار بازگشتی: MarkerShape |null|undefined
شکل Marker مورد استفاده برای تعامل را دریافت کنید. به MarkerOptions.shape و MarkerShape مراجعه کنید.
getTitle
getTitle()
پارامترها: ندارد
مقدار بازگشتی: string|null|undefined
عنوان راهنمای ابزار Marker را دریافت کنید. به MarkerOptions.title مراجعه کنید.
getVisible
getVisible()
پارامترها: ندارد
مقدار بازگشتی: اگر نشانگر قابل مشاهده باشد، boolean است.
نمایان بودن Marker را دریافت کنید.
getZIndex
getZIndex()
پارامترها: ندارد
مقدار بازگشتی: number|null|undefined نشانگر.
zIndex Marker را دریافت کنید. به MarkerOptions.zIndex مراجعه کنید.
setAnimation
setAnimation([animation])
پارامترها:
  • animation : Animation optional انیمیشنی که باید پخش شود.
ارزش بازگشتی: ندارد
یک انیمیشن را شروع کنید. هر انیمیشن در حال اجرا لغو خواهد شد. انیمیشن های پشتیبانی شده در حال حاضر عبارتند از: Animation.BOUNCE ، Animation.DROP . رد کردن null باعث توقف هر انیمیشن می شود.
setClickable
setClickable(flag)
پارامترها:
  • flag : boolean اگر true ، می توان روی نشانگر کلیک کرد.
ارزش بازگشتی: ندارد
تنظیم کنید که Marker قابل کلیک باشد.
setCursor
setCursor([cursor])
پارامترها:
  • cursor : string optional نوع مکان نما ماوس.
ارزش بازگشتی: ندارد
نوع نشانگر ماوس را که در حالت شناور نشان داده شده است، تنظیم کنید.
setDraggable
setDraggable(flag)
پارامترها:
  • flag : boolean optional اگر true ، نشانگر را می توان درگ کرد.
ارزش بازگشتی: ندارد
اگر Marker قابل کشیدن باشد تنظیم کنید.
setIcon
setIcon([icon])
پارامترها:
ارزش بازگشتی: ندارد
نماد را برای Marker تنظیم کنید. به MarkerOptions.icon مراجعه کنید.
setLabel
setLabel([label])
پارامترها:
  • label : string| MarkerLabel optional برچسب می تواند یک رشته کاراکتر یا یک شی MarkerLabel باشد.
ارزش بازگشتی: ندارد
برچسب را برای Marker تنظیم کنید. به MarkerOptions.label مراجعه کنید.
setMap
setMap(map)
پارامترها:
ارزش بازگشتی: ندارد
Marker را روی نقشه یا پانورامای مشخص شده نمایش می دهد. اگر نقشه روی null تنظیم شود، نشانگر حذف خواهد شد.
setOpacity
setOpacity([opacity])
پارامترها:
  • opacity : number optional عددی بین 0.0، شفاف و 1.0، مات.
ارزش بازگشتی: ندارد
Opacity Marker را تنظیم کنید.
setOptions
setOptions(options)
پارامترها:
ارزش بازگشتی: ندارد
گزینه های Marker را تنظیم کنید.
setPosition
setPosition([latlng])
پارامترها:
ارزش بازگشتی: ندارد
موقعیت را برای Marker تنظیم کنید.
setShape
setShape([shape])
پارامترها:
ارزش بازگشتی: ندارد
شکل Marker مورد استفاده برای تعامل را تنظیم کنید. به MarkerOptions.shape و MarkerShape مراجعه کنید.
setTitle
setTitle([title])
پارامترها:
  • title : string optional
ارزش بازگشتی: ندارد
عنوان راهنمای ابزار Marker را تنظیم کنید. به MarkerOptions.title مراجعه کنید.
setVisible
setVisible(visible)
پارامترها:
  • visible : boolean اگر true ، نشانگر قابل مشاهده است
ارزش بازگشتی: ندارد
اگر Marker قابل مشاهده باشد تنظیم کنید.
setZIndex
setZIndex([zIndex])
پارامترها:
  • zIndex : number optional
ارزش بازگشتی: ندارد
zIndex Marker را تنظیم کنید. به MarkerOptions.zIndex مراجعه کنید.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll
animation_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی انیمیشن Marker تغییر کند.
click
function(event)
استدلال ها:
این رویداد با کلیک روی نماد Marker فعال می شود.
clickable_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی قابل کلیک Marker تغییر کند.
contextmenu
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که رویداد منوی زمینه DOM روی Marker فعال شود
cursor_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی Marker مکان نما تغییر کند.
dblclick
function(event)
استدلال ها:
این رویداد با دوبار کلیک کردن روی نماد Marker فعال می شود.
drag
function(event)
استدلال ها:
این رویداد به طور مکرر اجرا می شود در حالی که کاربر Marker را می کشد.
dragend
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که کاربر کشیدن Marker را متوقف کند.
draggable_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی قابل کشیدن Marker تغییر کند.
dragstart
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که کاربر شروع به کشیدن Marker می کند.
flat_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی Flat Marker تغییر کند.
icon_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی نماد Marker تغییر کند.
mousedown
function(event)
استدلال ها:
این رویداد برای یک موس روی Marker فعال می شود.
mouseout
function(event)
استدلال ها:
این رویداد زمانی اجرا می شود که ماوس از ناحیه نماد Marker خارج شود.
mouseover
function(event)
استدلال ها:
این رویداد زمانی اجرا می شود که ماوس وارد ناحیه نماد Marker شود.
mouseup
function(event)
استدلال ها:
این رویداد برای یک موس روی Marker فعال می شود.
position_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی موقعیت Marker تغییر کند.
shape_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی Marker shape تغییر کند.
title_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی عنوان Marker تغییر کند.
visible_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی قابل مشاهده Marker تغییر کند.
zindex_changed
function()
استدلال ها: هیچ
این رویداد زمانی فعال می شود که ویژگی Marker zIndex تغییر کند.
rightclick
function(event)
استدلال ها:
این رویداد برای کلیک راست روی Marker فعال می شود.

رابط MarkerOptions

google.maps . MarkerOptions رابط google.maps . MarkerOptions

شیء MarkerOptions برای تعریف خصوصیاتی که می توان روی یک نشانگر تنظیم کرد استفاده می شود.

anchorPoint optional
نوع: Point optional
انحراف از موقعیت نشانگر تا نوک یک InfoWindow که با نشانگر به عنوان لنگر باز شده است.
animation optional
نوع: Animation optional
پیش فرض: null
وقتی نشانگر به نقشه اضافه می شود، کدام انیمیشن پخش شود.
clickable optional
نوع: boolean optional
پیش فرض: true
اگر true ، نشانگر رویدادهای ماوس و لمسی را دریافت می کند.
Beta collisionBehavior optional
نوع: string| CollisionBehavior optional
پیش فرض: null
یک رفتار برخورد برای نشانگرها در نقشه های برداری تنظیم کنید.
crossOnDrag optional
نوع: boolean optional
پیش فرض: true
اگر false ، ضربدری را که در هنگام کشیدن زیر نشانگر ظاهر می‌شود، غیرفعال می‌کند.
cursor optional
نوع: string optional
پیش فرض: pointer
نشانگر ماوس را برای نشان دادن در شناور تایپ کنید.
draggable optional
نوع: boolean optional
پیش فرض: false
اگر true ، نشانگر را می توان کشید. توجه: با تنظیم این مورد روی true ، نشانگر قابل کلیک کردن است حتی اگر clickable روی false تنظیم شود.
icon optional
نوع: string| Icon | Symbol optional
نماد برای پیش زمینه اگر رشته ای ارائه شده باشد، به عنوان یک Icon با رشته به عنوان url رفتار می شود.
label optional
نوع: string| MarkerLabel optional
پیش فرض: null
یک برچسب به نشانگر اضافه می کند. برچسب نشانگر حرف یا عددی است که در داخل نشانگر ظاهر می شود. برچسب می تواند یک رشته یا یک شی MarkerLabel باشد. اگر ارائه شود و MarkerOptions.title ارائه نشده باشد، یک متن دسترس‌پذیری (مثلاً برای استفاده با صفحه‌خوان‌ها) با متن برچسب ارائه‌شده به نشانگر اضافه می‌شود. لطفاً توجه داشته باشید که این label در حال حاضر فقط برای نوشتار دسترس‌پذیری برای نشانگرهای غیربهینه استفاده می‌شود.
map optional
نوع: Map | StreetViewPanorama optional
نقشه ای که نشانگر روی آن نمایش داده می شود. نقشه برای نمایش نشانگر مورد نیاز است و اگر در ساخت نشانگر ارائه نشده باشد، می توان آن را با Marker.setMap ارائه کرد.
opacity optional
نوع: number optional
پیش فرض: 1.0
عددی بین 0.0، شفاف، و 1.0، مات.
optimized optional
نوع: boolean optional
بهینه سازی عملکرد را با ارائه بسیاری از نشانگرها به عنوان یک عنصر ثابت افزایش می دهد. این در مواردی که به تعداد زیادی نشانگر نیاز است مفید است. درباره بهینه سازی نشانگر بیشتر بخوانید. توجه: این بهینه سازی برای نشانگرها روی نقشه های برداری تاثیری ندارد.
position optional
نوع: LatLng | LatLngLiteral optional
موقعیت نشانگر را تنظیم می کند. یک نشانگر ممکن است ساخته شود اما تا زمانی که موقعیت آن ارائه نشود - برای مثال، توسط اقدامات یا انتخاب های یک کاربر، نمایش داده نمی شود. اگر در ساخت نشانگر ارائه نشده باشد، می‌توان موقعیت نشانگر را با Marker.setPosition ارائه کرد.
shape optional
نوع: MarkerShape optional
تعریف منطقه نقشه تصویر برای کشیدن/کلیک کردن استفاده می شود.
title optional
نوع: string optional
پیش فرض: undefined
متن رول. در صورت ارائه، یک متن دسترسی (به عنوان مثال برای استفاده با صفحه خوان) با مقدار ارائه شده به نشانگر اضافه می شود. لطفاً توجه داشته باشید که title در حال حاضر فقط برای متن دسترسی برای نشانگرهای بهینه نشده استفاده می شود.
visible optional
نوع: boolean optional
پیش فرض: true
اگر true ، نشانگر قابل مشاهده است.
zIndex optional
نوع: number optional
همه نشانگرها به ترتیب zIndex خود بر روی نقشه نمایش داده می شوند و مقادیر بالاتر در مقابل نشانگرهایی با مقادیر کمتر نمایش داده می شوند. به‌طور پیش‌فرض، نشانگرها بر اساس موقعیت عمودی‌شان بر روی صفحه نمایش داده می‌شوند و نشانگرهای پایین‌تر در جلوی نشانگرها در بالای صفحه نمایش داده می‌شوند.

ثابت های رفتار برخورد

google.maps . CollisionBehavior ثابت های google.maps . CollisionBehavior

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

OPTIONAL_AND_HIDES_LOWER_PRIORITY نشانگر را فقط در صورتی نمایش دهید که با دیگر نشانگرها همپوشانی نداشته باشد. اگر دو نشانگر از این نوع همپوشانی داشته باشند، نشانگر با zIndex بالاتر نشان داده می شود. اگر zIndex یکسانی داشته باشند، یکی با موقعیت عمودی پایین صفحه نمایش نشان داده می شود.
REQUIRED همیشه نشانگر را بدون توجه به برخورد نمایش دهید. این رفتار پیش فرض است.
REQUIRED_AND_HIDES_OPTIONAL همیشه نشانگر را بدون توجه به برخورد نمایش دهید، و هر OPTIONAL_AND_HIDES_LOWER_PRIORITY نشانگر یا برچسبی را که با نشانگر همپوشانی دارند، پنهان کنید.

رابط آیکون

google.maps . Icon رابط google.maps . Icon

ساختاری که تصویر نماد نشانگر را نشان می دهد.

url
نوع: string
نشانی اینترنتی تصویر یا صفحه اسپرایت.
anchor optional
نوع: Point optional
موقعیتی که برای لنگر انداختن یک تصویر مطابق با مکان نشانگر روی نقشه است. به طور پیش فرض، لنگر در امتداد نقطه مرکزی پایین تصویر قرار دارد.
labelOrigin optional
نوع: Point optional
مبدا برچسب نسبت به گوشه سمت چپ بالای تصویر نماد، اگر برچسبی توسط نشانگر ارائه شده باشد. به طور پیش فرض، مبدا در نقطه مرکزی تصویر قرار دارد.
origin optional
نوع: Point optional
موقعیت تصویر در یک sprite، در صورت وجود. به طور پیش فرض، مبدا در گوشه سمت چپ بالای تصویر (0, 0) قرار دارد.
scaledSize optional
نوع: Size optional
اندازه کل تصویر پس از مقیاس بندی، در صورت وجود. از این ویژگی برای کشش/کوچک کردن یک تصویر یا یک sprite استفاده کنید.
size optional
نوع: Size optional
اندازه نمایش اسپرایت یا تصویر. هنگام استفاده از اسپرایت باید اندازه اسپرایت را مشخص کنید. اگر اندازه ارائه نشده باشد، هنگام بارگذاری تصویر تنظیم می شود.

رابط MarkerLabel

google.maps . MarkerLabel رابط google.maps . MarkerLabel

این گزینه ها ظاهر یک برچسب نشانگر را مشخص می کنند. برچسب نشانگر رشته ای است (اغلب یک کاراکتر) که در داخل نشانگر ظاهر می شود. اگر از آن با یک نشانگر سفارشی استفاده می کنید، می توانید آن را با ویژگی labelOrigin در کلاس Icon تغییر مکان دهید.

text
نوع: string
متنی که باید در برچسب نمایش داده شود.
className optional
نوع: string optional
پیش‌فرض: '' (رشته خالی)
ویژگی className عنصر برچسب (معادل ویژگی کلاس عنصر). چندین کلاس CSS جدا شده با فضا را می توان اضافه کرد. رنگ، اندازه، وزن و خانواده فونت را فقط می‌توان از طریق سایر ویژگی‌های MarkerLabel تنظیم کرد. کلاس‌های CSS نباید برای تغییر موقعیت یا جهت برچسب (مثلاً با استفاده از ترجمه‌ها و چرخش‌ها) استفاده شوند، در صورتی که از مدیریت برخورد نشانگر نیز استفاده می‌شود.
color optional
نوع: string optional
پیش فرض: 'black'
رنگ متن برچسب
fontFamily optional
نوع: string optional
خانواده فونت متن برچسب (معادل ویژگی CSS font-family).
fontSize optional
نوع: string optional
پیش فرض: '14px'
اندازه قلم متن برچسب (معادل ویژگی اندازه قلم CSS).
fontWeight optional
نوع: string optional
وزن قلم متن برچسب (معادل ویژگی CSS font-weight).

رابط MarkerShape

google.maps . MarkerShape رابط google.maps . MarkerShape

این شی منطقه قابل کلیک یک تصویر نشانگر را تعریف می کند. شکل متشکل از دو ویژگی است - type و coord - که ناحیه غیر شفاف یک تصویر را مشخص می کند.

type
نوع: string
نوع شکل را توصیف می کند و می تواند circle ، poly یا rect باشد.
coords optional
نوع: Array <number> optional
قالب این ویژگی به مقدار type بستگی دارد و از مشخصات coords AREA w3 که در http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords یافت می شود، پیروی می کند.
صفت coords آرایه ای از اعداد صحیح است که موقعیت پیکسل شکل را نسبت به گوشه سمت چپ بالای تصویر هدف مشخص می کند. مختصات به مقدار type به صورت زیر بستگی دارد:
- circle : ضرایب [x1,y1,r] است که x1,y2 مختصات مرکز دایره و r شعاع دایره است.
- poly : coords [x1,y1,x2,y2...xn,yn] است که هر جفت x,y مختصات یک راس چند ضلعی را شامل می شود.
- rect : ضرایب [x1,y1,x2,y2] است که x1,y1 مختصات گوشه سمت چپ بالای مستطیل و x2,y2 مختصات مختصات پایین سمت راست مستطیل هستند.

رابط نماد

google.maps . Symbol رابط google.maps . Symbol

نمادی را توصیف می کند که از یک مسیر برداری با یک استایل تشکیل شده است. یک نماد را می توان به عنوان نماد یک نشانگر استفاده کرد یا روی یک خط چند خطی قرار داد.

path
نوع: SymbolPath |string
مسیر نماد، که یک مسیر نماد داخلی است، یا یک مسیر سفارشی که با استفاده از نماد مسیر SVG بیان شده است. مورد نیاز.
anchor optional
نوع: Point optional
پیش فرض: google.maps.Point(0,0)
موقعیت نماد نسبت به نشانگر یا چند خط. مختصات مسیر نماد به ترتیب توسط مختصات x و y لنگر به چپ و بالا ترجمه می شود. موقعیت در همان سیستم مختصاتی به عنوان مسیر نماد بیان می شود.
fillColor optional
نوع: string optional
رنگ پر شدن نماد همه رنگ‌های CSS3 به جز رنگ‌های با نام توسعه‌یافته پشتیبانی می‌شوند. برای نشانگرهای نماد، این پیش‌فرض روی «سیاه» است. برای نمادهای روی چند خط، این به طور پیش‌فرض روی رنگ خطی چند خط مربوطه است.
fillOpacity optional
نوع: number optional
پیش فرض: 0
تیرگی پر شدن نماد
labelOrigin optional
نوع: Point optional
پیش فرض: google.maps.Point(0,0)
مبدا برچسب نسبت به مبدا مسیر، اگر برچسب توسط نشانگر ارائه شده باشد. مبدا در همان سیستم مختصات مسیر نماد بیان می شود. این ویژگی برای نمادهای روی چند خط استفاده نمی شود.
rotation optional
نوع: number optional
پیش فرض: 0
زاویه چرخش نماد، در جهت عقربه های ساعت بر حسب درجه بیان می شود. یک نماد در یک IconSequence که در آن fixedRotation false است، نسبت به زاویه لبه ای که روی آن قرار دارد می چرخد.
scale optional
نوع: number optional
مقداری که نماد بر اساس آن اندازه می شود. برای نشانگرهای نماد، این به طور پیش فرض 1 است. پس از مقیاس بندی، نماد ممکن است در هر اندازه ای باشد. برای نمادهای روی چند خط، این به طور پیش‌فرض روی وزن ضربه‌ای چند خط است. پس از مقیاس بندی، نماد باید در یک مربع به اندازه 22 پیکسل در مرکز لنگر نماد قرار گیرد.
strokeColor optional
نوع: string optional
رنگ سکته مغزی نماد. همه رنگ‌های CSS3 به جز رنگ‌های با نام توسعه‌یافته پشتیبانی می‌شوند. برای نشانگرهای نماد، این پیش‌فرض روی «سیاه» است. برای نمادهای روی چند خط، این به طور پیش‌فرض روی رنگ خطی چند خط است.
strokeOpacity optional
نوع: number optional
کدورت سکته مغزی نماد. برای نشانگرهای نماد، این به طور پیش‌فرض روی 1 است. برای نمادهای روی چند خط، این مقدار به صورت پیش‌فرض روی کدورت خط چند خط است.
strokeWeight optional
نوع: number optional
پیش فرض: Symbol.scale نماد.
وزن ضربه ای نماد.

ثابت های SymbolPath

google.maps . SymbolPath ثابت های google.maps . SymbolPath

مسیرهای نماد داخلی

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

BACKWARD_CLOSED_ARROW یک فلش بسته رو به عقب.
BACKWARD_OPEN_ARROW یک فلش باز رو به عقب.
CIRCLE یک دایره
FORWARD_CLOSED_ARROW یک فلش بسته رو به جلو.
FORWARD_OPEN_ARROW یک فلش باز رو به جلو.

ثابت های انیمیشن

google.maps . Animation ثابت های google.maps . Animation

انیمیشن های قابل پخش روی نشانگر. برای پخش انیمیشن از روش Marker.setAnimation در Marker یا گزینه MarkerOptions.animation استفاده کنید.

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

BOUNCE نشانگر تا زمانی که انیمیشن با فراخوانی Marker.setAnimation با null متوقف شود، پرش می کند.
DROP نشانگر از بالای نقشه به مکان نهایی آن می‌افتد. هنگامی که نشانگر خاموش شود، انیمیشن متوقف می شود و Marker.getAnimation null برمی گردد. این نوع انیمیشن معمولا در هنگام ایجاد نشانگر مشخص می شود.