چند ضلعی

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

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

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

متدهای این کلاس باید در رشته رابط کاربری اندروید فراخوانی شوند. اگر نه، یک 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));

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

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

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

بولی
برابر است (ابژه دیگر)
آزمایش می کند که آیا این Polygon با دیگری برابر است یا خیر.
بین المللی
getFillColor ()
رنگ پر شده این چند ضلعی را دریافت می کند.
List<List< LatLng >>
getHoles ()
یک عکس فوری از سوراخ های این چند ضلعی را در این زمان برمی گرداند.
رشته
getId ()
شناسه این چند ضلعی را دریافت می کند.
فهرست < LatLng >
دریافت امتیاز ()
یک عکس فوری از رئوس این چندضلعی در این زمان برمی‌گرداند.
بین المللی
getStrokeColor ()
رنگ ضربه ای این چند ضلعی را می گیرد.
بین المللی
getStrokeJointType ()
نوع اتصال سکته مغزی مورد استفاده در تمام رئوس طرح کلی چندضلعی را دریافت می کند.
فهرست < PatternItem >
getStrokePattern ()
الگوی سکته مغزی طرح کلی این چندضلعی را دریافت می کند.
شناور
getStrokeWidth ()
عرض حرکت این چند ضلعی را بدست می آورد.
شیء
getTag ()
برچسب چند ضلعی را دریافت می کند.
شناور
getZIndex ()
zIndex این چند ضلعی را دریافت می کند.
بین المللی
هش کد ()
بولی
قابل کلیک است ()
قابلیت کلیک چند ضلعی را دریافت می کند.
بولی
is Geodesic ()
نشان می دهد که آیا هر بخش از خط به عنوان ژئودزیک رسم شده است یا خیر.
بولی
قابل مشاهده است ()
دید این چند ضلعی را دریافت می کند.
باطل
حذف ()
چند ضلعی را از نقشه حذف می کند.
باطل
setClickable (قابل کلیک بولی)
قابلیت کلیک چند ضلعی را تنظیم می کند.
باطل
setFillColor (رنگ int)
رنگ پر کردن این چند ضلعی را تنظیم می کند.
باطل
setGeodesic (ژئودزیک بولی)
تعیین می کند که آیا هر پاره خط به عنوان ژئودزیک رسم شود یا خیر.
باطل
setHoles (List<? List< LatLng >> سوراخ ها را گسترش می دهد)
سوراخ های این چند ضلعی را تنظیم می کند.
باطل
setPoints (List< LatLng > points)
نقاط این چند ضلعی را تنظیم می کند.
باطل
setStrokeColor (رنگ int)
رنگ ضربه ای این چند ضلعی را تنظیم می کند.
باطل
setStrokeJointType (int jointType)
نوع اتصال را برای همه رئوس طرح کلی چندضلعی تنظیم می کند.
باطل
setStrokePattern (List< PatternItem > pattern)
الگوی سکته مغزی طرح کلی چندضلعی را تنظیم می کند.
باطل
setStrokeWidth (عرض شناور)
عرض سکته مغزی این چند ضلعی را تنظیم می کند.
باطل
setTag (برچسب شی)
تگ را برای چند ضلعی تنظیم می کند.
باطل
setVisible (بولی قابل مشاهده)
نمایان بودن این چند ضلعی را تنظیم می کند.
باطل
setZIndex (zIndex شناور)
zIndex این چند ضلعی را تنظیم می کند.

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

روش های عمومی

بولین عمومی برابر است (Object other)

آزمایش می کند که آیا این Polygon با دیگری برابر است یا خیر.

پارامترها
دیگر یک Object .
برمی گرداند
  • درست است اگر هر دو شیء یک شی باشند، یعنی این == دیگری.

عمومی int getFillColor ()

رنگ پر شده این چند ضلعی را دریافت می کند.

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

فهرست عمومی<List< LatLng >> getHoles ()

