.
مضلّع على سطح الأرض. يمكن أن يكون المضلّع محدبًا أو مقعّرًا، وقد يمتد إلى خط الطول البالغ 180 درجة وقد يحتوي على ثقوب غير مملوءة. ويشتمل على السمات التالية:
- المخطط
- يتم تحديد المخطط من خلال قائمة بالرؤوس، بترتيب في اتجاه عقارب الساعة أو عكس اتجاه عقارب الساعة. ليس من الضروري أن تتزامن نقطتا البداية والنهاية، فإذا لم يكن الأمر كذلك، فسيتم إغلاق المضلّع تلقائيًا. يتم رسم أجزاء الخطوط بين نقاط متتالية في الأقصر بين الاتجاهين (الشرق أو الغرب).
- ثقوب
- الثقب هو منطقة غير مملوءة داخل المضلّع. ويتم تحديد الثقب بالطريقة نفسها التي يتم بها تحديد المخطط. يجب أن تكون الثقب داخل المخطط بالكامل. يمكن تحديد عدة ثقوب، ولكن لا يمكن تحديد الثقوب المتداخلة.
- عرض الشطب
- عرض القطع الخطية بوحدات بكسل الشاشة يكون العرض ثابتًا ومستقلًا عن مستوى تكبير/تصغير الكاميرا. القيمة التلقائية هي 10.
- لون الشطب
- لون الجزء من الخط بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في
Color
. القيمة التلقائية هي الأسود (0xff000000
). - نوع مفصل الضرب
- يحدد نوع الموصّل الشكل الذي سيتم استخدامه عند ضم أجزاء من الخط المتجاورة في جميع
رؤوس مخطط المضلّع. يمكنك الاطّلاع على
JointType
لمعرفة أنواع المفاصل المتوافقة. القيمة التلقائية هيDEFAULT
. - نمط الكتابة
- عنصر ثابت (يتم تمثيله بالرمز
null
) أو تسلسل من عناصرPatternItem
يتم تكراره على طول مخطط المضلّع. أنواعPatternItem
المتاحة:Gap
(محدّدة بطول الفجوة بالبكسل) وDash
(يتم تحديدها من خلال عرض خطّ الرسم وطول الشرطة بالبكسل) وDot
(مستديرة، في وسط المضلّع، وتُحدَّد القطر بعرض الخط بالبكسل). - لون التعبئة
- تعبئة اللون بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في
Color
. وتكون القيمة التلقائية شفافة (0x00000000
). إذا لم يتم تحديد هندسة المضلّع بشكل صحيح (راجع المخطط والثقوب أعلاه)، فلن يتم رسم أي تعبئة. - مؤشر Z
- ترتيب رسم هذا المضلّع وفقًا للتراكبات الأخرى، بما في ذلك
Polyline
وCircle
وGroundOverlay
وTileOverlay
وليسMarker
. يتم رسم مركّب يحتوي على مؤشر z أكبر على طبقات تحتوي على مؤشرات z أصغر. يكون ترتيب التراكبات ذات قيمة مؤشر z نفسها أمرًا عشوائيًا. القيمة التلقائية هي 0. - مستوى العرض
- تشير إلى ما إذا كان المضلّع مرئيًا أم غير مرئي، بمعنى ما إذا كان مرسومًا على الخريطة. لا يتم رسم مضلّع غير مرئي، ولكن يحتفظ بكل خصائصه الأخرى. وتكون القيمة التلقائية
true
، أي مرئية. - الحالة الجيوديسية
- يشير إلى ما إذا كان يجب رسم أجزاء المضلّع كجيوديسية، مقارنةً بخطوط مستقيمة على إسقاط ماركاتور. الجيوديسية هي أقصر مسار بين نقطتين على سطح الأرض. تم إنشاء المنحنى الجيوديسي على افتراض أنّ الأرض هي كرة .
- إمكانية النقر
- إذا أردت معالجة الأحداث التي يتم تنشيطها عندما ينقر المستخدم على المضلّع، اضبط هذه السمة على
true
. ويمكنك تغيير هذه القيمة في أي وقت. والقيمة التلقائية هيfalse
. في حال ضبط هذه السمة علىtrue
، سيتلقّى تطبيقك إشعارات علىGoogleMap.OnPolygonClickListener
المسجَّلة من خلالsetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
. - علامة
Object
مرتبط بالمضلّع. على سبيل المثال، يمكن أن يحتويObject
على بيانات حول ما يمثله المضلّع. وهذه الطريقة أسهل من تخزينMap<Polygon, Object>
منفصلة. وكمثال آخر، يمكنك ربط رقم تعريفString
مطابق للرقم التعريفي من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل 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));
دليل المطوِّر
للحصول على مزيد من المعلومات، يُرجى قراءة دليل مطوِّر الأشكال.
ملخّص الطريقة العلنية
boolean | |
int |
getFillColor()
للحصول على لون التعبئة لهذا المضلّع.
|
List<List<LatLng>> |
getHoles()
يتم عرض لقطة للثقوب في هذا المضلّع في هذا الوقت .
|
سلسلة |
getId()
يحصل على معرّف هذا المضلّع.
|
List<LatLng> |
getPoints()
يتم عرض لقطة لرؤوس هذا المضلّع في هذا الوقت .
|
int |
getStrokeColor()
يحصل على لون شطب هذا المضلّع.
|
int |
getStrokeJointType()
للحصول على نوع وصلة الحد الخارجي المستخدمة في جميع رؤوس مخطط المضلّع.
|
List<PatternItem> |
getStrokePattern()
يحصل على نمط الحد الخارجي لمخطط هذا المضلّع.
|
float |
getStrokeWidth()
للحصول على عرض الحد الخارجي لهذا المضلّع.
|
الكائن |
getTag()
يحصل على علامة المضلّع.
|
float |
getZIndex()
للحصول على zIndex لهذا المضلّع.
|
int |
hashCode()
|
boolean |
isClickable()
للحصول على إمكانية النقر على المضلّع.
|
boolean |
isGeodesic()
يمكنك معرفة ما إذا كان كل جزء من الخط مرسومًا جيوديسيًا أم لا.
|
boolean |
isVisible()
يتيح لك الحصول على إمكانية رؤية هذا المضلّع.
|
void |
remove()
إزالة المضلّع من الخريطة.
|
void |
setClickable(منطقية قابلة للنقر)
تعيين إمكانية النقر للمضلّع.
|
void |
setFillColor(اللون الصحيح)
لتعيين لون التعبئة لهذا المضلّع.
|
void |
setGeodesic(جيوديسيك منطقية)
لتعيين ما إذا كان سيتم رسم كل جزء من الخط كجيوديسية أم لا.
|
void | |
void | |
void |
setStrokeColor(لون بعمق)
لتعيين لون سُمك هذا المضلّع.
|
void |
setStrokeJointType(int JointType)
لتعيين نوع المفصل لجميع رؤوس مخطط المضلّع.
|
void | |
void |
setStrokeWidth(عرض عائم)
لتعيين عرض سُمك هذا المضلّع.
|
void |
setTag(علامة الكائن)
لتعيين علامة للمضلّع.
|
void |
setVisible(مرئية منطقية)
تعيين مستوى الرؤية لهذا المضلّع.
|
void |
setZIndex(قيمة عائمة لمؤشر zIndex)
لتعيين zIndex لهذا المضلّع.
|
ملخّص الطريقة المكتسبة
الطرق العامة
منطقية عامة يساوي (كائن آخر)
public int getFillColor ()
للحصول على لون التعبئة لهذا المضلّع.
المرتجعات
- اللون بتنسيق ARGB.
public List<List<LatLng>> getHoles ()
يتم عرض لقطة للثقوب في هذا المضلّع في هذا الوقت . القائمة المعروضة هي نسخة من قائمة الثقوب، ولذلك لن تنعكس التغييرات التي تطرأ على ثقوب المضلّع في هذه القائمة، ولن تنعكس التغييرات التي يتم إجراؤها على هذه القائمة من خلال المضلّع.
public سلسلة 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
في حال عدم ضبط أي علامة.
عدد عائم getZIndex ()
للحصول على zIndex لهذا المضلّع.
المرتجعات
- zIndex للمضلّع.
public int hashCode ()
عامة منطقية isClickable ()
للحصول على إمكانية النقر على المضلّع. إذا كان المضلّع قابلاً للنقر، فسيتلقى تطبيقك إشعارات إلى GoogleMap.OnPolygonClickListener
عندما ينقر المستخدم على المضلّع.
تم تسجيل أداة معالجة الحدث من خلال setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
المرتجعات
true
إذا كان المضلّع قابلاً للنقر، وإلا سيتم عرضfalse
.
public منطقي isGeodesic ()
يمكنك معرفة ما إذا كان كل جزء من الخط مرسومًا جيوديسيًا أم لا.
المرتجعات
true
إذا تم رسم كل جزء على شكل جيوديسي، وfalse
إذا تم رسم كل جزء كخط مستقيم على إسقاط ماركاتور.
عامة منطقية isVisible ()
يتيح لك الحصول على إمكانية رؤية هذا المضلّع.
المرتجعات
- رؤية المضلّع هذه.
إلغاء عام إزالة ()
إزالة المضلّع من الخريطة. بعد إزالة المضلّع، يصبح سلوك جميع طرقه غير محدد.
إلغاء علني setClickable (قيمة منطقية قابلة للنقر)
تعيين إمكانية النقر للمضلّع. إذا كان المضلّع قابلاً للنقر، فسيتلقى تطبيقك إشعارات إلى GoogleMap.OnPolygonClickListener
عندما ينقر المستخدم على المضلّع.
تم تسجيل أداة معالجة الحدث من خلال setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
المَعلمات
قابل للنقر عليه | إعداد جديد لإمكانية النقر للمضلّع. |
---|
إلغاء عام setFillColor (باللون الداخلي)
لتعيين لون التعبئة لهذا المضلّع.
المَعلمات
لون | اللون بتنسيق ARGB |
---|
فراغ عام setGeodesic (boolean geodesic)
لتعيين ما إذا كان سيتم رسم كل جزء من الخط كجيوديسية أم لا.
المَعلمات
جيوديسك | إذا كانت قيمة true ، سيتم رسم كل جزء على شكل جيوديسي. وإذا كانت قيمة false ، سيتم رسم كل جزء كخط مستقيم على إسقاط ماركتور.
|
---|
إبطال عام setHoles (List<? extends List<LatLng>> hols)
لتعيين ثقوب هذا المضلّع. ستستهلك هذه الطريقة نسخة من الثقوب، لذا لن تؤثر أي تغييرات يتم إجراؤها على holes
في هذا المضلّع.
المَعلمات
ثقوب | قائمة بالثقوب، حيث يشير الثقب إلى قائمة LatLng ثانية.
|
---|
إلغاء عام setPoints (List<LatLng> Points)
لتعيين نقاط هذا المضلّع. ستستهلك هذه الطريقة نسخة من النقاط، لذا لن تؤثر أي تغييرات
إضافية على points
في هذا المضلّع.
المَعلمات
نقاط | قائمة LatLng التي تُمثل رؤوس المضلّع.
|
---|
فارغ عام setStrokeColor (باللون الداخلي)
لتعيين لون سُمك هذا المضلّع.
المَعلمات
لون | اللون بتنسيق ARGB |
---|
إبطال عام setStrokeJointType (int jointType)
إلغاء عام setStrokePattern (List<PatternItem> style)
لتعيين نمط الحد الخارجي لمخطط المضلّع. نمط الخط التلقائي هو نمط ثابت، ويتم تمثيله بالرمز null
.
المَعلمات
التصميم | نمط الخط. |
---|
إبطال عام setStrokeWidth (float width)
لتعيين عرض سُمك هذا المضلّع.
المَعلمات
width | العرض ببكسل العرض. |
---|
إلغاء عام setTag (علامة الكائن)
لتعيين علامة للمضلّع.
يمكنك استخدام هذه السمة لربط Object
عشوائي بهذا المضلّع. على سبيل المثال، يمكن أن يحتوي Object
على بيانات حول ما يمثله المضلّع. وهذه الطريقة أسهل
من تخزين Map<Polygon, Object>
منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String
متوافق مع المعرّف من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها. تقع على عاتقك مسؤولية طلب الرقم setTag(null)
لمحو
العلامة عند الاستغناء عنها، وذلك لمنع تسرُّب الذاكرة في تطبيقك.
المَعلمات
العلامة | وإذا كانت قيمة فارغة، فسيتم محو العلامة. |
---|
فراغ علني setVisible (boolean visible)
تعيين مستوى الرؤية لهذا المضلّع. عندما لا يكون المضلّع مرئيًا، لا يتم رسمه، ولكنه يحتفظ بكل خصائصه الأخرى.
المَعلمات
مرئي | إذا كانت القيمة true ، يكون المضلّع مرئيًا، أمّا إذا كان false ، فلا يكون مرئيًا.
|
---|
إلغاء علني setZIndex (float zIndex)
لتعيين zIndex لهذا المضلّع. يتم رسم المضلّعات التي لها مؤشرات z أعلى فوق تلك التي تحتوي على مؤشرات أقل.
المَعلمات
zIndex | zIndex لهذا المضلّع. |
---|