שכבת-על לקרקע

כיתה סופית ציבורית ציבורית GroundOverlay מרחיבה את האובייקט

שכבת-על של קרקע היא תמונה הקבועה במפה. לשכבת-על של קרקע יש את המאפיינים הבאים:

מיקום
יש שתי דרכים לציין את המיקום של שכבת-העל של הקרקע:
  • שימוש במיקום: עליך לספק תמונה של שכבת-העל של הקרקע, LatLng שאליו יחובר העוגן ורוחב שכבת-העל (במטרים). כברירת מחדל, העוגן מופיע ב-50% מהחלק העליון של התמונה ו-50% מהקצה השמאלי של התמונה. אפשר לשנות זאת. אפשר לציין את גובה שכבת-העל (במטרים). אם לא מציינים את הגובה של שכבת-העל, המערכת תחושב אוטומטית כדי שהפרופורציות של התמונה יישמרו.
  • שימוש בגבולות: עליך לספק LatLngBounds שיכלול את התמונה.
עליך לציין את המיקום של שכבת-העל של הקרקע לפני ההוספה שלה למפה, אחרת יתווסף IllegalArgumentException בעת הוספת שכבת-העל של הקרקע למפה. בנוסף, צריך לציין את המיקום רק באמצעות אחת מהשיטות האלה באובייקט GroundOverlayOptions. אחרת, יוקצה IllegalStateException כשמציינים באמצעות שיטה שנייה.
תמונה
התמונה (כBitmapDescriptor) שתשמש בשכבת-העל הזו. גודל התמונה יותאם למיקום המתאים. עליך לציין תמונה לפני הוספת שכבת-העל של הקרקע למפה. אם לא, יזרק IllegalArgumentException לאחר ההוספה למפה.
כיוון
הגודל שיש לסובב את התמונה בכיוון השעון. מרכז הסיבוב יהיה העוגן של התמונה. זה אופציונלי וכיוון ברירת המחדל הוא 0, כלומר, התמונה מיושרת כך שפונה למעלה לצפון.
zIndex
הסדר שבו נוצר שכבת-העל הזו על הקרקע ביחס לשכבות-על אחרות (כולל Polyline ו-TileOverlay, אבל לא Marker). שכבת-על עם zIndex גדול יותר משורטטת מעל שכבות-על עם zIndexes קטנים יותר. הסדר של שכבות-העל עם אותו ערך zIndex הוא שרירותי. זה אופציונלי וברירת המחדל של zIndex היא 0.
שקיפות
שקיפות של שכבת-העל של הקרקע בטווח [0..1]. המשמעות של 0 היא ששכבת-העל אטומה, והמשמעות של 1 היא ששכבת-העל שקופה לחלוטין. אם מפת הסיביות שצוינה כבר שקופה חלקית, השקיפות של כל פיקסל תותאם בהתאם (לדוגמה, אם לפיקסל במפת הסיביות יש ערך אלפא של 200 ואתם מציינים את השקיפות של שכבת-העל של הקרקע כ-0.25, אז הפיקסל יעובד על המסך עם ערך אלפא של 150). המפרט של המאפיין הזה הוא אופציונלי וברירת המחדל של השקיפות היא 0 (אטום).
חשיפה
מראה אם שכבת-העל של הקרקע גלויה או מוסתרת, כלומר אם היא משורטטת במפה. לא משורטטת שכבת-על בלתי נראית של הקרקע, אך כל המאפיינים האחרים שלה נשמרים. הפעולה הזו אופציונלית וברירת המחדל של הרשאות הגישה היא true, כלומר גלויה.
קליקביליות
אם רוצים לטפל באירועים שהופעלו כשהמשתמש לוחץ על שכבת-העל של הקרקע, צריך להגדיר את המאפיין הזה כ-true. אפשר לשנות את הערך הזה בכל שלב. ברירת המחדל היא false. אם המאפיין הזה מוגדר לערך true, האפליקציה שלך תקבל התראות ל-GoogleMap.OnGroundOverlayClickListener שנרשמו דרך setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
תיוג
Object המשויך לשכבת-העל של הקרקע. לדוגמה, השדה Object יכול להכיל נתונים על מה שמוצג בשכבת-העל של הקרקע. זה קל יותר מאחסון של קובץ Map<GroundOverlay, Object> נפרד. דוגמה נוספת: ניתן לשייך מזהה String שתואם למזהה ממערך נתונים. ה-SDK של מפות Google ל-Android לא קורא או כותב את הנכס הזה.

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

דוגמה

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));

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

