Advanced Markers

کلاس AdvancedMarkerElement

‫google.maps.marker.AdvancedMarkerElement کلاس

موقعیتی را روی نقشه نشان می‌دهد. توجه داشته باشید که position باید تنظیم شود تا AdvancedMarkerElement نمایش داده شود.

عنصر سفارشی:
<gmp-advanced-marker anchor-left="string" anchor-top="string" gmp-clickable position="lat,lng" title="string"></gmp-advanced-marker>

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

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

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

سازنده
AdvancedMarkerElement	AdvancedMarkerElement([options]) پارامترها:  ‫options:  AdvancedMarkerElementOptions optional AdvancedMarkerElement را با گزینه‌های مشخص‌شده ایجاد می‌کند. اگر نقشه‌ای مشخص شده باشد، AdvancedMarkerElement پس‌از ساخت به نقشه اضافه می‌شود.

مشخصات
anchorLeft	نوع:  string optional پیش‌فرض: «-۵۰٪» مقدار درصد طول CSS که برای جابه‌جایی نقطه لنگر نشانگر از گوشه بالا سمت چپ نشانگر استفاده می‌شود. این ویژگی زمانی مفید است که از تصویری استفاده می‌کنید که نقطه لنگری متفاوت از نقطه مرکزی پایین معمول نشانگر پیش‌فرض دارد. مشخصه HTML: <gmp-advanced-marker anchor-left="string"></gmp-advanced-marker>
anchorTop	نوع:  string optional پیش‌فرض: «-۱۰۰٪» مقدار درصد طول CSS که برای جابه‌جایی نقطه لنگر نشانگر از گوشه بالا سمت چپ نشانگر استفاده می‌شود. این ویژگی زمانی مفید است که از تصویری استفاده می‌کنید که نقطه لنگری متفاوت از نقطه مرکزی پایین معمول نشانگر پیش‌فرض دارد. مشخصه HTML: <gmp-advanced-marker anchor-top="string"></gmp-advanced-marker>
collisionBehavior	نوع:  CollisionBehavior optional AdvancedMarkerElementOptions.collisionBehavior را ببینید.
gmpClickable	نوع:  boolean optional AdvancedMarkerElementOptions.gmpClickable را ببینید. مشخصه HTML: <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
gmpDraggable	نوع:  boolean optional AdvancedMarkerElementOptions.gmpDraggable را ببینید.
map	نوع:  Map optional AdvancedMarkerElementOptions.map را ببینید.
position	نوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional AdvancedMarkerElementOptions.position را ببینید. مشخصه HTML: <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	نوع:  string AdvancedMarkerElementOptions.title را ببینید. مشخصه HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	نوع:  number optional AdvancedMarkerElementOptions.zIndex را ببینید.
element	منسوخ‌شده: مستقیماً از AdvancedMarkerElement استفاده کنید. نوع:  HTMLElement این فیلد فقط خواندنی است. عنصر DOM که از نما پشتیبانی می‌کند.
content	منسوخ‌شده: درعوض از .children استفاده کنید. نوع:  Node optional AdvancedMarkerElementOptions.content را ببینید.

روش‌ها
addEventListener	addEventListener(type, listener[, options]) پارامترها:  ‫type:  string رشته‌ای حساس به حروف بزرگ و کوچک که نوع رویداد را برای گوش دادن نشان می‌دهد. listener:  EventListener|EventListenerObject شیئی که اعلان را دریافت می‌کند. این باید تابع یا شیئی با روش handleEvent باشد options:  boolean|AddEventListenerOptions optional گزینه‌ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می‌کنند. مقدار برگشتی:  void تابعی را راه‌اندازی می‌کند که هرگاه رویداد مشخص‌شده به هدف ارسال شود، فراخوانی خواهد شد. addEventListener را ببینید
addListener	addListener(eventName, handler) پارامترها:  ‫eventName:  string رویداد برگزاری در روز دیگر. handler:  Function تابع برای رسیدگی به رویدادها. مقدار برگشتی:  MapsEventListener شنونده رویداد حاصل. تابع شنونده ارائه‌شده را به نام رویداد ارائه‌شده در سیستم Maps Eventing اضافه می‌کند.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها:  ‫type:  string رشته‌ای که نوع رویدادی را که باید شنونده رویداد برای آن برداشته شود مشخص می‌کند. listener:  EventListener|EventListenerObject شنونده رویدادِ گرداننده رویداد برای برداشتن از هدف رویداد. options:  boolean|EventListenerOptions optional گزینه‌ها را ببینید. مقدار برگشتی:  void شنونده رویدادی را که قبلاً با addEventListener ثبت شده است از هدف برمی‌دارد. removeEventListener را ببینید.

