Advanced Markers

کلاس AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement class
extends HTMLElement
implements AdvancedMarkerElementOptions
library "marker"

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

   
<gmp-advanced-marker
  anchor-left="string"
  anchor-top="string"
  gmp-clickable
  position="lat,lng"
  title="string">
</gmp-advanced-marker>

const {AdvancedMarkerElement} = await google.maps.importLibrary("marker");

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

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

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

کلاس AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent class
extends Event
library "marker"

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

const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker");

PinElement کلاس

google.maps.marker.PinElement class
extends HTMLElement
implements PinElementOptions
library "marker"

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

const {PinElement} = await google.maps.importLibrary("marker");

سازنده
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 readonly	منسوخ‌شده: مستقیماً از PinElement استفاده کنید. نوع: HTMLElement این فیلد فقط خواندنی است. عنصر DOM که از نما پشتیبانی می‌کند.
glyph	منسوخ‌شده: درعوض از PinElementOptions.glyphText یا PinElementOptions.glyphSrc استفاده کنید. نوع: string|Element|URL optional PinElementOptions.glyph را ببینید.

روش‌ها
به‌ارث‌رسیده: addEventListener، removeEventListener

میانای PinElementOptions

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

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

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