یک عکس فوری از سوراخ های این چند ضلعی را در این زمان برمی گرداند. لیست برگشتی یک کپی از لیست حفره ها است و بنابراین تغییرات در سوراخ های چند ضلعی توسط این لیست منعکس نمی شود و همچنین تغییرات این لیست توسط چند ضلعی منعکس نمی شود.

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

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

لیست عمومی< LatLng > getPoints ()

یک عکس فوری از رئوس این چندضلعی در این زمان برمی‌گرداند. لیستی که برگردانده می شود کپی لیست رئوس است و بنابراین تغییرات در رئوس چند ضلعی توسط این لیست منعکس نمی شود و همچنین تغییرات این لیست توسط چند ضلعی منعکس نمی شود. برای تغییر رئوس چند ضلعی، setPoints(List) را فراخوانی کنید.

عمومی int getStrokeColor ()

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

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

عمومی int getStrokeJointType ()

نوع اتصال سکته مغزی مورد استفاده در تمام رئوس طرح کلی چندضلعی را دریافت می کند. برای مقادیر ممکن به JointType مراجعه کنید.

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

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

الگوی سکته مغزی طرح کلی این چندضلعی را دریافت می کند.

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

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

عرض این چند ضلعی را بدست می آورد.

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

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

برچسب چند ضلعی را دریافت می کند.

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

عمومی float getZIndex ()

zIndex این چند ضلعی را دریافت می کند.

برمی گرداند
  • zIndex چند ضلعی

هش کد عمومی ()

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

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

برمی گرداند
  • true اگر چند ضلعی قابل کلیک باشد. در غیر این صورت، false را برمی گرداند.

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

نشان می دهد که آیا هر بخش از خط به عنوان ژئودزیک رسم شده است یا خیر.

برمی گرداند
  • true اگر هر بخش به عنوان یک ژئودزیک ترسیم شود. اگر هر پاره به صورت یک خط مستقیم روی برجستگی Mercator رسم شود، false .

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

دید این چند ضلعی را دریافت می کند.

برمی گرداند
  • این دید چند ضلعی

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

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

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

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

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

public void setFillColor (int color)

رنگ پر کردن این چند ضلعی را تنظیم می کند.

پارامترها
رنگ رنگ در فرمت ARGB

مجموعه خالی عمومی Geodesic (ژئودزیک بولی)

تعیین می کند که آیا هر پاره خط به عنوان ژئودزیک رسم شود یا خیر.

پارامترها
ژئودزیک اگر true ، هر بخش به عنوان یک ژئودزیک ترسیم می شود. اگر false ، هر بخش به عنوان یک خط مستقیم بر روی طرح مرکاتور رسم می شود.

setHoles خالی عمومی (List<? List< LatLng >> سوراخ ها را گسترش می دهد)

سوراخ های این چند ضلعی را تنظیم می کند. این روش یک کپی از سوراخ ها را می گیرد، بنابراین جهش های بیشتر به holes هیچ تاثیری بر این چند ضلعی نخواهد داشت.

پارامترها
سوراخ ها فهرستی از حفره ها، که در آن سوراخ، فهرستی از LatLng s است.

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)

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

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

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

عرض سکته مغزی این چند ضلعی را تنظیم می کند.

پارامترها
عرض عرض در پیکسل های نمایشگر

عمومی void setTag (برچسب شی)

تگ را برای چند ضلعی تنظیم می کند.

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

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

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

نمایان بودن این چند ضلعی را تنظیم می کند. هنگامی که قابل مشاهده نیست، یک چند ضلعی ترسیم نمی شود، اما تمام خصوصیات دیگر خود را حفظ می کند.

پارامترها
قابل مشاهده است اگر true ، چند ضلعی قابل مشاهده است. اگر false باشد، نیست.

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

zIndex این چند ضلعی را تنظیم می کند. چند ضلعی های با اندیس z بالاتر بالاتر از آن هایی با اندیس های پایین تر رسم می شوند.

پارامترها
zIndex zIndex این چند ضلعی