دایره

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

دایره ای روی سطح زمین (کلاهک کروی).

یک دایره دارای ویژگی های زیر است.

مرکز
مرکز دایره به عنوان LatLng مشخص شده است.
شعاع
شعاع دایره، بر حسب متر مشخص شده است. باید صفر یا بیشتر باشد.
عرض سکته مغزی
عرض طرح دایره در پیکسل های صفحه نمایش. عرض ثابت و مستقل از سطح زوم دوربین است. مقدار پیش فرض 10 است.
رنگ سکته مغزی
رنگ طرح دایره در قالب ARGB، همان قالبی که توسط Color استفاده می‌شود. مقدار پیش فرض سیاه است ( 0xff000000 ).
الگوی سکته مغزی
جامد (پیش‌فرض، با null نشان داده می‌شود) یا دنباله‌ای از اشیاء PatternItem که باید در امتداد طرح دایره تکرار شوند. انواع PatternItem موجود: Gap (تعریف شده با طول شکاف بر حسب پیکسل)، Dash (تعریف شده با عرض و طول خط تیره بر حسب پیکسل) و Dot (دایره، در مرکز طرح دایره، قطر تعیین شده با عرض ضربه به پیکسل).
رنگ را پر کنید
رنگ دایره در قالب ARGB پر می شود، همان قالبی که توسط Color استفاده می شود. مقدار پیش فرض شفاف است ( 0x00000000 ).
Z-Index
ترتیب ترسیم این روکش کاشی با توجه به پوشش های دیگر (از جمله GroundOverlay s، TileOverlay s، Polyline s، و Polygon s اما نه Marker s). یک پوشش با شاخص z بزرگتر روی همپوشانی با شاخص های z کوچکتر کشیده می شود. ترتیب همپوشانی ها با شاخص z یکسان دلخواه است. zIndex پیش فرض 0 است.
دید
نشان می دهد که دایره قابل مشاهده است یا نامرئی، یعنی روی نقشه کشیده شده است. یک دایره نامرئی رسم نمی شود، اما تمام خصوصیات دیگر خود را حفظ می کند. پیش فرض true است، یعنی قابل مشاهده است.
برچسب بزنید
یک Object مرتبط با دایره. برای مثال، Object می تواند حاوی داده هایی در مورد آنچه دایره نشان می دهد باشد. این آسان تر از ذخیره کردن یک Map<Circle, Object> . به عنوان مثال دیگر، می توانید یک شناسه String مربوط به شناسه را از یک مجموعه داده مرتبط کنید. Google Maps SDK برای اندروید این ویژگی را نه می‌خواند و نه می‌نویسد.

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

مثال 

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

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

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

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

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

LatLng
getCenter ()
مرکز را به عنوان LatLng برمی‌گرداند.
بین المللی
getFillColor ()
رنگ پر شدن این دایره را برمی گرداند.
رشته
getId ()
شناسه این حلقه را دریافت می کند.
دو برابر کردن
getRadius ()
شعاع دایره را بر حسب متر برمی‌گرداند.
بین المللی
getStrokeColor ()
رنگ ضربه ای را برمی گرداند.
فهرست < PatternItem >
getStrokePattern ()
الگوی سکته مغزی طرح کلی این دایره را برمی گرداند.
شناور
getStrokeWidth ()
عرض ضربه را برمی‌گرداند.
شیء
getTag ()
برچسب دایره را دریافت می کند.
شناور
getZIndex ()
zIndex را برمی گرداند.
بولی
قابل کلیک است ()
قابلیت کلیک دایره را دریافت می کند.
بولی
قابل مشاهده است ()
بررسی می کند که آیا دایره قابل مشاهده است یا خیر.
باطل
حذف ()
این دایره را از نقشه حذف می کند.
باطل
setCenter (مرکز LatLng )
مرکز را با استفاده از LatLng تنظیم می کند.
باطل
setClickable (قابل کلیک بولی)
قابلیت کلیک دایره را تنظیم می کند.
باطل
setFillColor (رنگ int)
رنگ پر را تنظیم می کند.
باطل
setRadius (شعاع دوگانه)
شعاع را بر حسب متر تنظیم می کند.
باطل
setStrokeColor (رنگ int)
رنگ ضربه ای را تنظیم می کند.
باطل
setStrokePattern (List< PatternItem > pattern)
الگوی سکته مغزی طرح کلی دایره را تنظیم می کند.
باطل
setStrokeWidth (عرض شناور)
عرض ضربه را تنظیم می کند.
باطل
setTag (برچسب شی)
برچسب را برای دایره تنظیم می کند.
باطل
setVisible (بولی قابل مشاهده)
نمایان بودن دایره را تنظیم می کند.
باطل
setZIndex (zIndex شناور)
zIndex را تنظیم می کند.

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

روش های عمومی

عمومی LatLng getCenter ()

مرکز را به عنوان LatLng برمی‌گرداند.