رویدادها
click	function(event) متغیرهای مستقل:  ‫event:  MapMouseEvent این رویداد زمانی فعال می‌شود که روی عنصر AdvancedMarkerElement کلیک شود. با addEventListener() دردسترس نیست (به‌جای آن از gmp-click استفاده کنید).
drag	function(event) متغیرهای مستقل:  ‫event:  MapMouseEvent این رویداد به‌طور مکرر زمانی که کاربر AdvancedMarkerElement را می‌کشد، فعال می‌شود. با addEventListener() دردسترس نیست.
dragend	function(event) متغیرهای مستقل:  ‫event:  MapMouseEvent این رویداد زمانی فعال می‌شود که کاربر کشیدن AdvancedMarkerElement را متوقف کند. با addEventListener() دردسترس نیست.
dragstart	function(event) متغیرهای مستقل:  ‫event:  MapMouseEvent این رویداد زمانی فعال می‌شود که کاربر شروع به کشیدن AdvancedMarkerElement می‌کند. با addEventListener() دردسترس نیست.
gmp-click	function(event) متغیرهای مستقل:  ‫event:  AdvancedMarkerClickEvent این رویداد زمانی فعال می‌شود که روی عنصر AdvancedMarkerElement کلیک شود. بهتر است با addEventListener() (به‌جای addListener()) استفاده شود.

میانای AdvancedMarkerElementOptions

میانا google.maps.marker.AdvancedMarkerElementOptions

گزینه‌های ساختن AdvancedMarkerElement.

مشخصات
anchorLeft optional	نوع:  string optional پیش‌فرض: «-۵۰٪» مقدار درصد طول CSS که برای جابه‌جایی نقطه لنگر نشانگر از گوشه بالا سمت چپ نشانگر استفاده می‌شود. این ویژگی زمانی مفید است که از تصویری استفاده می‌کنید که نقطه لنگری متفاوت از نقطه مرکزی پایین معمول نشانگر پیش‌فرض دارد.
anchorTop optional	نوع:  string optional پیش‌فرض: «-۱۰۰٪» مقدار درصد طول CSS که برای جابه‌جایی نقطه لنگر نشانگر از گوشه بالا سمت چپ نشانگر استفاده می‌شود. این ویژگی زمانی مفید است که از تصویری استفاده می‌کنید که نقطه لنگری متفاوت از نقطه مرکزی پایین معمول نشانگر پیش‌فرض دارد.
collisionBehavior optional	نوع:  CollisionBehavior optional شمارشی که مشخص می‌کند AdvancedMarkerElement هنگام برخورد با AdvancedMarkerElement دیگر یا با برچسب‌های نقشه پایه در نقشه بُرداری چگونه باید رفتار کند. توجه: برخورد AdvancedMarkerElement با AdvancedMarkerElement هم در نقشه‌های شطرنجی و هم در نقشه‌های بُرداری کار می‌کند، اما برخورد AdvancedMarkerElement با برچسب نقشه مبنا فقط در نقشه‌های بُرداری کار می‌کند.
content optional	نوع:  Node optional پیش‌فرض: PinElement «عنصر DOM» که از تصویر AdvancedMarkerElement پشتیبانی می‌کند. توجه: AdvancedMarkerElement عنصر DOM ارسال‌شده را شبیه‌سازی نمی‌کند. وقتی عنصر DOM به AdvancedMarkerElement منتقل می‌شود، انتقال همان عنصر DOM به AdvancedMarkerElement دیگر باعث جابه‌جایی عنصر DOM می‌شود و AdvancedMarkerElement قبلی خالی به‌نظر می‌رسد.
gmpClickable optional	نوع:  boolean optional پیش‌فرض: false اگر true، AdvancedMarkerElement کلیک‌کردنی خواهد بود و رویداد gmp-click را راه‌اندازی می‌کند، و برای اهداف دسترس‌پذیری تعاملی خواهد بود (مثلاً اجازه دادن به پیمایش صفحه‌کلید ازطریق کلیدهای جهت‌نما).
gmpDraggable optional	نوع:  boolean optional پیش‌فرض: false اگر true باشد، AdvancedMarkerElement می‌تواند کشیده شود. توجه: AdvancedMarkerElement با ارتفاع قابل‌کشیدن نیست.
map optional	نوع:  Map optional نقشه‌ای که AdvancedMarkerElement روی آن نمایش داده می‌شود. نقشه برای نمایش AdvancedMarkerElement لازم است و اگر در ساختار ارائه نشده باشد، می‌توان آن را با تنظیم AdvancedMarkerElement.map ارائه کرد.
position optional	نوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional موقعیت AdvancedMarkerElement را تنظیم می‌کند. AdvancedMarkerElement ممکن است بدون موقعیت ساخته شود، اما تا زمانی که موقعیت آن ارائه نشود (مثلاً ازطریق کنش‌ها یا انتخاب‌های کاربر) نمایش داده نخواهد شد. موقعیت AdvancedMarkerElement را می‌توان با تنظیم AdvancedMarkerElement.position ارائه کرد، اگر در ساختار ارائه نشده باشد. توجه: AdvancedMarkerElement با ارتفاع فقط در نقشه‌های بُرداری پشتیبانی می‌شود.
title optional	نوع:  string optional نوشتار شناور. اگر ارائه شود، نوشتار دسترس‌پذیری (مثلاً برای استفاده با صفحه‌خوان‌ها) با مقدار ارائه‌شده به AdvancedMarkerElement اضافه خواهد شد.
zIndex optional	نوع:  number optional همه AdvancedMarkerElementها به‌ترتیب zIndex روی نقشه نمایش داده می‌شوند، به‌طوری‌که مقادیر بالاتر در جلوی AdvancedMarkerElementهای دارای مقادیر پایین‌تر نمایش داده می‌شوند. به‌طور پیش‌فرض، AdvancedMarkerElementها براساس جایگاه عمودی‌شان در صفحه نمایش داده می‌شوند، به‌طوری‌که AdvancedMarkerElementهای پایین‌تر در جلوی AdvancedMarkerElementهای بالاتر در صفحه ظاهر می‌شوند. توجه داشته باشید که از zIndex برای کمک به تعیین اولویت نسبی بین «نشانگرهای پیشرفته» CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY نیز استفاده می‌شود. مقدار zIndex بالاتر نشان‌دهنده اولویت بالاتر است.

