Advanced Markers

کلاس AdvancedMarkerElement

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

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

توجه: استفاده به عنوان یک مؤلفه وب (به عنوان مثال استفاده از عنصر سفارشی <gmp-advanced-marker> HTML، فقط در کانال v=beta موجود است).

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

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

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

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

خواص
collisionBehavior	نوع: CollisionBehavior optional AdvancedMarkerElementOptions.collisionBehavior را ببینید.
content	نوع: Node optional AdvancedMarkerElementOptions.content را ببینید.
element	نوع: HTMLElement این فیلد فقط خواندنی است. عنصر DOM پشتوانه نما.
gmpClickable	نوع: boolean optional ببینید AdvancedMarkerElementOptions.gmpClickable .
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 را ببینید.

روش ها
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 اضافه می کند.
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 رابط google.maps.marker . AdvancedMarkerElementOptions

گزینه هایی برای ساخت AdvancedMarkerElement .

خواص
collisionBehavior optional	نوع: CollisionBehavior optional شمارشی که مشخص می‌کند یک AdvancedMarkerElement چگونه باید در هنگام برخورد با AdvancedMarkerElement دیگر یا با برچسب‌های نقشه پایه در یک نقشه برداری رفتار کند. توجه : برخورد AdvancedMarkerElement به AdvancedMarkerElement هم روی نقشه های شطرنجی و هم بردار کار می کند، با این حال، برخورد برچسب AdvancedMarkerElement به پایه نقشه فقط روی نقشه های برداری کار می کند.
content optional	نوع: Node optional پیش فرض: PinElement.element عنصر 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 استفاده می‌شود. OPTIONAL_AND_HIDES_LOWER_PRIORITY نشانگرهای پیشرفته. مقدار zIndex بالاتر نشان دهنده اولویت بالاتر است.

کلاس AdvancedMarkerClickEvent

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

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

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

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

کلاس PinElement

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

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

توجه: استفاده به عنوان یک مؤلفه وب (مثلاً استفاده به عنوان زیر کلاس HTMLElement یا از طریق HTML) هنوز پشتیبانی نمی شود.

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

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

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

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string listener : EventListener | EventListenerObject options : boolean| AddEventListenerOptions optional مقدار برگشتی: void این عملکرد هنوز برای استفاده در دسترس نیست.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PinElementOptions

google.maps.marker . PinElementOptions رابط google.maps.marker . PinElementOptions

گزینه هایی برای ایجاد یک PinElement .