برمی گرداند
  • مرکز جغرافیایی به عنوان LatLng .

عمومی int getFillColor ()

رنگ پر شدن این دایره را برمی گرداند.

برمی گرداند
  • رنگ پر کردن دایره در قالب ARGB.

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

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

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

شعاع دایره را بر حسب متر برمی‌گرداند.

برمی گرداند
  • شعاع بر حسب متر

عمومی int getStrokeColor ()

رنگ ضربه ای را برمی گرداند.

برمی گرداند
  • رنگ دایره در فرمت ARGB.

لیست عمومی< PatternItem > getStrokePattern ()

الگوی سکته مغزی طرح کلی این دایره را برمی گرداند.

برمی گرداند
  • الگوی سکته مغزی

شناور عمومی getStrokeWidth ()

عرض ضربه را برمی‌گرداند.

برمی گرداند
  • عرض در پیکسل های صفحه نمایش

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

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

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

عمومی float getZIndex ()

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

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

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

قابلیت کلیک دایره را دریافت می کند. اگر دایره قابل کلیک باشد، برنامه شما اعلان هایی را به GoogleMap.OnCircleClickListener دریافت می کند که کاربر روی دایره کلیک کند. شنونده رویداد از طریق setOnCircleClickListener(GoogleMap.OnCircleClickListener) ثبت می شود.

برمی گرداند
  • true اگر دایره قابل کلیک باشد. false اگر قابل کلیک نباشد.

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

بررسی می کند که آیا دایره قابل مشاهده است یا خیر.

برمی گرداند
  • اگر دایره قابل مشاهده باشد true . اگر نامرئی باشد false است.

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

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

Public Void setCenter (مرکز LatLng )

مرکز را با استفاده از LatLng تنظیم می کند.

مرکز نباید null باشد، زیرا مقدار پیش فرض وجود ندارد.

پارامترها
مرکز مرکز جغرافیایی دایره که به عنوان LatLng مشخص شده است.
پرتاب می کند
NullPointerException اگر مرکز صفر باشد

public void setClickable (قابل کلیک بولین)

قابلیت کلیک دایره را تنظیم می کند. اگر دایره قابل کلیک باشد، برنامه شما اعلان هایی را به GoogleMap.OnCircleClickListener دریافت می کند که کاربر روی دایره کلیک کند. شنونده رویداد از طریق setOnCircleClickListener(GoogleMap.OnCircleClickListener) ثبت می شود.

پارامترها
قابل کلیک تنظیم جدید قابلیت کلیک برای دایره.

public void setFillColor (int color)

رنگ پر را تنظیم می کند.

رنگ پر، رنگ داخل دایره است، در قالب عدد صحیح که توسط Color مشخص شده است. اگر از TRANSPARENT استفاده شود، هیچ پرکننده ای کشیده نمی شود.

پارامترها
رنگ رنگ در فرمت Color .

مجموعه فضای خالی عمومی رادیوس (شعاع دوگانه)

شعاع را بر حسب متر تنظیم می کند.

شعاع باید صفر یا بیشتر باشد.

پارامترها
شعاع شعاع، بر حسب متر
پرتاب می کند
IllegalArgumentException اگر شعاع منفی باشد

public void setStrokeColor (int color)

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

رنگ Stroke رنگ طرح کلی این دایره است، در قالب عدد صحیح مشخص شده توسط Color . اگر از TRANSPARENT استفاده شود، هیچ طرح کلی ترسیم نمی شود.

پارامترها
رنگ رنگ سکته مغزی در قالب Color .

public void setStrokePattern (List< PatternItem > pattern)

الگوی سکته مغزی طرح دایره را تنظیم می کند. الگوی stroke پیش فرض جامد است که با null نشان داده می شود.

پارامترها
الگوی الگوی سکته مغزی

public void setStrokeWidth (عرض شناور)

عرض ضربه را تنظیم می کند.

عرض سکته مغزی، عرض (بر حسب پیکسل صفحه) طرح دایره است. باید صفر یا بیشتر باشد. اگر صفر باشد، هیچ طرح کلی ترسیم نمی شود. مقدار پیش فرض 10 است.

پارامترها
عرض عرض سکته مغزی، در پیکسل های صفحه نمایش.
پرتاب می کند
IllegalArgumentException اگر عرض منفی باشد

setTag خالی عمومی (برچسب شی)

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

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

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

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

نمایان بودن دایره را تنظیم می کند.

اگر این دایره قابل مشاهده نباشد رسم نمی شود. تمام حالت های دیگر حفظ می شود. حلقه ها به طور پیش فرض قابل مشاهده هستند.

پارامترها
قابل مشاهده است true تا این دایره قابل مشاهده باشد. false تا آن را نامرئی کند.

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

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

هم‌پوشانی‌ها (مانند دایره‌هایی) با شاخص‌های z بالاتر، بالای دایره‌هایی با شاخص‌های پایین‌تر کشیده می‌شوند.

پارامترها
zIndex مقدار zIndex.