چندضلعی روی سطح زمین. چندضلعی میتواند محدب یا مقعر باشد، ممکن است نصفالنهار ۱۸۰ درجه را دربرگیرد، و میتواند سوراخهایی داشته باشد که پر نشدهاند. این ویژگیها را دارد:
- رئوس مطالب
- طرح کلی با فهرستی از رئوس در جهت ساعتگرد یا پادساعتگرد مشخص میشود. لازم نیست نقاط شروع و پایان بر هم منطبق باشند؛ اگر منطبق نباشند، چندضلعی بهطور خودکار بسته خواهد شد. پارهخطها بین نقاط متوالی در جهت کوتاهتر از دو جهت (شرق یا غرب) کشیده میشوند.
- حفرهها
- حفره منطقهای درون چندضلعی است که پر نشده است. حفره دقیقاً به همان روشی که طرح کلی مشخص میشود، مشخص میشود. حفره باید کاملاً درون طرح کلی قرار داشته باشد. چندین حفره را میتوان مشخص کرد، اما حفرههای همپوشان پشتیبانی نمیشود.
- ضخامت خط
- عرض بخش خط در پیکسلهای صفحهنمایش. عرض ثابت است و به سطح بزرگنمایی دوربین بستگی ندارد. مقدار پیشفرض ۱۰ است.
- رنگ خط پیرامونی
- رنگ پارهخط در قالب ARGB، همان قالبی که
Colorاستفاده میکند. مقدار پیشفرض سیاه (0xff000000) است. - نوع اتصال خط
- نوع اتصال شکلی را تعریف میکند که هنگام اتصال بخشهای خط مجاور در همه
رأسهای طرح کلی چندضلعی استفاده میشود. برای انواع مفصلهای پشتیبانیشده،
JointTypeرا ببینید. مقدار پیشفرضDEFAULTاست. - الگوی خط پیرامونی
- توپر (پیشفرض، با
nullنشان داده میشود) یا دنبالهای از اشیایPatternItemکه درطول طرح کلی چندضلعی تکرار میشود. انواعPatternItemدردسترس:Gap(تعریفشده براساس طول فاصله به پیکسل)،Dash(تعریفشده براساس پهنای خط و طول خط تیره به پیکسل)، وDot(دایرهای، متمرکز بر طرح کلی چندضلعی، قطر تعریفشده براساس پهنای خط به پیکسل). - رنگ پرکننده
- رنگ پرکننده در قالب ARGB، همان قالبی که
Colorاستفاده میکند. مقدار پیشفرض شفاف است (0x00000000). اگر هندسه چندضلعی بهدرستی مشخص نشده باشد (به «طرح کلی» و «حفرهها» در بالا مراجعه کنید)، هیچ رنگی برای پر کردن کشیده نخواهد شد. - Z-Index
- ترتیبی که این چندضلعی نسبت به سایر همپوشانیها، ازجمله
Polyline،Circle،GroundOverlay، وTileOverlay، اما نهMarker، ترسیم میشود. یک همپوشانی با شاخص z بزرگتر روی همپوشانیهایی با شاخصهای z کوچکتر کشیده میشود. ترتیب همپوشانیها با مقدار z-index یکسان اختیاری است. پیشفرض 0 است. - نمایان بودن
- نشان میدهد که چندضلعی نمایان است یا پنهان، یعنی آیا روی نقشه ترسیم شده است یا نه. چندضلعی نامرئی ترسیم نمیشود، اما همه ویژگیهای دیگرش را حفظ میکند. پیشفرض
true، یعنی نمایان است. - وضعیت ژئودزیک
- نشان میدهد که آیا بخشهای چندضلعی باید بهصورت ژئودزیک ترسیم شوند یا بهصورت خطوط مستقیم در تصویر مرکاتور. ژئودزیک کوتاهترین مسیر بین دو نقطه روی سطح زمین است. منحنی ژئودزیک با فرض اینکه زمین یک کره است ساخته میشود
- کلیککردنی
- اگر میخواهید رویدادهایی را که هنگام کلیک کردن کاربر روی چندضلعی فعال میشوند مدیریت کنید، این ویژگی را روی
trueتنظیم کنید. هرزمان خواستید میتوانید این مقدار را تغییر دهید. پیشفرضfalseاست. اگر این ویژگی رویtrueتنظیم شده باشد، برنامهتان اعلانها را درGoogleMap.OnPolygonClickListenerثبتشده ازطریقsetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)دریافت خواهد کرد. - برچسب
Objectمرتبط با چندضلعی. برای مثال،Objectمیتواند حاوی دادههایی درباره آنچه چندضلعی نشان میدهد باشد. این کار از ذخیره کردنMap<Polygon, Object>جداگانه آسانتر است. بهعنوان مثالی دیگر، میتوانید شناسهStringرا به شناسه مربوطه از مجموعه داده منسوب کنید. کیت توسعه نرمافزار Google Maps برای Android این ویژگی را نه میخواند و نه مینویسد.
روشهای این کلاس باید در رشته میانای کاربر Android فراخوانی شوند. درغیراینصورت، IllegalStateException در زمان اجرا ایجاد خواهد شد.
مثال
GoogleMap map;
// ... get a map.
// Add a triangle in the Gulf of Guinea
Polygon polygon = map.addPolygon(new PolygonOptions()
.add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
.strokeColor(Color.RED)
.fillColor(Color.BLUE));
راهنمای توسعهدهندگان
برای اطلاعات بیشتر، راهنمای توسعهدهنده اشکال را بخوانید.
خلاصه روش عمومی
| بولی |
برابر است با(شیء دیگر)
بررسی میکند که آیا این
Polygon با دیگری برابر است یا نه. |
| قطع توپ |
getFillColor()
رنگ پرکننده این چندضلعی را دریافت میکند.
|
| List<List<LatLng>> |
getHoles()
نمای آنی از حفرههای این چندضلعی را در این زمان برمیگرداند .
|
| رشته |
getId()
شناسه این چندضلعی را دریافت میکند.
|
| List<LatLng> |
getPoints()
نمای آنی از رأسهای این چندضلعی را در این زمان برمیگرداند .
|
| قطع توپ |
getStrokeColor()
رنگ قلمضربه این چندضلعی را دریافت میکند.
|
| قطع توپ |
getStrokeJointType()
نوع اتصال خطی را که در همه رأسهای طرح کلی چندضلعی استفاده میشود دریافت میکند.
|
| List<PatternItem> |
getStrokePattern()
الگوی قلمضربه طرح کلی این چندضلعی را دریافت میکند.
|
| شناور |
getStrokeWidth()
ضخامت خط پیرامونی این چندضلعی را دریافت میکند.
|
| شیء |
getTag()
برچسب چندضلعی را دریافت میکند.
|
| شناور |
getZIndex()
zIndex این چندضلعی را دریافت میکند.
|
| قطع توپ |
hashCode()
|
| بولی |
isClickable()
کلیککردنی بودن چندضلعی را دریافت میکند.
|
| بولی |
isGeodesic()
دریافت میکند که آیا هر بخش خط بهعنوان ژئودزیک ترسیم شده است یا نه.
|
| بولی |
isVisible()
رؤیتپذیری این چندضلعی را دریافت میکند.
|
| باطل |
remove()
چندضلعی را از نقشه برمیدارد.
|
| باطل |
setClickable(boolean clickable)
قابلیت کلیک چندضلعی را تنظیم میکند.
|
| باطل |
setFillColor(int color)
رنگ پرکننده این چندضلعی را تنظیم میکند.
|
| باطل |
setGeodesic(boolean geodesic)
تنظیم میکند که هر بخش خط بهعنوان ژئودزیک ترسیم شود یا نه.
|
| باطل | |
| باطل | |
| باطل |
setStrokeColor(int color)
رنگ خط این چندضلعی را تنظیم میکند.
|
| باطل |
setStrokeJointType(int jointType)
نوع اتصال را برای همه رأسهای طرح کلی چندضلعی تنظیم میکند.
|
| باطل | |
| باطل |
setStrokeWidth(float width)
ضخامت خط پیرامونی این چندضلعی را تنظیم میکند.
|
| باطل |
setTag(Object tag)
برچسب چندضلعی را تنظیم میکند.
|
| باطل |
setVisible(boolean visible)
رؤیتپذیری این چندضلعی را تنظیم میکند.
|
| باطل |
setZIndex(float zIndex)
zIndex این چندضلعی را تنظیم میکند.
|
خلاصه روش موروثی
روشهای عمومی
public boolean equals (Object other)
public int getFillColor ()
رنگ پرکننده این چندضلعی را دریافت میکند.
بازگشتیها
- رنگ در قالب ARGB.
public List<List<LatLng>> getHoles ()
عکس آنی از حفرههای این چندضلعی را در این زمان برمیگرداند . فهرست برگرداندهشده کپیای از فهرست حفرهها است و بنابراین تغییرات در حفرههای چندضلعی در این فهرست منعکس نخواهد شد، و تغییرات در این فهرست نیز در چندضلعی منعکس نخواهد شد.
public String getId ()
شناسه این چندضلعی را دریافت میکند. این شناسه در میان همه «چندضلعیها» در نقشه منحصربهفرد خواهد بود.
public List<LatLng> getPoints ()
نمای آنی از رأسهای این چندضلعی را در این زمان برمیگرداند . فهرست برگرداندهشده کپیای از فهرست رأسها است و بنابراین تغییرات در رأسهای چندضلعی در این فهرست منعکس نخواهد شد، و تغییرات در این فهرست نیز در چندضلعی منعکس نخواهد شد. برای تغییر دادن رئوس چندضلعی، setPoints(List) را فراخوانی کنید.
public int getStrokeColor ()
رنگ قلمضربه این چندضلعی را دریافت میکند.
بازگشتیها
- رنگ در قالب ARGB.
public int getStrokeJointType ()
نوع اتصال خطی را که در همه رأسهای طرح کلی چندضلعی استفاده میشود دریافت میکند. برای مقادیر احتمالی، به JointType
مراجعه کنید.
بازگشتیها
- نوع اتصال خط.
public List<PatternItem> getStrokePattern ()
الگوی قلمضربه طرح کلی این چندضلعی را دریافت میکند.
بازگشتیها
- الگوی ضربه.
public float getStrokeWidth ()
ضخامت خط پیرامونی این چندضلعی را دریافت میکند.
بازگشتیها
- عرض به پیکسلهای صفحه.
public Object getTag ()
برچسب چندضلعی را دریافت میکند.
بازگشتیها
- برچسب اگر برچسبی با
setTagتنظیم شده باشد؛nullاگر برچسبی تنظیم نشده باشد.
public float getZIndex ()
zIndex این چندضلعی را دریافت میکند.
بازگشتیها
- zIndex چندضلعی.
public int hashCode ()
public boolean isClickable ()
کلیککردنی بودن چندضلعی را دریافت میکند. اگر چندضلعی قابلکلیک باشد، وقتی کاربر روی چندضلعی کلیک کند، برنامهتان اعلانهایی در GoogleMap.OnPolygonClickListener دریافت خواهد کرد.
شنونده رویداد ازطریق setOnPolygonClickListener(GoogleMap.OnPolygonClickListener) ثبت شده است.
بازگشتیها
trueاگر چندضلعی قابلکلیک باشد؛ درغیراینصورت،falseرا برمیگرداند.
public boolean isGeodesic ()
دریافت میکند که آیا هر بخش خط بهعنوان ژئودزیک ترسیم شده است یا نه.
بازگشتیها
trueاگر هر بخش بهعنوان ژئودزیک ترسیم شده باشد؛falseاگر هر بخش بهعنوان خط مستقیم در تصویر مرکاتور ترسیم شده باشد.
public boolean isVisible ()
رؤیتپذیری این چندضلعی را دریافت میکند.
بازگشتیها
- رؤیتپذیری این چندضلعی.
public void remove ()
چندضلعی را از نقشه برمیدارد. پساز برداشته شدن چندضلعی، رفتار همه روشهای آن تعریفنشده است.
public void setClickable (boolean clickable)
قابلیت کلیک چندضلعی را تنظیم میکند. اگر چندضلعی قابلکلیک باشد، وقتی کاربر روی چندضلعی کلیک کند، برنامهتان اعلانهایی در GoogleMap.OnPolygonClickListener دریافت خواهد کرد.
شنونده رویداد ازطریق setOnPolygonClickListener(GoogleMap.OnPolygonClickListener) ثبت شده است.
پارامترها
| کلیککردنی | تنظیم جدید قابلیت کلیک برای چندضلعی. |
|---|
public void setFillColor (int color)
رنگ پرکننده این چندضلعی را تنظیم میکند.
پارامترها
| رنگ | رنگ در قالب ARGB |
|---|
public void setGeodesic (boolean geodesic)
تنظیم میکند که هر بخش خط بهعنوان ژئودزیک ترسیم شود یا نه.
پارامترها
| ژئودزیک | اگر true باشد، هر بخش بهعنوان ژئودزیک ترسیم میشود؛ اگر false باشد،
هر بخش بهعنوان خط مستقیم در تصویر مرکاتور ترسیم میشود.
|
|---|
public void setHoles (List<? extends List<LatLng>> holes)
حفرههای این چندضلعی را تنظیم میکند. این روش نسخهای از حفرهها را میگیرد، بنابراین جهشهای بعدی
در holes تأثیری بر این چندضلعی نخواهد داشت.
پارامترها
| حفرهها | فهرستی از حفرهها، که هر حفره فهرستی از LatLng است.
|
|---|
public void setPoints (List<LatLng> points)
نقاط این چندضلعی را تنظیم میکند. این روش نسخهای از نقاط را میگیرد، بنابراین تغییرات بعدی
در points تأثیری بر این چندضلعی نخواهد داشت.
پارامترها
| امتیاز | فهرستی از LatLngها که رأسهای چندضلعی هستند.
|
|---|
public void setStrokeColor (int color)
رنگ خط این چندضلعی را تنظیم میکند.
پارامترها
| رنگ | رنگ در قالب ARGB |
|---|
public void setStrokeJointType (int jointType)
public void setStrokePattern (List<PatternItem> pattern)
الگوی خط چندضلعی را تنظیم میکند. الگوی پیشفرض خط، ممتد است که با null نشان داده میشود.
پارامترها
| الگو | الگوی ضربه. |
|---|
public void setStrokeWidth (float width)
ضخامت خط پیرامونی این چندضلعی را تنظیم میکند.
پارامترها
| عرض | عرض به پیکسل نمایشگر. |
|---|
public void setTag (Object tag)
برچسب چندضلعی را تنظیم میکند.
میتوانید از این ویژگی برای مرتبط کردن یک Object دلخواه با این چندضلعی استفاده کنید. برای مثال، Object میتواند حاوی دادههایی درباره آنچه چندضلعی نشان میدهد باشد. این کار آسانتر از ذخیره کردن Map<Polygon, Object> جداگانه است. بهعنوان مثالی دیگر، میتوانید شناسه
String را که با شناسه مجموعه داده مطابقت دارد منسوب کنید. کیت توسعه نرمافزار Google Maps برای Android این ویژگی را نه میخواند و نه مینویسد. مسئولیت فراخوانی setTag(null) برای پاک کردن برچسب زمانی که دیگر به آن نیاز ندارید برعهده شما است تا از نشت حافظه در برنامهتان جلوگیری شود.
پارامترها
| برچسب | اگر تهی باشد، برچسب پاک میشود. |
|---|
public void setVisible (boolean visible)
رؤیتپذیری این چندضلعی را تنظیم میکند. وقتی چندضلعی نمایان نباشد، ترسیم نمیشود، اما همه ویژگیهای دیگرش را حفظ میکند.
پارامترها
| قابل رؤیت | اگر true باشد، چندضلعی نمایان است؛ اگر false باشد، نمایان نیست.
|
|---|
public void setZIndex (float zIndex)
zIndex این چندضلعی را تنظیم میکند. چندضلعیهای دارای zIndices بالاتر بالای چندضلعیهای دارای شاخصهای پایینتر ترسیم میشوند.
پارامترها
| zIndex | zIndex این چندضلعی. |
|---|