דף זה תורגם על ידי Cloud Translation API.

מעגל

שיעור סיום ציבורי מעגל מרחיב את אובייקט

עיגול על פני כדור הארץ (כובע כדורי).

למעגל יש את המאפיינים הבאים.

סֶנטר: מרכז המעגל מצוין בתור LatLng.
Radius: רדיוס המעגל, מצוין במטרים. הערך צריך להיות אפס או גדול יותר.
רוחב הקו: רוחב מתאר העיגול בפיקסלים של המסך. הרוחב קבוע ועצמאי של רמת הזום של המצלמה. ערך ברירת המחדל הוא 10.
צבע הקו: הצבע של מתאר העיגול בפורמט ARGB, אותו הפורמט שבו נעשה שימוש ב-Color. ערך ברירת המחדל הוא שחור (0xff000000).
קו ביטול נעילה: רציף (ברירת מחדל, מיוצג על ידי null) או רצף של PatternItem אובייקטים לחזור על עצמה לאורך קו המתאר של המעגל. הסוגים הזמינים של PatternItem: Gap (מוגדר לפי אורך הפער בפיקסלים), Dash (מוגדר לפי רוחב הקו ואורך הקו ב- פיקסלים) ו-Dot (עגול, ממורכז על קווי המתאר של המעגל, הקוטר שמוגדר על ידי רוחב הקו בפיקסלים).
צבע מילוי: הצבע של העיגול ממלא את הפורמט ARGB, אותו הפורמט שבו משתמשת Color. ערך ברירת המחדל הוא שקוף (0x00000000).
אינדקס Z: הסדר שבו מתבצעת שרטוט של שכבת-העל של המשבצת הזו ביחס לשכבות-על אחרות (כולל GroundOverlay, TileOverlay, Polyline ו-Polygon, אבל ולא Marker). שכבת-על עם אינדקס z גדול יותר מצוירת מעל שכבות-על עם גודל קטן יותר סימני z. הסדר של שכבות-על עם אותו z-index הוא שרירותי. ערך ברירת המחדל של 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() מחזירה את תבנית הקווים של מתאר המעגל.
מספר ממשי (float)	getStrokeWidth() הפונקציה מחזירה את רוחב הקו.
אובייקט	getTag() מקבל את התג של המעגל.
מספר ממשי (float)	getZIndex() מחזירה את zIndex.
בוליאני	isClickable() מקבל את הקליקביליות של המעגל.
בוליאני	isVisible() בודק אם העיגול גלוי.
ריק	remove() הסרת העיגול הזה מהמפה.
ריק	setCenter(LatLng center) מגדיר את המרכז באמצעות `LatLng`.
ריק	setClickable(בוליאני קליקבילי) מגדיר את הקליקביליות של המעגל.
ריק	setFillColor(int color) הגדרת צבע המילוי.
ריק	setRadius(רדיוס כפול) מגדיר את הרדיוס במטרים.
ריק	setStrokeColor(צבע צבע) מגדיר את צבע הקו.
ריק	setStrokePattern(רשימה<PatternItem> דפוס) מגדיר את תבנית הקווים של מתאר העיגול.
ריק	setStrokeWidth(רוחב צף) מגדיר את רוחב הקווים.
ריק	setTag(תג אובייקט) מגדיר את התג למעגל.
ריק	setVisible(boolean visible) מגדיר את מידת החשיפה של המעגל.
ריק	setZIndex(float zIndex) מגדיר את ה-zIndex.

סיכום השיטות שעברו בירושה

מהכיתה JavaScript.lang.Object

בוליאני	equals(אובייקט arg0)
סופי כיתה<?>	getClass()
int	hashCode()
סופי ריק	notify()
סופי ריק	notifyAll()
מחרוזת	toString()
סופי ריק	wait(long arg0, int arg1)
סופי ריק	wait(ארוך arg0)
סופי ריק	wait()

שיטות ציבוריות

ציבורי LatLng getCenter ()

הפונקציה מחזירה את המרכז בתור LatLng.

החזרות

המרכז הגיאוגרפי כLatLng.

ציבורי INT getFillColor ()

מחזירה את צבע המילוי של המעגל הזה.

החזרות

צבע המילוי של העיגול בפורמט ARGB.

ציבורי מחרוזת (String) getId ()

מקבל את מזהה המעגל הזה. המזהה יהיה ייחודי בין כל המעגלים במפה.

ציבורי כפול getRadius ()

מחזירה את רדיוס המעגל במטרים.

החזרות

הרדיוס במטרים.

ציבורי INT getStrokeColor ()

הפונקציה מחזירה את צבע הקו.

החזרות

צבע העיגול בפורמט ARGB.

ציבורי רשימה<PatternItem> getStrokePattern ()

מחזירה את תבנית הקווים של מתאר המעגל.

החזרות

את קו ביטול הנעילה.

ציבורי מספר ממשי (float) getStrokeWidth ()

הפונקציה מחזירה את רוחב הקו.

החזרות

הרוחב בפיקסלים במסך.

ציבורי אובייקט getTag ()

מקבל את התג של המעגל.

החזרות

התג אם הוגדר בתג setTag null אם לא הוגדר תג.

