.
الخط المتعدد هو قائمة من النقاط يتم فيها رسم أجزاء من الخط بين نقاط متتابعة. ويضم الخط المتعدد السمات السمات التالية:
- النقاط
- رؤوس الخط. يتم رسم المقاطع الخطية بين نقاط متتالية. لا يتم إغلاق الخطوط المتعددة تلقائيًا، ولكن لإنشاء خط متعدد مغلق، يجب أن تكون نقطتا البداية والنهاية متطابقتين.
- العرض
- عرض القطع الخطية بوحدات بكسل الشاشة يكون العرض ثابتًا ومستقلًا عن مستوى تكبير/تصغير الكاميرا. القيمة التلقائية هي 10.
- اللون
- لون الجزء من الخط بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في
Color
. القيمة التلقائية هي الأسود (0xff000000
). - حد أقصى البداية/النهاية
- تحدد الشكل الذي سيتم استخدامه في بداية أو نهاية الخط المتعدد. أنواع الأحرف الاستهلالية المسموح بها:
ButtCap
وSquareCap
وRoundCap
(يسري ذلك على نمط الكتابة بخط اليد) وCustomCap
(يسري ذلك على أي نمط للرسم). الإعداد التلقائي لكل من البداية والنهاية:ButtCap
. - نوع المفصل
- يحدِّد نوع الموصّل الشكل الذي يجب استخدامه عند ضم أجزاء الخط المتجاورة في جميع رؤوس الخط المتعدد باستثناء رأسَي البداية والنهاية. يُرجى الاطّلاع على
JointType
للتعرّف على أنواع المفاصل المتوافقة. القيمة التلقائية هيDEFAULT
. - نمط الكتابة
- رقم صلب (يتم تمثيله بالرمز
null
) أو تسلسل من عناصرPatternItem
يتم تكراره على طول الخط. أنواعPatternItem
المتاحة:Gap
(محدّدة حسب طول الفجوة بالبكسل) وDash
(محدّدة بعرض الخط وطول الشرطة بالبكسل) وDot
(دائرية، في وسط الخط، ويتم تحديد القطر بعرض الخط بالبكسل). - مؤشر Z
- ترتيب رسم تراكب المربّعات هذا بالنسبة إلى تراكبات أخرى (بما في ذلك
GroundOverlay
وTileOverlay
وCircle
وPolygon
وs وليسMarker
). يتم رسم مركّب يحتوي على مؤشر z أكبر على طبقات تحتوي على مؤشرات z أصغر. يكون ترتيب التراكبات التي لها نفس مؤشر z عشوائيًا. قيمة zIndex التلقائية هي 0. - مستوى العرض
- تشير إلى ما إذا كان الخط المتعدد مرئيًا أو غير مرئي، بمعنى ما إذا كان مرسومًا على الخريطة. لا يتم رسم خط متعدد غير مرئي، ولكن يحتفظ بجميع خصائصه الأخرى. وتكون القيمة التلقائية
true
، أي مرئية. - الحالة الجيوديسية
- يشير إلى ما إذا كان يجب رسم مقاطع الخطوط المتعددة كأشكال جيوديسية بعكس خطوط مستقيمة على إسقاط ماركتور. الجيوديسية هي أقصر مسار بين نقطتين على سطح الأرض. تم إنشاء المنحنى الجيوديسي على افتراض أنّ الأرض هي كرة .
- إمكانية النقر
- إذا أردت معالجة الأحداث التي يتم تنشيطها عندما ينقر المستخدم على الخطوط المتعددة، اضبط هذه السمة على
true
. ويمكنك تغيير هذه القيمة في أي وقت. والقيمة التلقائية هيfalse
. في حال ضبط هذه السمة علىtrue
، سيتلقّى تطبيقك إشعارات علىGoogleMap.OnPolylineClickListener
المسجَّلة من خلالsetOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
. - علامة
Object
مرتبط بالخط المتعدد. على سبيل المثال، يمكن أن يحتويObject
على بيانات حول ما يمثّله الخط المتعدد. وهذه الطريقة أسهل من تخزينMap<Polyline, Object>
منفصلة. وكمثال آخر، يمكنك ربط رقم تعريفString
مطابق للرقم التعريفي من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها.- طيور متباعدة
- تحدِّد هذه العلامة النطاقات بأنماط مختلفة تُستخدم لعرض هذا الخط المتعدد. يمكنك استخدام هذه السمة لإنشاء خط متعدد بقيم
StrokeStyle
مختلفة على أجزاء مختلفة من الخط المتعدد.
يجب استدعاء الطُرق في هذا الصف في سلسلة محادثات واجهة مستخدم Android. وإذا لم يكن الأمر كذلك، سيتم طرح 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));
دليل المطوِّر
للحصول على مزيد من المعلومات، يُرجى قراءة دليل مطوِّر الأشكال.
ملخّص الطريقة العلنية
boolean | |
int |
getColor()
الحصول على لون هذا الخطوط المتعددة
|
الحد الأقصى |
getEndCap()
نحصل على الحدّ الأقصى في نهاية هذا الخط المتعدد.
|
سلسلة |
getId()
للحصول على معرّف هذا الخط المتعدد
|
int |
getJointType()
للحصول على نوع المفصل المُستخدَم عند جميع رؤوس الخط المتعدد، ما عدا رأسي البداية والنهاية.
|
List<PatternItem> |
getPattern()
نحصل على نمط الخط لهذا الخط المتعدد.
|
List<LatLng> |
getPoints()
تعرض لقطة لرؤوس هذا الخط المتعدد في الوقت الحالي .
|
الحد الأقصى |
getStartCap()
نحصل على الحدّ الأقصى في رأس بداية هذا الخط المتعدد.
|
الكائن |
getTag()
تحصل على علامة الخط المتعدد.
|
float |
getWidth()
نحصل على عرض هذا الخط المتعدد.
|
float |
getZIndex()
للحصول على قيمة zIndex لهذا الخطوط المتعددة،
|
int |
hashCode()
|
boolean |
isClickable()
للحصول على إمكانية النقر على الخطوط المتعددة.
|
boolean |
isGeodesic()
يمكنك معرفة ما إذا كان كل جزء من الخط مرسومًا جيوديسيًا أم لا.
|
boolean |
isVisible()
يتيح الحصول على إمكانية رؤية هذا الخط المتعدد.
|
void |
remove()
لإزالة هذا الخط المتعدد الأبعاد من الخريطة.
|
void |
setClickable(منطقية قابلة للنقر)
لضبط إمكانية النقر على الخطوط المتعددة.
|
void |
setColor(لون طبيعي)
لضبط لون هذا الخط المتعدد
|
void | |
void |
setGeodesic(جيوديسيك منطقية)
لتعيين ما إذا كان سيتم رسم كل جزء من الخط كجيوديسية أم لا.
|
void |
setJointType(int JointType)
لضبط نوع المفصل على جميع رؤوس الخط المتعدد باستثناء رأسي البداية والنهاية.
|
void | |
void | |
void | |
void | |
void |
setTag(علامة الكائن)
لضبط علامة الخط المتعدد
|
void |
setVisible(مرئية منطقية)
تحدِّد هذه السياسة مستوى رؤية هذا الخط المتعدد.
|
void |
setWidth(عرض عائم)
لضبط عرض هذا الخط المتعدد
|
void |
setZIndex(قيمة عائمة لمؤشر zIndex)
لضبط zIndex لهذا الخط المتعدد
|
ملخّص الطريقة المكتسبة
الطرق العامة
منطقية عامة يساوي (كائن آخر)
public int getColor ()
الحصول على لون هذا الخطوط المتعددة
المرتجعات
- اللون بتنسيق ARGB.
public Cap getEndCap ()
نحصل على الحدّ الأقصى في نهاية هذا الخط المتعدد.
المرتجعات
- ونوع الإعلان في نهاية الفيديو.
public سلسلة getId ()
للحصول على معرّف هذا الخط المتعدد سيكون المعرّف فريدًا بين جميع الخطوط المتعددة على الخريطة.
المرتجعات
- معرف الخط المتعدد هذا.
public int getJointType ()
للحصول على نوع المفصل المُستخدَم عند جميع رؤوس الخط المتعدد، ما عدا رأسي البداية والنهاية. راجِع
JointType
للتعرّف على القيم المحتمَلة.
المرتجعات
- نوع المفصل.
public List<LatLng> getPoints ()
تعرض لقطة لرؤوس هذا الخط المتعدد في الوقت الحالي . والقائمة التي يتم عرضها هي نسخة من قائمة رؤوس الخطوط المتعددة، ولذلك لن تنعكس التغييرات التي تطرأ على رؤوس الخطوط المتعددة في هذه القائمة، ولن يظهر في الخط المتعدد التغييرات التي تدخل على هذه القائمة. لتغيير رؤوس الخطوط المتعددة، يجب طلب الرقم setPoints(List)
.
public Object getTag ()
تحصل على علامة الخط المتعدد.
المرتجعات
- العلامة في حال ضبط العلامة باستخدام
setTag
، وnull
في حال عدم ضبط أي علامة.
public float getWidth ()
نحصل على عرض هذا الخط المتعدد.
المرتجعات
- العرض ببكسل الشاشة.
عدد عائم getZIndex ()
للحصول على قيمة zIndex لهذا الخطوط المتعددة،
المرتجعات
- zIndex للخطوط المتعددة.
public int hashCode ()
عامة منطقية isClickable ()
للحصول على إمكانية النقر على الخطوط المتعددة. إذا كان الخط المتعدد قابلاً للنقر، سيتلقى تطبيقك
إشعارات إلى GoogleMap.OnPolylineClickListener
عندما ينقر المستخدم على
الخط المتعدد. تم تسجيل أداة معالجة الحدث من خلال setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
.
المرتجعات
true
إذا كان الخط المتعدد قابلاً للنقر، وإلا سيتم عرضfalse
.
public منطقي isGeodesic ()
يمكنك معرفة ما إذا كان كل جزء من الخط مرسومًا جيوديسيًا أم لا.
المرتجعات
true
إذا تم رسم كل جزء على شكل جيوديسي، وfalse
إذا تم رسم كل جزء كخط مستقيم على إسقاط ماركاتور.
عامة منطقية isVisible ()
يتيح الحصول على إمكانية رؤية هذا الخط المتعدد.
المرتجعات
- رؤية هذه الخطوط المتعددة.
إلغاء عام إزالة ()
لإزالة هذا الخط المتعدد الأبعاد من الخريطة. بعد إزالة الخطوط المتعددة، يصبح سلوك كل طرقها غير معروف.
إلغاء علني setClickable (قيمة منطقية قابلة للنقر)
لضبط إمكانية النقر على الخطوط المتعددة. إذا كان الخط المتعدد قابلاً للنقر، سيتلقى تطبيقك
إشعارات إلى GoogleMap.OnPolylineClickListener
عندما ينقر المستخدم على
الخط المتعدد. تم تسجيل أداة معالجة الحدث من خلال setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
.
المَعلمات
قابل للنقر عليه | إعداد جديد لقابلية النقر للخطوط المتعددة. |
---|
فارغ عام setColor (int color)
لضبط لون هذا الخط المتعدد
المَعلمات
لون | اللون بتنسيق ARGB |
---|
إلغاء عام setEndCap (Cap endCap)
لضبط الحد الأقصى للرأس في نهاية هذا الخط المتعدد الإعلان النهائي التلقائي هو ButtCap
.
المَعلمات
endCap | الإعلان في نهاية الفيديو، ولا يجب أن يكون null .
|
---|
فراغ عام setGeodesic (boolean geodesic)
لتعيين ما إذا كان سيتم رسم كل جزء من الخط كجيوديسية أم لا.
المَعلمات
جيوديسك | إذا كانت قيمة true ، سيتم رسم كل جزء على شكل جيوديسي. وإذا كانت قيمة false ، سيتم رسم كل جزء كخط مستقيم على إسقاط ماركتور.
|
---|
إلغاء عام setJointType (int jointType)
إلغاء عام setPattern (List<PatternItem> style)
لضبط نمط شطب الخطوط المتعددة. نمط الخط التلقائي هو نمط ثابت، ويتم تمثيله بالرمز null
.
المَعلمات
التصميم | نمط الخط. |
---|
إلغاء عام setPoints (List<LatLng> Points)
تُستخدم في تعيين نقاط هذا الخط المتعدد. ستستهلك هذه الطريقة نسخة من النقاط، وبالتالي لن تؤثر أي تغييرات
إضافية على points
في هذا الخط المتعدد.
المَعلمات
نقاط | قائمة LatLng s التي تُمثل قمم الخط المتعدد.
|
---|
إلغاء عام setStartCap (Cap startCap)
لضبط الحد الأقصى عند رأس بداية هذا الخط المتعدد. الحد الأقصى التلقائي لعدد المستخدمين هو ButtCap
.
المَعلمات
startCap | حرف البدء، أي يجب ألا يكون null
|
---|
إلغاء عام setTag (علامة الكائن)
لضبط علامة الخط المتعدد
يمكنك استخدام هذه السمة لربط Object
عشوائي بهذا الخط المتعدد. على سبيل المثال، يمكن أن يحتوي Object
على بيانات حول ما يمثّله الخط المتعدد. وهذه الطريقة أسهل
من تخزين Map<Polyline, Object>
منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String
متوافق مع المعرّف من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها. تقع على عاتقك مسؤولية طلب الرقم setTag(null)
لمحو
العلامة عند الاستغناء عنها، وذلك لمنع تسرُّب الذاكرة في تطبيقك.
المَعلمات
العلامة | وإذا كانت قيمة فارغة، فسيتم محو العلامة. |
---|
فراغ علني setVisible (boolean visible)
تحدِّد هذه السياسة مستوى رؤية هذا الخط المتعدد. عندما لا يتم رسم خط متعدد، لا يتم رسمه، ولكنه يحتفظ بجميع خصائصه الأخرى.
المَعلمات
مرئي | إذا كانت القيمة true ، يكون الخط المتعدد مرئيًا، أمّا إذا كان false ، فلا يكون مرئيًا.
|
---|
فارغ عام setWidth (float width)
لضبط عرض هذا الخط المتعدد
المَعلمات
width | العرض ببكسل الشاشة |
---|
إلغاء علني setZIndex (float zIndex)
لضبط zIndex لهذا الخط المتعدد يتم رسم الخطوط المتعددة ذات المؤشرات الأعلى من حيث عدد المؤشرات فوق الخطوط ذات المؤشرات المنخفضة.
المَعلمات
zIndex | zIndex لهذا الخط المتعدد. |
---|