מעגל

כיתה סופית ציבורית ציבורית מעגל מרחיב את האובייקט

עיגול על פני השטח של כדור הארץ (מכסה כדורית).

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

סֶנטר

מרכז המעגל מצוין כ-LatLng.

Radius

רדיוס המעגל, מצוין במטרים. הערך צריך להיות אפס או יותר.

רוחב קו

רוחב קווי המתאר של העיגול בפיקסלים של המסך. הרוחב קבוע ובלתי תלוי ברמת הזום של המצלמה. ערך ברירת המחדל הוא 10.

צבע הקו

הצבע של קווי המתאר של העיגול בפורמט ARGB, באותו פורמט שבו משתמש Color. ערך ברירת המחדל הוא שחור (0xff000000).

תבנית משיכה

קבוע (ברירת המחדל, מיוצג על ידי null) או רצף של PatternItem אובייקטים שיש לחזור עליהם לאורך קווי המתאר של העיגול. סוגי הPatternItem הזמינים: Gap (מוגדר לפי אורך הפער בפיקסלים), Dash (מוגדר לפי רוחב הקו ואורך המקף בפיקסלים) ו-Dot (מעגלי, במרכז קו המתאר של העיגול, והקוטר מוגדר לפי רוחב הקו בפיקסלים).

צבע מילוי

צבע העיגול הוא בפורמט ARGB, באותו פורמט שבו משתמש Color. ערך ברירת המחדל הוא שקוף (0x00000000).

מדד Z

הסדר שבו נוצר שכבת-העל של המשבצת הזו ביחס לשכבות-על אחרות (כולל שכבות-על אחרות (כולל GroundOverlay, TileOverlay, Polyline, ו-Polygon, אבל לא Marker). שכבת-על עם אינדקס-z גדול יותר משורטטת מעל שכבות-על עם אינדקסים קטנים יותר. הסדר של שכבות-העל עם אותו אינדקס z הוא שרירותי. ערך ברירת המחדל של zIndex הוא 0.

חשיפה

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

תיוג

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

חובה לקרוא לשיטות במחלקה הזו ב-thread UI של 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(רשימה<PatternItem> תבנית) מגדיר את תבנית הקווים של קווי המתאר של המעגל.
void	setStrokeWidth(רוחב צף) מגדיר את רוחב הקווים.
void	setTag(תג אובייקט) מגדיר את התג של המעגל.
void	setVisible(גלוי בוליאני) מגדיר את החשיפה של המעגל.
void	setZIndex(float zIndex) מגדיר את zIndex.

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

מכיתה java.lang.Object

boolean	equals(Object arg0)
סופי כיתה<?>	getClass()
int	hashCode()
תוקף סופי	notify()
תוקף סופי	notifyAll()
מחרוזת	toString()
תוקף סופי	wait(long arg0, int arg1)
תוקף סופי	wait(long arg0)
תוקף סופי	wait()

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

ציבורי LatLng getCenter ()

מחזירה את המרכז כ-LatLng.

החזרות

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

int ציבורי getFillColor ()

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

החזרות

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

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

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

Public כפול getRadius ()

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

החזרות

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

int ציבורי getStrokeColor ()

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

החזרות

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

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

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

החזרות

• את תבנית הקווים.

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

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

החזרות

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

Public אובייקט getTag ()

הפונקציה מקבלת את התג של המעגל.

החזרות

• התג אם התג הוגדר עם setTag; null אם לא הוגדר תג.

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

מחזירה את zIndex.

החזרות

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

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

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

החזרות

• true אם המעגל ניתן ללחיצה, false אם לא ניתן ללחוץ עליו.

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

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

החזרות

• true אם המעגל גלוי, false אם הוא בלתי נראה.

Public void הסרה ()

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

Public void setCenter (מרכז LatLng)

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

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

פרמטרים

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

קליעות

NullPointerException	אם המרכז הוא null

Public void setClickable (ניתנת ללחיצה בוליאנית)

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

פרמטרים

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

Public void setFillColor (int color)

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

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

פרמטרים

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

Public void setRadius (רדיוס כפול)

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

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

פרמטרים

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

קליעות

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

Public void setStrokeColor (int color)

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

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

פרמטרים

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

Public void setStrokePattern (List<PatternItem> דפוס)

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

פרמטרים

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

Public void setStrokeWidth (float רוחב)

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

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

פרמטרים

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

קליעות

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

Public void setTag (תג אובייקט)

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

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

פרמטרים

תג	אם null, התג ינוקה.

Public void setVisible (boolean visible)

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

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

פרמטרים

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

Public void setZIndex (float zIndex)

מגדיר את zIndex.

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

פרמטרים

zIndex	ערך zIndex.