چندضلعی

public final class Polygon extends Object

چندضلعی روی سطح زمین. چندضلعی می‌تواند محدب یا مقعر باشد، ممکن است نصف‌النهار ۱۸۰ درجه را دربرگیرد، و می‌تواند سوراخ‌هایی داشته باشد که پر نشده‌اند. این ویژگی‌ها را دارد:

رئوس مطالب
طرح کلی با فهرستی از رئوس در جهت ساعت‌گرد یا پادساعت‌گرد مشخص می‌شود. لازم نیست نقاط شروع و پایان بر هم منطبق باشند؛ اگر منطبق نباشند، چندضلعی به‌طور خودکار بسته خواهد شد. پاره‌خط‌ها بین نقاط متوالی در جهت کوتاه‌تر از دو جهت (شرق یا غرب) کشیده می‌شوند.
حفره‌ها
حفره منطقه‌ای درون چندضلعی است که پر نشده است. حفره دقیقاً به همان روشی که طرح کلی مشخص می‌شود، مشخص می‌شود. حفره باید کاملاً درون طرح کلی قرار داشته باشد. چندین حفره را می‌توان مشخص کرد، اما حفره‌های هم‌پوشان پشتیبانی نمی‌شود.
ضخامت خط
عرض بخش خط در پیکسل‌های صفحه‌نمایش. عرض ثابت است و به سطح بزرگ‌نمایی دوربین بستگی ندارد. مقدار پیش‌فرض ۱۰ است.
رنگ خط پیرامونی
رنگ پاره‌خط در قالب 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 این چندضلعی را دریافت می‌کند.
قطع توپ
بولی
isClickable()
کلیک‌کردنی بودن چندضلعی را دریافت می‌کند.
بولی
isGeodesic()
دریافت می‌کند که آیا هر بخش خط به‌عنوان ژئودزیک ترسیم شده است یا نه.
بولی
isVisible()
رؤیت‌پذیری این چندضلعی را دریافت می‌کند.
باطل
remove()
چندضلعی را از نقشه برمی‌دارد.
باطل
setClickable(boolean clickable)
قابلیت کلیک چندضلعی را تنظیم می‌کند.
باطل
setFillColor(int color)
رنگ پرکننده این چندضلعی را تنظیم می‌کند.
باطل
setGeodesic(boolean geodesic)
تنظیم می‌کند که هر بخش خط به‌عنوان ژئودزیک ترسیم شود یا نه.
باطل
setHoles(List<? extends List<LatLng>> holes)
حفره‌های این چندضلعی را تنظیم می‌کند.
باطل
setPoints(List<LatLng> points)
نقاط این چندضلعی را تنظیم می‌کند.
باطل
setStrokeColor(int color)
رنگ خط این چندضلعی را تنظیم می‌کند.
باطل
setStrokeJointType(int jointType)
نوع اتصال را برای همه رأس‌های طرح کلی چندضلعی تنظیم می‌کند.
باطل
setStrokePattern(List<PatternItem> pattern)
الگوی خط چندضلعی را تنظیم می‌کند.
باطل
setStrokeWidth(float width)
ضخامت خط پیرامونی این چندضلعی را تنظیم می‌کند.
باطل
setTag(Object tag)
برچسب چندضلعی را تنظیم می‌کند.
باطل
setVisible(boolean visible)
رؤیت‌پذیری این چندضلعی را تنظیم می‌کند.
باطل
setZIndex(float zIndex)
zIndex این چندضلعی را تنظیم می‌کند.

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

روش‌های عمومی

public boolean equals (Object other)

بررسی می‌کند که آیا این Polygon با دیگری برابر است یا نه.

پارامترها
مورد دیگر یک Object.
بازگشتی‌ها
  • اگر هر دو شیء یکسان باشند، یعنی this == 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)

نوع اتصال را برای همه رأس‌های طرح کلی چندضلعی تنظیم می‌کند.

برای مقادیر مجاز، به JointType بروید. اگر نوع اتصال تعریف نشده باشد یا یکی از مقادیر مجاز نباشد، از مقدار پیش‌فرض DEFAULT استفاده خواهد شد.

پارامترها
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 این چندضلعی.