طراحی نقشه جدید به زودی به پلتفرم نقشه های گوگل ارائه می شود. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگ پیش‌فرض جدید و بهبودهایی در تجربیات نقشه و قابلیت استفاده است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

دایره

کلاس نهایی عمومی 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 را تنظیم می کند.

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

از کلاس java.lang.Object

بولی	برابر است (شیء arg0)
کلاس نهایی<?>	getClass ()
بین المللی	هش کد ()
باطل نهایی	اعلام کردن ()
باطل نهایی	اطلاع رسانی به همه ()
رشته	toString ()
باطل نهایی	صبر کنید (long arg0، int arg1)
باطل نهایی	صبر کنید (طولانی arg0)
باطل نهایی	صبر کن ()

روش های عمومی

عمومی 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	اگر عرض منفی باشد

عمومی void 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.