دائرة

حصة نهائية علنية دائرة توسيع Object

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

للدائرة السمات التالية.

لاعب وسط
تم تحديد مركز الدائرة على أنه LatLng.
النطاق الجغرافي
نصف قطر الدائرة المحدّد بالمتر يجب أن تكون القيمة صفرًا أو أكبر.
عرض الخط
عرض مخطط الدائرة بوحدات بكسل الشاشة. العرض ثابت ومستقل من مستوى تكبير/تصغير الكاميرا. القيمة التلقائية هي 10.
لون الخط
لون مخطط الدائرة بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color. القيمة التلقائية هي الأسود (0xff000000).
نمط الخط
قيمة ثابتة (تلقائية، يتم تمثيلها بـ null) أو تسلسل من عناصر PatternItem ليتم تكراره على طول مخطط الدائرة. أنواع PatternItem المتوفّرة: Gap (محددة من خلال طول الفجوة بالبكسل)، Dash (يتم تحديدها من خلال عرض الخط وطول الشرطة بالبكسل) بكسل) وDot (دائرية، مركزة على مخطط الدائرة، قُطر محدد عرض الخط بالبكسل).
لون التعبئة
لون تعبئة الدائرة بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color. القيمة التلقائية هي شفافة (0x00000000).
المؤشر Z
الترتيب الذي يتم به رسم تراكب الصور هذا بالنسبة إلى التراكبات الأخرى (بما في ذلك GroundOverlay وTileOverlay وPolyline وPolygons ولكن وليس Marker). يتم رسم تراكب به مؤشر 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()
لعرض لون الخط.
قائمة <PatternItem>
getStrokePattern()
لعرض نمط الخط لمخطط هذه الدائرة.
عدد عائم
getStrokeWidth()
لعرض عرض الخط.
الكائن
getTag()
الحصول على علامة الدائرة.
عدد عائم
getZIndex()
لعرض zIndex.
منطقي
isClickable()
تتيح هذه الميزة النقر على الدائرة.
منطقي
isVisible()
للتحقق مما إذا كانت الدائرة مرئية.
فراغ
remove()
لإزالة هذه الدائرة من الخريطة.
فراغ
setCenter(مركز LatLng)
لضبط الوسط باستخدام LatLng.
فراغ
setClickable(منطقية قابلة للنقر)
لتعيين إمكانية النقر على الدائرة.
فراغ
setFillColor(لون صحيح)
لضبط لون التعبئة.
فراغ
setRadius(نصف قطر مزدوج)
لضبط نصف القطر بالأمتار.
فراغ
setStrokeColor(لون صحيح)
لتعيين لون الخط.
فراغ
setStrokePattern(نمط القائمة<PatternItem>)
لتعيين نمط الخط لمخطط الدائرة.
فراغ
setStrokeWidth(عرض عائم)
لتعيين عرض الخط.
فراغ
setTag(علامة الكائن)
لتعيين علامة الدائرة.
فراغ
setVisible(boolean visible)
لتعيين مستوى رؤية الدائرة.
فراغ
setZIndex(قيمة zIndex بقيمة عائمة)
لتعيين zIndex.

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

الطرق العامة

علنية LatLng getCenter ()

لعرض المركز على شكل LatLng.

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

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

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

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

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

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

علنية مزدوج getRadius ()

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

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

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

لعرض لون الخط.

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

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

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

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

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

لعرض عرض الخط.

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

علنية كائن 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 (نمط القائمة<PatternItem> )

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

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

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

لتعيين عرض الخط.

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

المعلمات
العرض عرض الخط، ببكسل الشاشة.
الرميات
IllegalArgumentException إذا كان العرض سالبًا

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

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

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

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

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

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

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

المعلمات
مرئي true لجعل هذه الدائرة مرئية؛ false لجعلها غير مرئية.

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

لتعيين zIndex.

يتم رسم التراكبات (مثل الدوائر) ذات مؤشرات zIndies الأعلى فوق تلك ذات الفهارس المنخفضة.

المعلمات
zIndex قيمة zIndex.