مُضلع

الفئة النهائية العامة Polygon هي ميزة توسّع الكائن
.

مضلّع على سطح الأرض. يمكن أن يكون المضلّع محدبًا أو مقعّرًا، وقد يمتد إلى خط الطول البالغ 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
يساوي(كائن آخر)
لاختبار ما إذا كانت قيمة Polygon تساوي قيمة أخرى.
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
setHoles(List<? extends List<LatLng>> hols)
لتعيين ثقوب هذا المضلّع.
void
setPoints(قائمة<LatLng> نقاط)
لتعيين نقاط هذا المضلّع.
void
setStrokeColor(لون بعمق)
لتعيين لون سُمك هذا المضلّع.
void
setStrokeJointType(int JointType)
لتعيين نوع المفصل لجميع رؤوس مخطط المضلّع.
void
setStrokePattern(List<PatternItem> النمط)
لتعيين نمط الحد الخارجي لمخطط المضلّع.
void
setStrokeWidth(عرض عائم)
لتعيين عرض سُمك هذا المضلّع.
void
setTag(علامة الكائن)
لتعيين علامة للمضلّع.
void
setVisible(مرئية منطقية)
تعيين مستوى الرؤية لهذا المضلّع.
void
setZIndex(قيمة عائمة لمؤشر zIndex)
لتعيين zIndex لهذا المضلّع.

ملخّص الطريقة المكتسبة

الطرق العامة

منطقية عامة يساوي (كائن آخر)

لاختبار ما إذا كانت قيمة Polygon تساوي قيمة أخرى.

المَعلمات
غير ذلك Object.
المرتجعات
  • true إذا كان كلا الكائنين نفس الكائن، أي أن == other.

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)

لتعيين نوع المفصل لجميع رؤوس مخطط المضلّع.

راجع JointType لمعرفة القيم المسموح بها. سيتم استخدام القيمة التلقائية DEFAULT إذا كان نوع الموصّل غير محدّد أو لم يكن من القيم المسموح بها.

المَعلمات
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 لهذا المضلّع.