نشانگر

کلاس نهایی عمومی نشانگر Object را گسترش می دهد

نمادی که در نقطه خاصی از سطح نقشه قرار گرفته است. یک نماد نشانگر به‌جای سطح نقشه، در جهت روی صفحه دستگاه کشیده شده است. به عنوان مثال، به دلیل چرخش نقشه، کج شدن، یا زوم کردن، لزوما جهت را تغییر نمی دهد.

یک نشانگر دارای ویژگی های زیر است:

آلفا
کدورت نشانگر را تنظیم می کند. پیش‌فرض 1.0 است.
لنگر
نقطه روی تصویر که در موقعیت LatLng نشانگر قرار می گیرد. این به طور پیش فرض 50٪ از سمت چپ تصویر و در پایین تصویر است.
موقعیت
مقدار LatLng برای موقعیت نشانگر روی نقشه. اگر بخواهید نشانگر را جابجا کنید، می توانید این مقدار را در هر زمانی تغییر دهید.
عنوان
یک رشته متنی که وقتی کاربر روی نشانگر ضربه می‌زند، در پنجره اطلاعات نمایش داده می‌شود. شما می توانید این مقدار را در هر زمان تغییر دهید.
قطعه
متن اضافی که در زیر عنوان نمایش داده می شود. شما می توانید این مقدار را در هر زمان تغییر دهید.
نماد
یک بیت مپ که برای نشانگر نمایش داده می شود. اگر نماد تنظیم نشده باقی بماند، یک نماد پیش فرض نمایش داده می شود. می‌توانید با استفاده از defaultMarker(float) یک رنگ‌آمیزی جایگزین برای نماد پیش‌فرض تعیین کنید.
وضعیت را بکشید
اگر می‌خواهید به کاربر اجازه دهید نشانگر را بکشد، این ویژگی را روی true تنظیم کنید. شما می توانید این مقدار را در هر زمان تغییر دهید. پیش فرض false است.
دید
به طور پیش فرض، نشانگر قابل مشاهده است. برای نامرئی کردن نشانگر، این ویژگی را روی false قرار دهید. شما می توانید این مقدار را در هر زمان تغییر دهید.
تخت یا بیلبورد
اگر نشانگر در برابر نقشه صاف باشد، همانطور که دوربین می‌چرخد و کج می‌شود، به نقشه چسبیده می‌ماند، اما بر خلاف یک GroundOverlay ، همچنان به اندازه بزرگنمایی دوربین باقی می‌ماند. اگر نشانگر بیلبورد باشد، همیشه رو به دوربین کشیده می شود و همراه با دوربین می چرخد ​​و کج می شود. پیش فرض یک بیلبورد است ( false )
چرخش
چرخش نشانگر بر حسب درجه در جهت عقربه های ساعت حول نقطه لنگر نشانگر. محور چرخش عمود بر نشانگر است. چرخش 0 با موقعیت پیش فرض نشانگر مطابقت دارد. هنگامی که نشانگر روی نقشه صاف است، موقعیت پیش فرض در تراز شمالی است و چرخش به گونه ای است که نشانگر همیشه روی نقشه صاف می ماند. هنگامی که نشانگر یک بیلبورد است، موقعیت پیش فرض به سمت بالا است و چرخش به گونه ای است که نشانگر همیشه رو به دوربین است. مقدار پیش فرض 0 است.
zIndex
ترتیب قرعه کشی برای نشانگر. نشانگرها به ترتیب zIndex رسم می شوند و بالاترین نشانگر zIndex در بالای آن کشیده شده است. با تنظیم خاصیت zIndex برای هر نشانگر، می توانید کنترل کنید که کاربر شما به کدام هدف ضربه زده است. مقدار پیش فرض 0 است.
برچسب بزنید
یک Object مرتبط با نشانگر. به عنوان مثال، Object می تواند حاوی داده هایی در مورد آنچه نشانگر نشان می دهد باشد. این آسان تر از ذخیره کردن یک Map<Marker, Object> . به عنوان مثال دیگر، می توانید یک شناسه String مربوط به شناسه را از یک مجموعه داده مرتبط کنید. Google Maps SDK برای اندروید این ویژگی را نه می‌خواند و نه می‌نویسد.

