کلاس نشانگر
google.maps . Marker
کلاس google.maps . Marker
این کلاس MVCObject
گسترش می دهد.
با فراخوانی const {Marker} = await google.maps.importLibrary("marker")
دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.
سازنده | |
---|---|
Marker | Marker([opts]) مولفه های:
یک نشانگر با گزینه های مشخص شده ایجاد می کند. اگر نقشه مشخص شده باشد، نشانگر پس از ساخت به نقشه اضافه می شود. توجه داشته باشید که موقعیت باید برای نمایش نشانگر تنظیم شود. |
ثابت ها | |
---|---|
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() پارامترها: ندارد نماد 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.BOUNCE ، Animation.DROP . رد کردن null باعث توقف هر انیمیشن می شود. |
setClickable | setClickable(flag) مولفه های:
ارزش بازگشتی: ندارد تنظیم کنید که Marker قابل کلیک باشد. |
setCursor | setCursor([cursor]) مولفه های:
ارزش بازگشتی: ندارد نوع نشانگر ماوس را که در حالت شناور نشان داده شده است، تنظیم کنید. |
setDraggable | setDraggable(flag) مولفه های:
ارزش بازگشتی: ندارد اگر Marker قابل کشیدن باشد تنظیم کنید. |
setIcon | setIcon([icon]) ارزش بازگشتی: ندارد نماد را برای Marker تنظیم کنید. به MarkerOptions.icon مراجعه کنید. |
setLabel | setLabel([label]) مولفه های:
ارزش بازگشتی: ندارد برچسب را برای Marker تنظیم کنید. به MarkerOptions.label مراجعه کنید. |
setMap | setMap(map) مولفه های:
ارزش بازگشتی: ندارد Marker روی نقشه یا پانورامای مشخص شده نمایش می دهد. اگر نقشه روی null تنظیم شود، نشانگر حذف خواهد شد. |
setOpacity | setOpacity([opacity]) مولفه های:
ارزش بازگشتی: ندارد Opacity Marker را تنظیم کنید. |
setOptions | setOptions(options) مولفه های:
ارزش بازگشتی: ندارد گزینه های Marker را تنظیم کنید. |
setPosition | setPosition([latlng]) مولفه های:
ارزش بازگشتی: ندارد موقعیت را برای Marker تنظیم کنید. |
setShape | setShape([shape]) مولفه های:
ارزش بازگشتی: ندارد |
setTitle | setTitle([title]) مولفه های:
ارزش بازگشتی: ندارد عنوان راهنمای ابزار Marker را تنظیم کنید. به MarkerOptions.title مراجعه کنید. |
setVisible | setVisible(visible) مولفه های:
ارزش بازگشتی: ندارد اگر Marker قابل مشاهده باشد تنظیم کنید. |
setZIndex | setZIndex([zIndex]) مولفه های:
ارزش بازگشتی: ندارد 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 تغییر کند. |
| 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 ، نشانگر رویدادهای ماوس و لمسی را دریافت می کند. |
| نوع: string| CollisionBehavior optional پیش فرض: null یک رفتار برخورد برای نشانگرها در نقشه های برداری تنظیم کنید. |
crossOnDrag optional | نوع: boolean optional پیش فرض: true اگر false ، ضربدری را که در هنگام کشیدن زیر نشانگر ظاهر میشود، غیرفعال میکند. |
cursor optional | نوع: string optional پیش فرض: pointer نشانگر ماوس را برای نشان دادن در شناور تایپ کنید. |
draggable optional | نوع: boolean optional پیش فرض: false اگر true ، نشانگر را می توان کشید. |
icon 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
- که ناحیه غیر شفاف یک تصویر را مشخص می کند.
خواص | |
---|---|
coords | نوع: Array <number> قالب این ویژگی به مقدار 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 مختصات مختصات پایین سمت راست مستطیل هستند. |
type | نوع: string نوع شکل را توصیف می کند و می تواند circle ، poly یا rect باشد. |
رابط نماد
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 برمی گردد. این نوع انیمیشن معمولا در هنگام ایجاد نشانگر مشخص می شود. |