boolean
equals(אובייקט אחר)
הפונקציה בודקת אם GroundOverlay הזה שווה לערך אחר.
float
getBearing()
הפונקציה מקבלת את זווית ההשפעה של שכבת-העל על הקרקע במעלות בכיוון השעון מצפון.
LatLngBounds
getBounds()
הפונקציה הזו משיגה את הגבולות של שכבת העל של הקרקע.
float
getHeight()
הפונקציה מקבלת את הגובה של שכבת-העל של הקרקע.
מחרוזת
getId()
הפונקציה מקבלת את המזהה של שכבת-העל של הקרקע.
LatLng
getPosition()
הפונקציה מקבלת את המיקום של נקודת העיגון.
אובייקט
getTag()
הפונקציה מקבלת את התג של המעגל.
float
getTransparency()
מאפשר לקבל את השקיפות של שכבת-העל הזו.
float
getWidth()
הפונקציה מקבלת את הרוחב של שכבת-העל של הקרקע.
float
getZIndex()
הפונקציה מקבלת את ה-zIndex של שכבת העל של הקרקע.
int
hashCode()
boolean
isClickable()
הפונקציה מקבלת את הקליקביליות של שכבת העל של הקרקע.
boolean
isVisible()
מאפשר לראות את שכבת-העל של הקרקע.
void
remove()
מסיר את שכבת-העל של הקרקע מהמפה.
void
setBearing(נושא צף)
המדיניות הזו מגדירה את הנושאים של שכבת-העל של הקרקע (הכיוון שבו הציר האנכי של שכבת-העל של הקרקע פונה) במעלות בכיוון השעון מצפון.
void
setClickable(ערך בוליאני לחיץ)
מגדיר את הקליקביליות של שכבת העל של הקרקע.
void
setDimensions(רוחב ציפה, גובה צף)
מגדיר את המידות של שכבת-העל של הקרקע.
void
setDimensions(רוחב צף)
מגדיר את רוחב שכבת-העל של הקרקע.
void
setImage(BitmapDescriptor imageDescriptor)
מגדיר את התמונה לשכבת-על של קרקע.
void
setPosition(LatLng latLng)
מגדיר את המיקום של שכבת-העל של הקרקע על ידי שינוי המיקום של נקודת העיגון.
void
setPositionFromBounds(LatLngBounds bounds)
מגדיר את המיקום של שכבת-העל של הקרקע על ידי התאמה שלה ל-LatLngBounds הנתון.
void
setTag(תג אובייקט)
מגדיר את התג לשכבת-העל של הקרקע.
void
setTransparency(שקיפות צפה)
הגדרת השקיפות של שכבת-העל לקרקע.
void
setVisible(גלוי בוליאני)
הגדרת החשיפה של שכבת-העל של הקרקע.
void
setZIndex(float zIndex)
מגדיר את zIndex של שכבת העל של הקרקע.

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

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

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

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

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

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

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

החזרות
  • ההשפעה של שכבת העל.

ציבורי LatLngBounds getBounds ()

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

החזרות
  • LatLngBounds שמכיל את שכבת-העל של הקרקע, תוך התעלמות מסיבוב.

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

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

החזרות
  • גובה שכבת-העל של הקרקע במטרים.

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

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

החזרות
  • המזהה של שכבת-העל של הקרקע.

ציבורי LatLng getPosition ()

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

החזרות
  • המיקום במפה (LatLng).

Public אובייקט getTag ()

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

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

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

מאפשר לקבל את השקיפות של שכבת-העל הזו.

החזרות
  • השקיפות של שכבת העל הזו.

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

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

החזרות
  • רוחב שכבת-העל של הקרקע במטרים.

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

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

החזרות
  • את zIndex של שכבת העל של הקרקע.

int ציבורי hashCode ()

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

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

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

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

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

החזרות
  • החשיפה של שכבת העל.

Public void הסרה ()

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

Public void setBearing (נושא צף)

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

פרמטרים
נשיאה סיבוב במעלות בכיוון השעון מצפון

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

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

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

Public void setDimensions (float רוחב, float height)

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

פרמטרים
רוחב רוחב במטרים
גובה גובה במטרים

Public void setDimensions (float רוחב)

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

פרמטרים
רוחב רוחב במטרים

Public void setImage (BitmapDescriptor imageDescriptor)

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

פרמטרים
imageDescriptor BitmapDescriptor שישמש לשכבת-העל של הקרקע.

Public void setPosition (LatLng latLng)

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

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

Public void setPositionFromBounds (LatLngBounds bounds)

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

פרמטרים
גבולות LatLngBounds שבו תציב את שכבת-העל של הקרקע

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

מגדיר את התג לשכבת-העל של הקרקע.

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

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

Public void setTransparency (שקיפות ציפה)

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

פרמטרים
במידה הולמת ערך צף בטווח [0..1]. המשמעות של 0 היא ששכבת-העל של הקרקע אטומה, והמשמעות של 1 היא ששכבת-העל של הקרקע שקופה.

Public void setVisible (boolean visible)

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

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

Public void setZIndex (float zIndex)

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

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