متدهای این کلاس باید در رشته رابط کاربری اندروید فراخوانی شوند. اگر نه، یک IllegalStateException در زمان اجرا پرتاب می شود.

مثال 

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

راهنمای توسعه دهنده

برای اطلاعات بیشتر، راهنمای توسعه دهندگان Markers را بخوانید.

خلاصه کلاس تودرتو

@رابط نشانگر. برخورد برخورد نشان‌دهنده نحوه برخورد با نشانگر هنگام برخورد با نشانگرهای دیگر یا برچسب‌های نقشه پایه است.

خلاصه روش عمومی

بولی
برابر است (ابژه دیگر)
آزمایش می کند که آیا این Marker با دیگری برابر است یا خیر.
شناور
getAlpha ()
آلفای نشانگر را می گیرد.
رشته
getId ()
شناسه این نشانگر را دریافت می کند.
LatLng
getPosition ()
موقعیت نشانگر را برمی‌گرداند.
شناور
get Rotation ()
چرخش نشانگر را می گیرد.
رشته
getSnippet ()
قطعه نشانگر را می گیرد.
شیء
getTag ()
برچسب نشانگر را دریافت می کند.
رشته
getTitle ()
عنوان نشانگر را می گیرد.
شناور
getZIndex ()
zIndex نشانگر را برمی‌گرداند.
بین المللی
هش کد ()
باطل
hideInfoWindow ()
اگر پنجره اطلاعات از این نشانگر نشان داده شود، پنهان می شود.
بولی
قابل کشیدن است ()
قابلیت کشش نشانگر را دریافت می کند.
بولی
مسطح است ()
تنظیم مسطح نشانگر را دریافت می کند.
بولی
isInfoWindowShown ()
نشان می دهد که آیا پنجره اطلاعات در حال حاضر بالای این نشانگر نشان داده شده است یا خیر.
بولی
قابل مشاهده است ()
تنظیم نمایان بودن این نشانگر را دریافت می کند.
باطل
حذف ()
این نشانگر را از نقشه حذف می کند.
باطل
setAlpha (آلفا شناور)
آلفا (مادر بودن) نشانگر را تنظیم می کند.
باطل
setAnchor (لنگر شناور U، لنگر شناور V)
نقطه لنگر را برای نشانگر تنظیم می کند.
باطل
setDraggable (بولی قابل کشیدن)
قابلیت کشیدن نشانگر را تنظیم می کند.
باطل
setFlat (تخت بولی)
تنظیم می کند که آیا این نشانگر باید در برابر نقشه true باشد یا بیلبوردی که رو به دوربین false .
باطل
setIcon ( BitmapDescriptor iconDescriptor)
نماد را برای نشانگر تنظیم می کند.
باطل
setInfoWindowAnchor (لنگر شناور U، شناور لنگر V)
نقطه ای را در تصویر نشانگر مشخص می کند که هنگام نمایش پنجره اطلاعات، آن را لنگر می اندازد.
باطل
setPosition ( LatLng latlng)
محل نشانگر را تنظیم می کند.
باطل
setRotation (چرخش شناور)
چرخش نشانگر را بر حسب درجه در جهت عقربه های ساعت در مورد نقطه لنگر نشانگر تنظیم می کند.
باطل
setSnippet (قطعه رشته)
قطعه نشانگر را تنظیم می کند.
باطل
setTag (برچسب شی)
برچسب را برای نشانگر تنظیم می کند.
باطل
setTitle (عنوان رشته)
عنوان نشانگر را تنظیم می کند.
باطل
setVisible (بولی قابل مشاهده)
نمایان بودن این نشانگر را تنظیم می کند.
باطل
setZIndex (zIndex شناور)
zIndex نشانگر را تنظیم می کند.
باطل
showInfoWindow ()
اگر این نشانگر isVisible() ، پنجره اطلاعات این نشانگر را روی نقشه نشان می دهد.

خلاصه روش ارثی

روش های عمومی

بولین عمومی برابر است (Object other)

آزمایش می کند که آیا این Marker با دیگری برابر است یا خیر.

پارامترها
دیگر یک Object .
برمی گرداند
  • درست است اگر هر دو شیء یک شی باشند، یعنی این == دیگری.

عمومی float getAlpha ()

آلفای نشانگر را می گیرد.

