دائرة

الفئة النهائية العامة دائرة توسّع الكائن

دائرة على سطح الأرض (غطاء كروي).

تتضمَّن الدائرة السمات التالية.

لاعب وسط
تم تحديد وسط الدائرة على شكل LatLng.
النطاق
نصف قطر الدائرة، المحدد بالمتر. يجب أن تكون القيمة صفرًا أو أكبر.
عرض الشطب
عرض مخطّط الدائرة بوحدات بكسل الشاشة يكون العرض ثابتًا ومستقلًا عن مستوى تكبير/تصغير الكاميرا. القيمة التلقائية هي 10.
لون الشطب
لون المخطط الدائري بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color. القيمة التلقائية هي الأسود (0xff000000).
نمط الكتابة
عنصر ثابت (يتم تمثيله بالرمز null) أو تسلسل من عناصر PatternItem يتم تكراره على طول مخطط الدائرة. أنواع PatternItem المتاحة: Gap (محدّدة بطول الفجوة بالبكسل) وDash (يتم تحديدها من خلال عرض خطّ الرسم وطول الشرطة بالبكسل) وDot (دائرية، في وسطها على مخطط الدائرة، وتُحدَّد القطر بعرض الخط بالبكسل).
لون التعبئة
لون تعبئة الدائرة بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color. وتكون القيمة التلقائية شفافة (0x00000000).
مؤشر Z
ترتيب رسم تراكب الصور هذا بالنسبة إلى التراكبات الأخرى (بما في ذلك GroundOverlays وTileOverlays وPolylines وPolygons ولكن ليس Markers). يتم رسم مركّب يحتوي على مؤشر z أكبر على طبقات تحتوي على مؤشرات z أصغر. يكون ترتيب التراكبات التي لها نفس مؤشر z عشوائيًا. قيمة zIndex التلقائية هي 0.
مستوى العرض
يشير إلى ما إذا كانت الدائرة مرئية أو غير مرئية، أي ما إذا كانت مرسومة على الخريطة. لا يتم رسم دائرة غير مرئية، ولكن تحتفظ بجميع خصائصها الأخرى. وتكون القيمة التلقائية true، أي مرئية.
علامة
Object مرتبط بالدائرة. على سبيل المثال، يمكن أن تتضمن Object بيانات حول ما تمثله الدائرة. وهذه الطريقة أسهل من تخزين Map<Circle, Object> منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String مطابق للرقم التعريفي من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها.

يجب استدعاء الطُرق في هذا الصف في سلسلة محادثات واجهة مستخدم Android. وإذا لم يكن الأمر كذلك، سيتم طرح IllegalStateException في وقت التشغيل.

مثال

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

لاحظ أن عارض الخريطة الحالي لا يمكنه رسم تعبئة الدائرة إذا كانت الدائرة تضم إما القطب الشمالي أو الجنوبي. ومع ذلك، سيظل المخطط مرسومًا بشكل صحيح.

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

للحصول على مزيد من المعلومات، يُرجى قراءة دليل مطوِّر الأشكال.

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

LatLng
getCenter()
عرض المركز على هيئة LatLng.
int
getFillColor()
تعرض لون التعبئة لهذه الدائرة.
سلسلة
getId()
الحصول على رقم تعريف هذه الدائرة.
مزدوج
getRadius()
لعرض نصف قطر الدائرة بالمتر.
int
getStrokeColor()
تعرض لون الشطب.
List<PatternItem>
getStrokePattern()
لعرض نمط الخط لمخطط هذه الدائرة.
float
getStrokeWidth()
تعرض عرض الشطب.
الكائن
getTag()
الحصول على علامة للدائرة.
float
getZIndex()
لعرض zIndex.
boolean
isClickable()
الحصول على إمكانية النقر للدائرة.
boolean
isVisible()
للتحقق مما إذا كانت الدائرة مرئية أم لا.
void
remove()
إزالة هذه الدائرة من الخريطة.
void
setCenter(مركز LatLng)
لضبط المركز باستخدام LatLng.
void
setClickable(منطقية قابلة للنقر)
لضبط إمكانية النقر على الدائرة.
void
setFillColor(اللون الصحيح)
لضبط لون التعبئة.
void
setRadius(نصف قطر مزدوج)
لتعيين نصف القطر بالمتر.
void
setStrokeColor(لون بعمق)
لضبط لون الشطب.
void
setStrokePattern(List<PatternItem> النمط)
لتعيين نمط الحد الخارجي لمخطط الدائرة.
void
setStrokeWidth(عرض عائم)
لضبط عرض الحد الخارجي.
void
setTag(علامة الكائن)
لتعيين علامة للدائرة.
void
setVisible(مرئية منطقية)
لتعيين مستوى رؤية الدائرة.
void
setZIndex(قيمة عائمة لمؤشر zIndex)
لضبط zIndex.

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

الطرق العامة

عامة LatLng getCenter ()

عرض المركز على هيئة LatLng.

المرتجعات
  • المركز الجغرافي باعتباره LatLng.

public int getFillColor ()

