מצולע פתוח

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

קו פוליגוני הוא רשימה של נקודות, שבהן קטעי הקו משורטטים בין נקודות עוקבות. א' לקו פוליגוני יש את המאפיינים הבאים:

נקודות
נקודות הקוד של הקו. קטעי קו משורטטים בין נקודות עוקבות. קו פוליגוני הוא לא סגור כברירת מחדל; כדי ליצור קו פוליגוני סגור, נקודות ההתחלה והסיום חייבות להיות כמעט זהים.
רוחב
רוחב של קטע קו בפיקסלים במסך. הרוחב קבוע ולא תלוי במאפייני המצלמה רמת הזום. ערך ברירת המחדל הוא 10.
צבע
צבע קטע הקו בפורמט ARGB, אותו הפורמט שבו נעשה שימוש ב-Color. ערך ברירת המחדל הוא שחור (0xff000000).
מודעת סגירה לסרטון
הגדרת הצורה שתשמש בהתחלה או בסוף של קו פוליגוני. סוגי המכסות הנתמכים: ButtCap, SquareCap, RoundCap (רלוונטי לתבנית קווים מלאים) וכן CustomCap (רלוונטי לכל תבנית קווים). ברירת המחדל של התחלה ושל סיום: ButtCap
סוג החיבור
סוג המפרק מגדיר את הצורה שתשמש כשמחברים בין מקטעי קו סמוכים הקודקודים של הקו הפוליגוני מלבד קודקודי ההתחלה והסיום. הצגת JointType ל- סוגי החיבורים הנתמכים. ערך ברירת המחדל הוא DEFAULT.
קו ביטול נעילה
רציף (ברירת מחדל, מיוצג על ידי null) או רצף של PatternItem אובייקטים שיחזרו על עצמם לאורך הקו. הסוגים הזמינים של PatternItem: Gap (מוגדר על ידי אורך הפער בפיקסלים), Dash (מוגדר לפי רוחב הקו ואורך הקו בפיקסלים) ו Dot (עגול, ממורכז על הקו, קוטר מוגדר לפי רוחב הקו בפיקסלים).
אינדקס Z
הסדר שבו מתבצעת שרטוט של שכבת-העל של המשבצת הזו ביחס לשכבות-על אחרות (כולל GroundOverlay, TileOverlay, Circle ו-Polygon, אבל לא Markers). שכבת-על עם אינדקס z גדול יותר מצוירת מעל שכבות-על עם גודל קטן יותר סימני z. הסדר של שכבות-על עם אותו z-index הוא שרירותי. ערך ברירת המחדל של zIndex הוא 0.
חשיפה
מציין אם הקו הפוליגוני גלוי או בלתי נראה, כלומר אם הוא משורטט במפה. קו פוליגוני בלתי נראה לא משורטט, אלא שומר את כל המאפיינים האחרים שלו. ברירת המחדל היא true, כלומר גלוי.
סטטוס גיאודזי
מציין אם יש לצייר את הקטעים של הקו הפוליגוני כגאודסיקה, ולא קווים ישרים בהיטל Mercator. גאודזית היא הדרך הקצרה ביותר בין שני על פני השטח של כדור הארץ. העקומה הגאודזית נבנית בהנחה שכדור הארץ הוא כדור
קליקביליות
אם ברצונך לטפל באירועים שהופעלו כשהמשתמשים לוחצים על קו הפוליגוני, צריך להגדיר את המאפיין הזה בתור true. אפשר לשנות את הערך הזה בכל שלב. ערך ברירת המחדל הוא false. אם הנכס מוגדר ל-true, האפליקציה שלך תקבל התראות אל GoogleMap.OnPolylineClickListener שנרשם באמצעות setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
תיוג
Object שמשויך לקו הפוליגוני. לדוגמה, Object יכול להכיל על מה שהקו הפוליגוני מייצג. הפעולה הזו קלה יותר מאשר אחסון נפרד של Map<Polyline, Object>. דוגמה נוספת, אפשר לשייך מזהה String שתואם למזהה מתוך קבוצת נתונים. ערכת ה-SDK של מפות Google ל-Android לא יכולה לקרוא או כותב את המאפיין הזה.
ספרד
מגדירה את טווחי התאים עם סגנונות שונים שמשמשים לעיבוד הקו הפוליגוני הזה. אפשר להשתמש ליצירת קו פוליגוני עם StrokeStyle שונה בקטעים שונים של הקו הפוליגוני.