برمی گرداند
  • آلفای نشانگر در محدوده [0، 1].

رشته عمومی getId ()

شناسه این نشانگر را دریافت می کند. شناسه در بین همه نشانگرهای یک نقشه منحصر به فرد خواهد بود.

برمی گرداند
  • شناسه این نشانگر

عمومی LatLng getPosition ()

موقعیت نشانگر را برمی‌گرداند.

برمی گرداند
  • یک شی LatLng که موقعیت فعلی نشانگر را مشخص می کند.

دریافت چرخش شناور عمومی ()

چرخش نشانگر را می گیرد.

برمی گرداند
  • چرخش نشانگر بر حسب درجه در جهت عقربه های ساعت از موقعیت پیش فرض.

رشته عمومی getSnippet ()

قطعه نشانگر را می گیرد.

برمی گرداند
  • رشته ای حاوی قطعه نشانگر.

دریافت تگ شی عمومی ()

برچسب نشانگر را دریافت می کند.

برمی گرداند
  • تگ اگر یک برچسب با setTag تنظیم شده باشد. اگر هیچ برچسبی تنظیم نشده باشد، null .

رشته عمومی getTitle ()

عنوان نشانگر را می گیرد.

برمی گرداند
  • رشته ای حاوی عنوان نشانگر.

عمومی float getZIndex ()

zIndex نشانگر را برمی‌گرداند.

برمی گرداند
  • zIndex این نشانگر.

هش کد عمومی ()

خلأ عمومی hideInfoWindow ()

اگر پنجره اطلاعات از این نشانگر نشان داده شود، پنهان می شود.

اگر این نشانگر قابل مشاهده نباشد این روش تاثیری ندارد.

بولین عمومی قابل کشیدن است ()

قابلیت کشش نشانگر را دریافت می کند. هنگامی که یک نشانگر قابل کشیدن است، کاربر می تواند آن را با فشار طولانی روی نشانگر جابجا کند.

برمی گرداند
  • true اگر نشانگر قابل کشیدن باشد. در غیر این صورت، false را برمی گرداند.

بولی عمومی isFlat ()

تنظیم مسطح نشانگر را دریافت می کند.

برمی گرداند
  • true اگر نشانگر در برابر نقشه صاف باشد. اگر نشانگر باید رو به دوربین باشد false .

بولین عمومی isInfoWindowShown ()

نشان می دهد که آیا پنجره اطلاعات در حال حاضر بالای این نشانگر نشان داده شده است یا خیر. این در نظر نمی گیرد که آیا پنجره اطلاعات واقعاً روی صفحه قابل مشاهده است یا خیر.

بولی عمومی isVisible ()

تنظیم نمایان بودن این نشانگر را دریافت می کند. توجه داشته باشید که این نشانگر در نمای صفحه نمایش است یا خیر. این نشانگر را نشان می دهد که اگر در نمای صفحه نمایش وجود داشته باشد، ترسیم می شود یا خیر.

برمی گرداند
  • نمایان بودن این نشانگر

خلأ عمومی حذف ()

این نشانگر را از نقشه حذف می کند. پس از حذف یک نشانگر، رفتار همه روش های آن تعریف نشده است.

عمومی void setAlpha (آلفا شناور)

آلفا (مادر بودن) نشانگر را تنظیم می کند. این یک مقدار از 0 تا 1 است، که در آن 0 به معنای شفاف بودن نشانگر و 1 به معنای مات بودن نشانگر است.

پارامترها
آلفا

public void setAnchor (float anchorU, float anchorV)

نقطه لنگر را برای نشانگر تنظیم می کند.

لنگر نقطه ای را در تصویر نماد مشخص می کند که به موقعیت نشانگر روی سطح زمین متصل شده است.

نقطه لنگر در فضای پیوسته [0.0, 1.0] x [0.0، 1.0] مشخص می شود، جایی که (0، 0) گوشه سمت چپ بالای تصویر و (1، 1) گوشه پایین سمت راست است. نقطه لنگر در یک تصویر W x H نزدیکترین نقطه شبکه گسسته در یک شبکه (W + 1) x (H + 1) است که با مقیاس بندی گرد کردن سپس به دست می آید. به عنوان مثال، در یک تصویر 4×2، نقطه لنگر (0.7، 0.6) به نقطه شبکه در (3، 1) حل می شود.

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

