מצולע פתוח

מחלקה סופית ציבורית Polyline מרחיבה את האובייקט

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

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

חובה לקרוא לשיטות במחלקה הזו ב-thread UI של 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));

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

מידע נוסף זמין במדריך למפתחים בנושא צורות.

סיכום אמצעי תשלום ציבורי

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

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

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

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

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

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

int ציבורי getColor ()

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

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

Public הגבלה getEndCap ()

הפונקציה משיגה את המכסה בקצה הקודקוד של ה-polyline.

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

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

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

החזרות
  • את המזהה של קו מרובה זה.

int ציבורי getJointType ()

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

החזרות
  • במשותף.

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

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

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

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

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

Public הגבלה getStartCap ()

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

החזרות
  • סימן ההתחלה.

Public אובייקט getTag ()

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

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

ערך צף ציבורי getWidth ()

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

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

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

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

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

int ציבורי hashCode ()

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

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

החזרות
  • true אם אפשר ללחוץ על קו מרובה-הקווים; אחרת, הפונקציה מחזירה את הערך false.

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

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

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

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

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

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

Public void הסרה ()

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

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

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

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

Public void setColor (int color)

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

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

Public void setEndCap (Cap endCap)

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

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

Public void setGeodesic (boolean geodesic)

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

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

Public void setJointType (int jointType)

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

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

פרמטרים
jointType במשותף.

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

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

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

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

מגדיר את הנקודות של קו פוליגוני זה. השיטה הזו תיצור עותק של הנקודות, כך שלמוטציות נוספות ל-points לא תהיה השפעה על קו הפוליגון הזה.

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

Public void setSpans (List<StyleSpan> span)

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

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

Public void setStartCap (Cap startCap)

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

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

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

מגדיר את התג לקו ה-polyline.

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

פרמטרים
תג אם null, התג ינוקה.

Public void setVisible (boolean visible)

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

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

Public void setWidth (רוחב צף)

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

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

Public void setZIndex (float zIndex)

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

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