צריך לקרוא לשיטות בכיתה הזו בשרשור של ממשק המשתמש של Android. אם לא, המערכת תשליך IllegalStateException בזמן הריצה.

דוגמה

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));

מדריך למפתחים

למידע נוסף, אפשר לקרוא את המאמר בנושא צורות מותאמת אישית.

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

בוליאני
שווה ל-(אובייקט אחר)
הפונקציה בודקת אם Polyline הזה שווה לערך אחר.
int
getColor()
מקבל את הצבע של הקו הפוליגוני הזה.
כובע
getEndCap()
מקבלת את המכסה בקצה הפוליטי הזה.
מחרוזת
getId()
מקבל את המזהה של הקו הפוליגוני הזה.
int
getJointType()
הפונקציה מקבלת את סוג המפרק שמשמש בכל הקודקודים של הקו הפוליגוני מלבד קודקודי ההתחלה והסיום.
רשימה<PatternItem>
getPattern()
מקבל את דפוס הקווים של הקו הפוליגוני הזה.
רשימה<LatLng>
getPoints()
מחזירה תמונת מצב של הקודקודים של קו פוליגוני זה כרגע .
כובע
getStartCap()
מקבלת את המכסה בקודקוד ההתחלה של הקו הפוליגוני הזה.
אובייקט
getTag()
מקבלת את התג של הקו הפוליגוני.
מספר ממשי (float)
getWidth()
קבלת הרוחב של הקו הפוליגוני הזה.
מספר ממשי (float)
getZIndex()
מקבלת את ה-zIndex של הקו הפוליגוני הזה.
int
hashCode()
בוליאני
isClickable()
הפונקציה מקבלת את הקליקביליות של הקו הפוליגוני.
בוליאני
isGeodesic()
הפונקציה מקבלת אם כל קטע של הקו ישר כגיאודזי או לא.
בוליאני
isVisible()
מקבל את החשיפה של הקו הפוליגוני הזה.
ריק
remove()
הסרת הקו הפוליגוני הזה מהמפה.
ריק
setClickable(בוליאני קליקבילי)
מגדיר את הקליקביליות של הקו הפוליגוני.
ריק
setColor(צבע צבע)
מגדיר את הצבע של הקו הפוליגוני הזה.
ריק
setEndCap(Cap endCap)
מגדירה את המכסה בקודקוד הפוליגוני הזה.
ריק
setGeodesic(boolean geodesic)
קובע אם לשרטט כל קטע קו כגיאודזי או לא.
ריק
setJointType(int jointType)
מגדיר את סוג המפרק לכל הקודקודים של הקו הפוליגוני מלבד קודקודי ההתחלה והסיום.
ריק
setPattern(רשימה<PatternItem> דפוס)
מגדיר את דפוס הקווים של הקו הפוליגוני.
ריק
setPoints(רשימה <LatLng> נקודות)
מגדיר את הנקודות של קו הפוליגוני הזה.
ריק
setSpans(List<StyleSpan> spans)
מגדיר טווחים של קו פוליגוני.
ריק
setStartCap(כובע startCap)
מגדירה את המכסה בקודקוד ההתחלה של הקו הפוליגוני הזה.
ריק
setTag(תג אובייקט)
מגדיר את התג של הקו הפוליגוני.
ריק
setVisible(boolean visible)
מגדיר את החשיפה של קו הפוליגוני הזה.
ריק
setWidth(רוחב צף)
מגדיר את הרוחב של קו הפוליגוני הזה.
ריק
setZIndex(float zIndex)
מגדיר את ה-zIndex של הקו הפוליגוני הזה.

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

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

ציבורי בוליאני שווה ל- (אובייקט אחר)

הפונקציה בודקת אם Polyline הזה שווה לערך אחר.

פרמטרים
אחר Object.
החזרות
  • true אם שני האובייקטים הם אותו אובייקט, כלומר הערך הזה הוא == other.

ציבורי INT getColor ()

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