پارامترها
anchorU مختصات u لنگر، به عنوان نسبت عرض تصویر (در محدوده [0، 1]).
anchorV v- مختصات لنگر، به عنوان نسبت ارتفاع تصویر (در محدوده [0، 1]).

مجموعه خالی عمومی قابل کشیدن (قابل کشیدن بولی)

قابلیت کشیدن نشانگر را تنظیم می کند. هنگامی که یک نشانگر قابل کشیدن است، کاربر می تواند آن را با فشار طولانی روی نشانگر جابجا کند.

پارامترها
قابل کشیدن

public void setFlat (مسطح بولی)

تنظیم می کند که آیا این نشانگر باید در برابر نقشه true باشد یا بیلبوردی که رو به دوربین false .

پارامترها
تخت

public void setIcon ( BitmapDescriptor iconDescriptor)

نماد را برای نشانگر تنظیم می کند.

پارامترها
iconDescriptor اگر null باشد، از نشانگر پیش فرض استفاده می شود.

public void setInfoWindowAnchor (float anchorU, float anchorV)

نقطه ای را در تصویر نشانگر مشخص می کند که هنگام نمایش پنجره اطلاعات، آن را لنگر می اندازد. این در همان سیستم مختصات لنگر مشخص شده است. برای جزئیات بیشتر به setAnchor(float, float) مراجعه کنید. پیش فرض وسط بالای تصویر است.

پارامترها
anchorU مختصات u لنگر پنجره اطلاعات، به عنوان نسبت عرض تصویر (در محدوده [0، 1]).
anchorV v- مختصات لنگر پنجره اطلاعات، به عنوان نسبت ارتفاع تصویر (در محدوده [0، 1]).

مجموعه پوزیشن عمومی ( LatLng latlng)

محل نشانگر را تنظیم می کند.

پارامترها
latlng

چرخش مجموعه خالی عمومی (چرخش شناور)

چرخش نشانگر را بر حسب درجه در جهت عقربه های ساعت در مورد نقطه لنگر نشانگر تنظیم می کند. محور چرخش عمود بر نشانگر است. چرخش 0 با موقعیت پیش فرض نشانگر مطابقت دارد.

پارامترها
چرخش

public void setSnippet (قطعه رشته)

قطعه نشانگر را تنظیم می کند.

پارامترها
قطعه اگر null باشد، قطعه پاک می شود.

عمومی void setTag (برچسب شی)

برچسب را برای نشانگر تنظیم می کند.

می توانید از این ویژگی برای مرتبط کردن یک Object دلخواه با این نشانگر استفاده کنید. به عنوان مثال، Object می تواند حاوی داده هایی در مورد آنچه نشانگر نشان می دهد باشد. این آسان تر از ذخیره کردن یک Map<Marker, Object> . به عنوان مثال دیگر، می توانید یک شناسه String مربوط به شناسه را از یک مجموعه داده مرتبط کنید. Google Maps SDK برای اندروید این ویژگی را نه می‌خواند و نه می‌نویسد. این مسئولیت شماست که setTag(null) را فراخوانی کنید تا وقتی دیگر به آن نیاز ندارید، برچسب را پاک کنید تا از نشت حافظه در برنامه خود جلوگیری کنید.

پارامترها
برچسب زدن اگر null باشد، تگ پاک می شود.

public void setTitle (عنوان رشته)

عنوان نشانگر را تنظیم می کند.

پارامترها
عنوان اگر null باشد، عنوان پاک می شود.

public void setVisible (بولی قابل مشاهده)

نمایان بودن این نشانگر را تنظیم می کند. اگر روی false تنظیم شود و در حال حاضر یک پنجره اطلاعات برای این نشانگر نمایش داده شود، این پنجره اطلاعات را پنهان می کند.

پارامترها
قابل مشاهده است

setZIndex خالی عمومی (float zIndex)

zIndex نشانگر را تنظیم می کند.

پارامترها
zIndex

public void showInfoWindow ()

اگر این نشانگر isVisible() ، پنجره اطلاعات این نشانگر را روی نقشه نشان می دهد.

پرتاب می کند
IllegalArgumentException اگر marker روی این نقشه نباشد