مُضلع

حصة نهائية علنية مضلّع توسيع Object

مضلّع على سطح الأرض. قد يكون المضلّع محدبًا أو مقعرًا، وقد يمتد إلى الطول ويمكن أن يحتوي على ثقوب غير منتبهة. ويشتمل على السمات التالية:

أحرف مُحاطة بخطوط
يتم تحديد المخطط من خلال قائمة من الرؤوس بترتيب اتجاه عقارب الساعة أو عكس عقارب الساعة. أُنشأها جون هنتر، الذي كان متخصصًا ليس ضروريًا أن تتزامن نقطتي البداية والنهاية؛ وإذا لم يحدث ذلك، فسيُعرض المضلّع سيتم إغلاقها تلقائيًا. يتم رسم الأجزاء الخطية بين نقاط متتالية في الخط الأقصر الاتجاهين (شرق أو غرب).
ثقوب
الثقب هو منطقة داخل المضلّع غير معبأة. يتم تحديد الثقب بدقة بنفس طريقة المخطط التفصيلي. يجب تضمين الثقب بالكامل في المخطط. منتجات يمكن تحديد الثقوب، ومع ذلك لا يتم دعم الثقوب المتداخلة.
عرض الخط
عرض الخط بوحدات بكسل الشاشة ويكون العرض ثابتًا ومستقلاً عن عرض الكاميرا. مستوى التكبير/التصغير. القيمة التلقائية هي 10.
لون الخط
لون الجزء الخطي بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color القيمة التلقائية هي الأسود (0xff000000).
نوع مفصل السُمك
يحدد نوع المفصل الشكل الذي سيتم استخدامه عند ضم أجزاء الخط المجاورة على الإطلاق رؤوس مخطط المضلّع. يمكنك الانتقال إلى JointType للتعرُّف على أنواع المفاصل المتوافقة. تشير رسالة الأشكال البيانية والقيمة التلقائية هي DEFAULT.
نمط الخط
قيمة ثابتة (تلقائية، يتم تمثيلها بـ null) أو تسلسل من عناصر PatternItem تكراره على طول مخطط المضلّع. أنواع PatternItem المتاحة: Gap (يتم تحديدها من خلال طول الفجوة بالبكسل)، Dash (يتم تحديدها من خلال عرض الخط والشرطة) الطول بالبكسل) وDot (مستديرة، توسيط في مخطط المضلّع، القطر محدد من خلال عرض الخط بالبكسل).
لون التعبئة
ملء اللون بتنسيق ARGB، بالتنسيق نفسه المستخدَم في Color تشير رسالة الأشكال البيانية القيمة التلقائية شفافة (0x00000000). في حال عدم تحديد هندسة المضلّع بشكل صحيح (انظر أعلاه بالنسبة إلى المخطط والثقوب)، فلن يتم رسم أي تعبئة.
المؤشر Z
الترتيب الذي يتم فيه رسم هذا المضلّع بالنسبة إلى التراكبات الأخرى، بما في ذلك Polyline وCircles وGroundOverlay وTileOverlays، ولكن ليس 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));

دليل المطوِّر

لمزيد من المعلومات، يُرجى الاطّلاع على مطوِّر برامج الأشكال. الدليل.

ملخّص الطريقة العامة

