نمادی که در نقطه خاصی از سطح نقشه قرار گرفته است. یک نماد نشانگر بهجای سطح نقشه، در جهت روی صفحه دستگاه کشیده شده است. به عنوان مثال، به دلیل چرخش نقشه، کج شدن، یا زوم کردن، لزوما جهت را تغییر نمی دهد.
یک نشانگر دارای ویژگی های زیر است:
- آلفا
- کدورت نشانگر را تنظیم می کند. پیشفرض 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 را بخوانید.
خلاصه کلاس تودرتو
@رابط | نشانگر. برخورد برخورد | نشاندهنده نحوه برخورد با نشانگر هنگام برخورد با نشانگرهای دیگر یا برچسبهای نقشه پایه است. |
خلاصه روش عمومی
بولی | |
شناور | getAlpha () آلفای نشانگر را می گیرد. |
رشته | getId () شناسه این نشانگر را دریافت می کند. |
LatLng | getPosition () موقعیت نشانگر را برمیگرداند. |
شناور | get Rotation () چرخش نشانگر را می گیرد. |
رشته | getSnippet () قطعه نشانگر را می گیرد. |
هدف - شی | getTag () برچسب نشانگر را دریافت می کند. |
رشته | getTitle () عنوان نشانگر را می گیرد. |
شناور | getZIndex () zIndex نشانگر را برمیگرداند. |
بین المللی | هش کد () |
خالی | hideInfoWindow () اگر پنجره اطلاعات از این نشانگر نشان داده شود، پنهان می شود. |
بولی | قابل کشیدن است () قابلیت کشش نشانگر را دریافت می کند. |
بولی | مسطح است () تنظیم مسطح نشانگر را دریافت می کند. |
بولی | isInfoWindowShown () نشان می دهد که آیا پنجره اطلاعات در حال حاضر بالای این نشانگر نشان داده شده است یا خیر. |
بولی | قابل مشاهده است () تنظیم نمایان بودن این نشانگر را دریافت می کند. |
خالی | حذف () این نشانگر را از نقشه حذف می کند. |
خالی | setAlpha (آلفا شناور) آلفا (مادر بودن) نشانگر را تنظیم می کند. |
خالی | setAnchor (لنگر شناور U، لنگر شناور V) نقطه لنگر را برای نشانگر تنظیم می کند. |
خالی | setDraggable (بولی قابل کشیدن) قابلیت کشیدن نشانگر را تنظیم می کند. |
خالی | setFlat (تخت بولی) تنظیم می کند که آیا این نشانگر باید در برابر نقشه true یا بیلبوردی که رو به دوربین false . |
خالی | |
خالی | setInfoWindowAnchor (لنگر شناور U، شناور لنگر V) نقطه ای را در تصویر نشانگر مشخص می کند که هنگام نمایش پنجره اطلاعات، آن را لنگر می اندازد. |
خالی | |
خالی | setRotation (چرخش شناور) چرخش نشانگر را بر حسب درجه در جهت عقربه های ساعت در مورد نقطه لنگر نشانگر تنظیم می کند. |
خالی | setSnippet (قطعه رشته) قطعه نشانگر را تنظیم می کند. |
خالی | setTag (برچسب شی) برچسب را برای نشانگر تنظیم می کند. |
خالی | setTitle (عنوان رشته) عنوان نشانگر را تنظیم می کند. |
خالی | setVisible (بولی قابل مشاهده) نمایان بودن این نشانگر را تنظیم می کند. |
خالی | setZIndex (zIndex شناور) zIndex نشانگر را تنظیم می کند. |
خالی | showInfoWindow () اگر این نشانگر isVisible() باشد، پنجره اطلاعات این نشانگر را روی نقشه نشان می دهد. |
خلاصه روش ارثی
روش های عمومی
بولین عمومی برابر است (Object other)
عمومی 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]). |
چرخش مجموعه خالی عمومی (چرخش شناور)
چرخش نشانگر را بر حسب درجه در جهت عقربه های ساعت در مورد نقطه لنگر نشانگر تنظیم می کند. محور چرخش عمود بر نشانگر است. چرخش 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 روی این نقشه نباشد |
---|