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

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

پلی لاین

کلاس نهایی عمومی 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 دریافت می‌کند GoogleMap.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 این چند خط را تنظیم می کند.

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

از کلاس java.lang.Object

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

روش های عمومی

بولین عمومی برابر است (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` ، هر بخش به عنوان یک خط مستقیم بر روی طرح مرکاتور رسم می شود.

public 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 این چند خط.