پلی لاین

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

چند خط فهرستی از نقاط است که در آن پاره خط بین نقاط متوالی رسم می شود. یک پلی لاین دارای ویژگی های زیر است:

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

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

مثال 

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));

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

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

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

بولی
برابر است (ابژه دیگر)
آزمایش می کند که آیا این Polyline با دیگری برابر است یا خیر.
بین المللی
getColor ()
رنگ این چند خط را می گیرد.
سرپوش
getEndCap ()
سرپوش انتهایی این چند خط را می گیرد.
رشته
getId ()
شناسه این چند خط را دریافت می کند.
بین المللی
getJointType ()
نوع اتصال مورد استفاده در تمام رئوس چند خط به جز رئوس شروع و پایان را دریافت می کند.
فهرست < PatternItem >
getPattern ()
الگوی ضربه ای این چند خط را می گیرد.
لیست< LatLng >
دریافت امتیاز ()
یک عکس فوری از رئوس این چندخط در این زمان برمی‌گرداند.
سرپوش
getStartCap ()
کلاهک را در راس شروع این چند خط می گیرد.
شیء
getTag ()
برچسب پلی لاین را دریافت می کند.
شناور
getWidth ()
عرض این چند خط را بدست می آورد.
شناور
getZIndex ()
zIndex این چند خط را دریافت می کند.
بین المللی
هش کد ()
بولی
قابل کلیک است ()
قابلیت کلیک روی چند خط را دریافت می کند.
بولی
is Geodesic ()
نشان می دهد که آیا هر بخش از خط به عنوان ژئودزیک رسم شده است یا خیر.
بولی
قابل مشاهده است ()
دید این چند خط را دریافت می کند.
باطل
حذف ()
این چند خط را از نقشه حذف می کند.
باطل
setClickable (قابل کلیک بولی)
قابلیت کلیک روی چند خط را تنظیم می کند.
باطل
setColor (int color)
رنگ این چند خط را تنظیم می کند.
باطل
setEndCap ( Cap endCap)
کلاهک را در راس انتهایی این چند خط قرار می دهد.
باطل
setGeodesic (ژئودزیک بولی)
تعیین می کند که آیا هر پاره خط به عنوان ژئودزیک رسم شود یا خیر.
باطل
setJointType (int jointType)
نوع اتصال را برای همه رئوس چند خط به جز رئوس شروع و پایان تنظیم می کند.
باطل
setPattern (List< PatternItem > pattern)
الگوی ضربه ای چند خط را تنظیم می کند.
باطل
setPoints (List< LatLng > points)
نقاط این چند خط را تنظیم می کند.
باطل
setSpans (List< StyleSpan > spans)
دهانه های چند خط را تنظیم می کند.
باطل
setStartCap ( Cap startCap)
کلاهک را در راس شروع این چند خط قرار می دهد.
باطل
setTag (برچسب شی)
برچسب را برای چند خط تنظیم می کند.
باطل
setVisible (بولی قابل مشاهده)
نمایان بودن این چند خط را تنظیم می کند.
باطل
setWidth (عرض شناور)
عرض این چند خط را تنظیم می کند.
باطل
setZIndex (zIndex شناور)
zIndex این چند خط را تنظیم می کند.

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

روش های عمومی

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

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

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

عمومی int getColor ()

رنگ این چند خط را می گیرد.

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

کلاه عمومی getEndCap ()

سرپوش انتهایی این چند خط را می گیرد.

برمی گرداند
  • نوع کلاهک انتهایی

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

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

برمی گرداند
  • شناسه این چند خط

عمومی int getJointType ()

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

برمی گرداند
  • نوع مفصل

فهرست عمومی< PatternItem > getPattern ()

الگوی ضربه ای این چند خط را می گیرد.

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

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

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

کلاه عمومی getStartCap ()

کلاهک را در راس شروع این چند خط می گیرد.

برمی گرداند
  • کلاه شروع

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

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

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

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

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

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

عمومی float getZIndex ()

zIndex این چند خط را دریافت می کند.

برمی گرداند
  • zIndex چند خط.

هش کد عمومی ()

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

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

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

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

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

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

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

دید این چند خط را دریافت می کند.

برمی گرداند
  • دید این چند خط

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

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

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

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

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

public void setColor (int color)

رنگ این چند خط را تنظیم می کند.

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

public void setEndCap ( Cap endCap)

کلاهک را در راس انتهایی این چند خط قرار می دهد. سرپوش انتهایی پیش فرض ButtCap ​​است.

پارامترها
endCap کلاهک انتهایی نباید null باشد.

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

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

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

عمومی void setJointType (int jointType)

نوع اتصال را برای همه رئوس چند خط به جز رئوس شروع و پایان تنظیم می کند.

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

پارامترها
jointType نوع مفصل

setPattern void عمومی (List< PatternItem > pattern)

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

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

setPoints خالی عمومی (List< LatLng > points)

نقاط این چند خط را تنظیم می کند. این روش یک کپی از نقاط را می گیرد، بنابراین جهش های بیشتر به points هیچ تاثیری روی این چند خط نخواهد داشت.

پارامترها
امتیاز لیستی از LatLng ها که رئوس چند خط هستند.

setSpans خالی عمومی (List< StyleSpan > spans)

دهانه های چند خط را تنظیم می کند.

پارامترها
دهانه می کند

public void setStartCap ( Cap startCap)

کلاهک را در راس شروع این چند خط قرار می دهد. سرپوش شروع پیش فرض ButtCap ​​است.

پارامترها
startCap کلاه شروع نباید null باشد.

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

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

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

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

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

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

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

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

عرض این چند خط را تنظیم می کند.

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

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

zIndex این چند خط را تنظیم می کند. چندخطوط با اندیس z بالاتر بالای خطوط با اندیس کمتر رسم می شوند.

پارامترها
zIndex zIndex این چند خط.