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 ببینید.

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

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

توجه: فقط در کانال v=beta موجود است.

این رویداد با کلیک کردن روی یک نشانگر پیشرفته ایجاد می شود. با 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 ببینید.

سازنده
PinElement	PinElement([options]) مولفه های: options : PinElementOptions optional

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

مواد و روش ها
addEventListener	توجه: فقط در کانال v=beta موجود است. addEventListener(type, listener[, options]) مولفه های: type : string listener : EventListener | EventListenerObject options : boolean| AddEventListenerOptions optional مقدار برگشتی: void این عملکرد هنوز برای استفاده در دسترس نیست.
removeEventListener	توجه: فقط در کانال v=beta موجود است. 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 .

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