تعرض لون التعبئة لهذه الدائرة.

المرتجعات
  • لون تعبئة الدائرة بتنسيق ARGB

public سلسلة getId ()

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

عامة مزدوجة getRadius ()

لعرض نصف قطر الدائرة بالمتر.

المرتجعات
  • نصف القطر بالمتر.

public int getStrokeColor ()

تعرض لون الشطب.

المرتجعات
  • لون الدائرة بتنسيق ARGB

public List<PatternItem> getStrokePattern ()

لعرض نمط الخط لمخطط هذه الدائرة.

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

public float getStrokeWidth ()

تعرض عرض الشطب.

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

public Object getTag ()

الحصول على علامة للدائرة.

المرتجعات
  • العلامة في حال ضبط العلامة باستخدام setTag، وnull في حال عدم ضبط أي علامة.

عدد عائم getZIndex ()

لعرض zIndex.

المرتجعات
  • zIndex لهذه الدائرة.

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

الحصول على إمكانية النقر للدائرة. إذا كانت الدائرة قابلة للنقر، سيتلقى تطبيقك إشعارات إلى GoogleMap.OnCircleClickListener عندما ينقر المستخدم على الدائرة. تم تسجيل أداة معالجة الحدث من خلال setOnCircleClickListener(GoogleMap.OnCircleClickListener).

المرتجعات
  • true إذا كانت الدائرة قابلة للنقر، وfalse إذا لم تكن قابلة للنقر.

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

للتحقق مما إذا كانت الدائرة مرئية أم لا.

المرتجعات
  • true إذا كانت الدائرة مرئية، وfalse إذا كانت غير مرئية.

إلغاء عام إزالة ()

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

إلغاء عام setCenter (مركز LatLng)

لضبط المركز باستخدام LatLng.

يجب ألا يكون المركز فارغًا، نظرًا لعدم وجود قيمة افتراضية.

المَعلمات
الأوسط المركز الجغرافي للدائرة، المحدد بعلامة LatLng.
الرميات
NullPointerException إذا كان المركز فارغًا

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

لضبط إمكانية النقر على الدائرة. إذا كانت الدائرة قابلة للنقر، سيتلقى تطبيقك إشعارات إلى GoogleMap.OnCircleClickListener عندما ينقر المستخدم على الدائرة. تم تسجيل أداة معالجة الحدث من خلال setOnCircleClickListener(GoogleMap.OnCircleClickListener).

المَعلمات
قابل للنقر عليه إعداد جديد لإمكانية النقر للدائرة.

إلغاء عام setFillColor (باللون الداخلي)

لضبط لون التعبئة.

لون التعبئة هو اللون داخل الدائرة، بتنسيق العدد الصحيح المحدَّد في Color. إذا تم استخدام TRANSPARENT، فلن يتم رسم أي تعبئة.

المَعلمات
لون اللون بتنسيق Color.

فراغ عام setRadius (نصف قطر مزدوج)

لتعيين نصف القطر بالمتر.

يجب أن يكون نصف القطر صفرًا أو أكبر.

المَعلمات
نطاق جغرافي نصف القطر بالمتر.
الرميات
IllegalArgumentException إذا كان النطاق الجغرافي سالبًا

فارغ عام setStrokeColor (باللون الداخلي)

لضبط لون الشطب.

لون الشطب هو لون مخطط هذه الدائرة، بتنسيق العدد الصحيح المحدد في Color. إذا تم استخدام TRANSPARENT، فلن يتم رسم مخطط.

المَعلمات
لون لون الشطب بتنسيق Color.

إلغاء عام setStrokePattern (List<PatternItem> style)

لتعيين نمط الحد الخارجي لمخطط الدائرة. نمط الخط التلقائي هو نمط ثابت، ويتم تمثيله بالرمز null.

المَعلمات
التصميم نمط الخط.

إبطال عام setStrokeWidth (float width)

لضبط عرض الحد الخارجي.

عرض الحد الخارجي هو عرض مخطط الدائرة (بالبكسل في الشاشة). ويجب أن تكون قيمتها صفرًا أو أكبر. وإذا كانت قيمتها صفرًا، لن يتم رسم أي مخطط. القيمة التلقائية هي 10.

المَعلمات
width عرض الشطب بوحدات بكسل الشاشة.
الرميات
IllegalArgumentException إذا كان العرض سالبًا

إلغاء عام setTag (علامة الكائن)

لتعيين علامة للدائرة.

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

المَعلمات
العلامة وإذا كانت قيمة فارغة، فسيتم محو العلامة.

فراغ علني setVisible (boolean visible)

لتعيين مستوى رؤية الدائرة.

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

المَعلمات
مرئي true لإظهار هذه الدائرة، وfalse لجعلها غير مرئية.

إلغاء علني setZIndex (float zIndex)

لضبط zIndex.

يتم رسم التراكبات (مثل الدوائر) ذات مؤشرات zَّة الأعلى أعلى التراكبات ذات الفهارس السفلية.

المَعلمات
zIndex تمثّل هذه السمة قيمة zIndex.