منطقي
يساوي(كائن آخر)
لاختبار ما إذا كانت قيمة Polygon هذه تساوي قيمة أخرى.
int
getFillColor()
الحصول على لون التعبئة لهذا المضلّع
القائمة<List<LatLng>>
getHoles()
عرض لقطة لثقوب هذا المضلّع في الوقت الحالي .
سلسلة
getId()
للحصول على معرّف هذا المضلّع.
قائمة<LatLng>
getPoints()
يتم عرض لقطة لرؤوس هذا المضلّع في الوقت الحالي .
int
getStrokeColor()
للحصول على لون خط هذا المضلّع
int
getStrokeJointType()
الحصول على نوع تقاطع الخط المستخدم في جميع رؤوس مخطط المضلّع.
قائمة <PatternItem>
getStrokePattern()
الحصول على نمط الخط لمخطط هذا المضلّع
عدد عائم
getStrokeWidth()
للحصول على عرض خط هذا المضلّع.
الكائن
getTag()
الحصول على علامة المضلّع.
عدد عائم
getZIndex()
للحصول على الفهرس zIndex لهذا المضلّع.
int
hashCode()
منطقي
isClickable()
الحصول على إمكانية النقر على المضلّع
منطقي
isGeodesic()
للتعرف على ما إذا كان كل جزء من الخط مرسومًا كجيوديسية أم لا.
منطقي
isVisible()
عرض هذا المضلّع
فراغ
remove()
لإزالة المضلّع من الخريطة.
فراغ
setClickable(منطقية قابلة للنقر)
تحدد إمكانية النقر على المضلّع.
فراغ
setFillColor(لون صحيح)
لضبط لون التعبئة لهذا المضلّع.
فراغ
setGeodesic(boolean geodesic)
لتحديد ما إذا كان سيتم رسم كل جزء من الخط كموقع جيوديسي أم لا.
فراغ
setHoles(قائمة<? توسيع قائمة<LatLng>> فتحات)
لتعيين الثقوب في هذا المضلّع.
فراغ
setPoints(قائمة<LatLng> نقطة)
تحدد نقاط هذا المضلّع.
فراغ
setStrokeColor(لون صحيح)
لتعيين لون الخط لهذا المضلّع.
فراغ
setStrokeJointType(int sharedType)
تحدد نوع الوصلة لجميع رؤوس مخطط المضلّع.
فراغ
setStrokePattern(نمط القائمة<PatternItem>)
لتعيين نمط الخط لمخطط المضلّع.
فراغ
setStrokeWidth(عرض عائم)
لتعيين عرض الخط لهذا المضلّع.
فراغ
setTag(علامة الكائن)
لتعيين العلامة للمضلّع.
فراغ
setVisible(boolean visible)
لتعيين مستوى الرؤية لهذا المضلّع.
فراغ
setZIndex(قيمة zIndex بقيمة عائمة)
تعمل على تعيين zIndex لهذا المضلّع.

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

الطرق العامة

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

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

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

علنية تدخُّل دفاعي getFillColor ()

الحصول على لون التعبئة لهذا المضلّع

المرتجعات
  • اللون بتنسيق ARGB.

علنية القائمة<List<LatLng>> getHoles ()

عرض لقطة لثقوب هذا المضلّع في الوقت الحالي . القائمة التي يتم عرضها هي نسخة من قائمة الثقوب وبالتالي لن تنعكس التغييرات التي تطرأ على ثقوب المضلّع في هذه القائمة، أو التغييرات التي يتم إجراؤها على هذه القائمة في المضلّع.

علنية السلسلة getId ()

للحصول على معرّف هذا المضلّع. سيكون المعرّف فريدًا بين جميع المضلعات على الخريطة.

علنية قائمة<LatLng> getPoints ()

يتم عرض لقطة لرؤوس هذا المضلّع في الوقت الحالي . القائمة التي يتم عرضها هي نسخة قائمة الرؤوس وبالتالي لن تنعكس التغييرات التي تطرأ على رؤوس المضلّع في ولن تنعكس التغييرات التي يتم إجراؤها على هذه القائمة في المضلّع. لتغيير رؤوس مضلّع، نسميه setPoints(List).

علنية تدخُّل دفاعي getStrokeColor ()

للحصول على لون خط هذا المضلّع

المرتجعات
  • اللون بتنسيق ARGB.

علنية تدخُّل دفاعي getStrokeJointType ()

الحصول على نوع تقاطع الخط المستخدم في جميع رؤوس مخطط المضلّع. يمكنك الاطّلاع على JointType. للقيم المحتملة.

المرتجعات
  • نوع مفصل السُمك.

علنية قائمة <PatternItem> getStrokePattern ()

الحصول على نمط الخط لمخطط هذا المضلّع

المرتجعات
  • نمط الخط.

علنية عدد عائم getStrokeWidth ()

للحصول على عرض خط هذا المضلّع.

المرتجعات
  • العرض ببكسل الشاشة.

علنية كائن getTag ()

الحصول على علامة المضلّع.

المرتجعات
  • العلامة إذا تمّ ضبط علامة باستخدام setTag null في حال عدم ضبط أي علامة

علنية عدد عائم getZIndex ()

للحصول على الفهرس zIndex لهذا المضلّع.

المرتجعات
  • الفهرس z للمضلّع.

علنية تدخُّل دفاعي hashCode ()

علنية منطقية isClickable ()

الحصول على إمكانية النقر على المضلّع إذا كان المضلّع قابلاً للنقر، فسيتلقى تطبيقك إشعارات إلى GoogleMap.OnPolygonClickListener عندما ينقر المستخدم على المضلّع. يتم تسجيل أداة معالجة الحدث من خلال setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

المرتجعات
  • true إذا كان المضلّع قابلاً للنقر. في الحالات الأخرى، سيتم إرجاع false.

علنية منطقية isGeodesic ()

للتعرف على ما إذا كان كل جزء من الخط مرسومًا كجيوديسية أم لا.