ציבורי מספר ממשי (float) getZIndex ()

מחזירה את zIndex.

החזרות

ה-zIndex של המעגל הזה.

ציבורי בוליאני isClickable ()

מקבל את הקליקביליות של המעגל. אם העיגול ניתן ללחיצה, האפליקציה תקבל התראות ל-GoogleMap.OnCircleClickListener כשהמשתמש לוחץ על העיגול. ה-event listener רשום דרך setOnCircleClickListener(GoogleMap.OnCircleClickListener).

החזרות

true אם העיגול לחיץ; false אם הוא לא קליק.

ציבורי בוליאני isVisible ()

בודק אם העיגול גלוי.

החזרות

true אם העיגול גלוי; false אם הוא בלתי נראה.

ציבורי ריק הסרה ()

הסרת העיגול הזה מהמפה. לאחר הסרת מעגל, ההתנהגות של כל המעגל לא מוגדרים.

ציבורי ריק setCenter (LatLng Center)

מגדיר את המרכז באמצעות LatLng.

הערך של המרכז לא יכול להיות null, כי אין ערך ברירת מחדל.

פרמטרים

מרכז	המרכז הגיאוגרפי של המעגל, מוגדר כ-`LatLng`.

קליעות

NullPointerException	אם הערך הוא null

ציבורי ריק setClickable (קליק בוליאני)

מגדיר את הקליקביליות של המעגל. אם העיגול ניתן ללחיצה, האפליקציה תקבל התראות ל-GoogleMap.OnCircleClickListener כשהמשתמש לוחץ על העיגול. ה-event listener רשום דרך setOnCircleClickListener(GoogleMap.OnCircleClickListener).

פרמטרים

מאפשר לחיצה	הגדרה חדשה של קליקביליות למעגל.

ציבורי ריק setFillColor (צבע צבע)

הגדרת צבע המילוי.

צבע המילוי הוא הצבע בתוך העיגול, בפורמט המספרים השלמים שצוין ב-Color. אם נעשה שימוש ב-TRANSPARENT, לא מוצג מילוי.

פרמטרים

color [צבע]	הצבע בפורמט `Color`.

ציבורי ריק setRadius (רדיוס כפול)

מגדיר את הרדיוס במטרים.

הרדיוס חייב להיות אפס או גדול יותר.

פרמטרים

רדיוס	הרדיוס, במטרים.

קליעות

IllegalArgumentException	אם הרדיוס הוא שלילי

ציבורי ריק setStrokeColor (צבע צבע)

מגדיר את צבע הקו.

צבע הקו הוא הצבע של המתאר של העיגול, בפורמט המספרים השלמים שצוין על ידי Color אם משתמשים ב-TRANSPARENT, לא מתבצעת שרטוט של מתאר.

פרמטרים

color [צבע]	צבע הקו בפורמט `Color`.

ציבורי ריק setStrokePattern (רשימה<PatternItem> דפוס)

מגדיר את תבנית הקווים של מתאר העיגול. קו ביטול הנעילה המוגדר כברירת מחדל הוא קבוע, שהייצוג שלו הוא null.

פרמטרים

קו ביטול נעילה	את קו ביטול הנעילה.

ציבורי ריק setStrokeWidth (רוחב צף)

מגדיר את רוחב הקווים.

רוחב הקווים הוא הרוחב (בפיקסלים של המסך) של מתאר העיגול. הוא חייב להיות אפס או גדול יותר. אם הוא אפס, לא ייכתב קווי מתאר. ערך ברירת המחדל הוא 10.

פרמטרים

רוחב	רוחב הקווים, בפיקסלים במסך.

קליעות

IllegalArgumentException	אם הרוחב הוא שלילי

ציבורי ריק setTag (תג אובייקט)

מגדיר את התג למעגל.

ניתן להשתמש במאפיין הזה כדי לשייך Object שרירותי למעגל הזה. עבור לדוגמה, Object יכול להכיל נתונים על מה שהעיגול מייצג. זה קל יותר מאשר לאחסן Map<Circle, Object> נפרד. דוגמה נוספת, ניתן לשייך מזהה String שתואם למזהה מתוך קבוצת נתונים. SDK של מפות Google ל-Android לא קורא או כותב את המאפיין הזה. באחריותך להתקשר אל setTag(null) כדי את התג כשכבר אין בו צורך, כדי למנוע דליפות זיכרון באפליקציה.

פרמטרים

תג	אם הערך הוא null, התג יוסר.

ציבורי ריק setVisible (בוליאני גלוי)

מגדיר את מידת החשיפה של המעגל.

אם המעגל אינו גלוי, הוא לא יוצג. כל שאר המצבים נשמרים. המעגלים גלויים כברירת מחדל.

פרמטרים

גלוי	`true` כדי להפוך את המעגל הזה לגלוי; `false` כדי להפוך אותו לבלתי נראה.

ציבורי ריק setZIndex (מספר ממשי (zIndex)

מגדיר את ה-zIndex.

שכבות-על (כגון עיגולים) עם אינדקסים גבוהים יותר מצוירות מעל שכבות-על עם אינדקסים נמוכים יותר.

פרמטרים

zIndex	הערך של zIndex.