החזרות
  • הצבע בפורמט ARGB.

ציבורי מכסה getEndCap ()

מקבלת את המכסה בקצה הפוליטי הזה.

החזרות
  • סוג מודעת סגירה.

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

מקבל את המזהה של הקו הפוליגוני הזה. המזהה יהיה ייחודי בין כל הקווים ה-Polylines במפה.

החזרות
  • המזהה של הקו הפוליגוני הזה.

ציבורי INT getJointType ()

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

החזרות
  • סוג החיבור.

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

מקבל את דפוס הקווים של הקו הפוליגוני הזה.

החזרות
  • את קו ביטול הנעילה.

ציבורי רשימה<LatLng> getPoints ()

מחזירה תמונת מצב של הקודקודים של קו פוליגוני זה כרגע . הרשימה שהוחזרה היא עותק של רשימת הקודקודים, לכן שינויים בקודקודים של הקו הפוליגוני לא יבואו לידי ביטוי והשינויים ברשימה זו לא ישתקפו בקו הפוליגוני. כדי לשנות את הקודקודים של קו פוליגוני, קוראים לפונקציה setPoints(List).

ציבורי מכסה getStartCap ()

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

החזרות
  • את המכסה הראשונית.

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

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

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

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

קבלת הרוחב של הקו הפוליגוני הזה.

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

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

מקבלת את ה-zIndex של הקו הפוליגוני הזה.

החזרות
  • את ה-zIndex של הקו הפוליגוני.

ציבורי INT hashCode ()

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

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

החזרות
  • true אם ניתן ללחוץ על הקו הפוליגוני; אחרת, מחזירה false.

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

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

החזרות
  • true אם כל מקטע משורטט כגאודזית; false אם כל פלח משורטט כקו ישר בהיטל Mercator.

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

מקבל את החשיפה של הקו הפוליגוני הזה.

החזרות
  • החשיפה של הקו הפוליגוני הזה.

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

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

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

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

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

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

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

פרמטרים
color [צבע] הצבע בפורמט ARGB

ציבורי ריק setEndCap (מכסה endCap)

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

פרמטרים
endCap את מודעת הסיום. לא יכול להיות null.

ציבורי ריק setGeodesic (גיאודזית בוליאנית)

קובע אם לשרטט כל קטע קו כגיאודזי או לא.

פרמטרים
גיאודזית אם הערך הוא true, כל מקטע ישורטט כגאודזית; אם false, כל מקטע משורטט כקו ישר בהיטל Mercator.

ציבורי ריק setJointType (int jointType)

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

הערכים המותרים מופיעים בJointType. ערך ברירת המחדל של DEFAULT יהיה יש להשתמש בו אם סוג המשותף לא מוגדר או שאינו אחד מהערכים המותרים.

פרמטרים
jointType סוג החיבור.

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

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

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

ציבורי ריק setPoints (רשימה<LatLng> נקודות)

מגדיר את הנקודות של קו הפוליגוני הזה. בשיטה הזאת בוחרים עותק של הנקודות, למוטציות ב-points לא תהיה השפעה על הקו הפוליגוני הזה.

פרמטרים
נקודות רשימה של LatLng שהם הקודקודים של הקו הפוליגוני.

ציבורי ריק setSpans (List<StyleSpan> spans)

מגדיר טווחים של קו פוליגוני.

פרמטרים
מתפרשת

ציבורי ריק setStartCap (מכסה startCap)

מגדירה את המכסה בקודקוד ההתחלה של הקו הפוליגוני הזה. מכסת ההתחלה שמוגדרת כברירת מחדל היא ButtCap.

פרמטרים
startCap את המכסה הראשונית. לא יכול להיות null.

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

מגדיר את התג של הקו הפוליגוני.

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

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

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

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

פרמטרים
גלוי אם true, אז הקו הפוליגוני גלוי; אם false לא, אז הוא לא.

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

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

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

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

מגדיר את ה-zIndex של הקו הפוליגוני הזה. קווים פוליגוניים עם אינדקסים גבוהים יותר משורטטים מעל קווים פוליגוניים עם מדדים נמוכים יותר.

פרמטרים
zIndex את ה-zIndex של הקו הפוליגוני הזה.