المرتجعات
  • true إذا تم رسم كل جزء كخط جيوديسي false إذا كان كل قسم مرسومة كخط مستقيم على إسقاط ماركاتور.

علنية منطقية isVisible ()

عرض هذا المضلّع

المرتجعات
  • رؤية المضلّع هذا.

علنية فراغ إزالة ()

لإزالة المضلّع من الخريطة. بعد إزالة أي مضلّع، يصبح سلوك جميع عناصره غير محددة.

علنية فراغ setClickable (قيمة منطقية قابلة للنقر)

تحدد إمكانية النقر على المضلّع. إذا كان المضلّع قابلاً للنقر، فسيتلقى تطبيقك إشعارات إلى GoogleMap.OnPolygonClickListener عندما ينقر المستخدم على المضلّع. يتم تسجيل أداة معالجة الحدث من خلال setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

المعلمات
قابل للنقر إعداد جديد لإمكانية النقر للمضلّع.

علنية فراغ setFillColor (اللون الصحيح)

لضبط لون التعبئة لهذا المضلّع.

المعلمات
اللون اللون بتنسيق ARGB

علنية فراغ setGeodesic (جيوديسية منطقية)

لتحديد ما إذا كان سيتم رسم كل جزء من الخط كموقع جيوديسي أم لا.

المعلمات
جيوديسية إذا كانت true، حينئذٍ يتم رسم كل جزء كخط جيوديسي. إذا false، يُرسم كل جزء كخط مستقيم على إسقاط ماركاتور.

علنية فراغ setHoles (قائمة<? توسيع قائمة<LatLng>> ثقوب)

لتعيين الثقوب في هذا المضلّع. ستأخذ هذه الطريقة نسخة من الثقوب، بحيث تؤدي الطفرات الأخرى إلى holes لن يكون له أي تأثير في هذا المضلّع.

المعلمات
ثقوب وهي قائمة بالثقوب، والثقب هو قائمة من LatLng.

علنية فراغ setPoints (قائمة<LatLng> نقطة)

تحدد نقاط هذا المضلّع. ستأخذ هذه الطريقة نسخة من النقاط، لن تؤثر التغييرات في الدالة points على هذا المضلّع.

المعلمات
نقاط قائمة من LatLng تمثل رؤوس المضلّع.

علنية فراغ setStrokeColor (اللون الصحيح)

لتعيين لون الخط لهذا المضلّع.

المعلمات
اللون اللون بتنسيق ARGB

علنية فراغ setStrokeJointType (int SharedType)

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

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

المعلمات
jointType نوع مفصل السُمك.

علنية فراغ setStrokePattern (نمط القائمة<PatternItem> )

لتعيين نمط الخط لمخطط المضلّع. نمط الخط الافتراضي هو ثابت، ممثلة من null.

المعلمات
نمط نمط الخط.

علنية فراغ setStrokeWidth (عرض عائم)

لتعيين عرض الخط لهذا المضلّع.

المعلمات
العرض العرض ببكسل العرض.

علنية فراغ setTag (علامة الكائن)

لتعيين العلامة للمضلّع.

يمكنك استخدام هذه السمة لربط Object عشوائي بهذا المضلّع. بالنسبة على سبيل المثال، يمكن أن يحتوي Object على بيانات حول ما يمثله المضلّع. هذا الخيار أسهل من تخزين Map<Polygon, Object> منفصل وكمثال آخر، يمكنك ربط String رقم تعريف مطابق لرقم التعريف الوارد من مجموعة بيانات. حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android قراءة أو كتابة هذه الخاصية. تقع على عاتقك مسؤولية طلب إزالة الحساب من "setTag(null)" العلامة عند الاستغناء عنها، لتجنُّب تسرُّب الذاكرة في تطبيقك.

المعلمات
علامة إذا كانت القيمة خالية، يتم محو العلامة.

علنية فراغ setVisible (قيمة منطقية مرئية)

لتعيين مستوى الرؤية لهذا المضلّع. عندما لا يكون المضلّع مرئيًا، لا يتم رسمه، ولكنه يحتفظ بجميع وخصائصه الأخرى.

المعلمات
مرئي إذا كان true، فسيكون المضلّع مرئيًا؛ إذا كانت السمة false، لا تكون كذلك.

علنية فراغ setZIndex (المؤشر z العشري)

لتعيين الفهرس zIndex لهذا المضلّع. يتم رسم المضلّعات التي تحتوي على مؤشرات zمؤشرات أعلى فوق تلك التي تحتوي على مؤشرات أقل المؤشرات.

المعلمات
zIndex الفهرس z لهذا المضلّع.