کلاس AdvancedMarkerClickEvent

‫google.maps.marker.AdvancedMarkerClickEvent کلاس

این رویداد با کلیک کردن روی «نشانگر پیشرفته» ایجاد شده است. با event.target.position به موقعیت نشانگر دسترسی پیدا کنید.

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

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

PinElement کلاس

‫google.maps.marker.PinElement کلاس

PinElement نشان‌دهنده عنصر DOM است که از شکل و نویسه‌نگاشت تشکیل شده است. شکل همان سبک بالون را دارد که در AdvancedMarkerElement یا Marker3DElement پیش‌فرض دیده می‌شود. گلیف یک عنصر DOM اختیاری است که به‌شکل بادکنک نمایش داده می‌شود. PinElement ممکن است بسته به PinElement.scale خود نسبت ابعادی متفاوتی داشته باشد.

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

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

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

سازنده
PinElement	PinElement([options]) پارامترها:  ‫options:  PinElementOptions optional

مشخصات
background	نوع:  string optional PinElementOptions.background را ببینید.
borderColor	نوع:  string optional PinElementOptions.borderColor را ببینید.
glyphColor	نوع:  string optional PinElementOptions.glyphColor را ببینید.
glyphSrc	نوع:  URL|string optional PinElementOptions.glyphSrc را ببینید.
glyphText	نوع:  string optional PinElementOptions.glyphText را ببینید.
scale	نوع:  number optional PinElementOptions.scale را ببینید.
element	منسوخ‌شده: مستقیماً از PinElement استفاده کنید. نوع:  HTMLElement این فیلد فقط خواندنی است. عنصر DOM که از نما پشتیبانی می‌کند.
glyph	منسوخ‌شده: درعوض از PinElementOptions.glyphText یا PinElementOptions.glyphSrc استفاده کنید. نوع:  string|Element|URL optional PinElementOptions.glyph را ببینید.

روش‌ها
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 را ببینید.

میانای PinElementOptions

میانا google.maps.marker.PinElementOptions

گزینه‌های ساختن PinElement.

مشخصات
background optional	نوع:  string optional رنگ پس‌زمینه شکل سنجاق. از هر مقدار رنگ CSS پشتیبانی می‌کند.
borderColor optional	نوع:  string optional رنگ حاشیه شکل سنجاق. از هر مقدار رنگ CSS پشتیبانی می‌کند.
glyph optional	منسوخ‌شده: درعوض از PinElementOptions.glyphText یا PinElementOptions.glyphSrc استفاده کنید. نوع:  string|Element|URL optional عنصر DOM نمایش‌داده‌شده در سنجاق.
glyphColor optional	نوع:  string optional رنگ گلیف. از هر مقدار رنگ CSS پشتیبانی می‌کند.
glyphSrc optional	نوع:  URL|string optional منبع تصویر گلیف برای نمایش در سنجاق.
glyphText optional	نوع:  string optional نوشتاری که در سنجاق نمایش داده می‌شود.
scale optional	نوع:  number optional پیش‌فرض: 1 مقیاس سنجاق.