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

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

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

מיקום
יש שתי דרכים לציין את המיקום של שכבת-העל של הקרקע:
  • שימוש במיקום: עליך לספק תמונה של שכבת-העל של הקרקע, LatLng שבו העוגן יהיה קבוע ורוחב שכבת-העל (במטרים). כברירת מחדל, נמצא 50% מהחלק העליון של התמונה ו-50% מהחלק השמאלי תמונה. אפשר לשנות את זה. אפשר גם לספק את הגובה של שכבת-העל מטרים). אם לא תספקו את הגובה של שכבת-העל, היא תוגדר באופן אוטומטי כדי לשמר את הפרופורציות של התמונה.
  • שימוש בגבולות: יש לספק LatLngBounds שיכיל את התמונה.
עליך לציין את המיקום של שכבת-העל של הקרקע לפני הוספתה למפה, אחרת המערכת תזרק IllegalArgumentException כששכבת-העל של הקרקע נוסף למפה. כמו כן, יש לציין את המיקום רק באמצעות אחת מהאפשרויות הבאות methods באובייקט GroundOverlayOptions; אחרת, יופעל הערך IllegalStateException כשמציינים באמצעות שיטה שנייה.
תמונה
התמונה (כ-BitmapDescriptor) שתשמש לשכבת-העל הזו. התמונה תהיה בהתאמה למיקום שצוין. עליך לציין תמונה לפני הוספת הקרקע להציג שכבת-על במפה; אם לא, תתבצע התרעה של IllegalArgumentException כשהוא נוסף למפה.
כיוון
מידת הסיבוב שבה צריך לסובב את התמונה בכיוון השעון. המרכז של יהיה העוגן של התמונה. הערך הזה אופציונלי, ורמת ברירת המחדל היא 0. כלומר, התמונה מיושרת כך שהיא למעלה מצפון.
zIndex
הסדר שבו מתבצעת שרטוט של שכבת-העל הזו ביחס לשכבות-על אחרות (כולל Polyline ו-TileOverlay, אבל לא Marker. שכבת-על עם zIndex גדול יותר משורטט על שכבות-על עם ערכי zIndexים קטנים יותר. הסדר של שכבות-על עם הרכיב אותו ערך 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 לא קורא או כותב את המאפיין הזה.

צריך לקרוא לשיטות בכיתה הזו בשרשור של ממשק המשתמש של 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));

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

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

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

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

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

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

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

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

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

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

ציבורי LatLngBounds getBounds ()

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

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

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

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

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

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

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

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

ציבורי LatLng getPosition ()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ציבורי INT hashCode ()

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

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

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

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

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

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

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

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

ציבורי ריק setBearing (נושא צף)

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

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

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

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

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

ציבורי ריק setDimensions (רוחב צף, גובה צף)

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

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

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

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

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

ציבורי ריק setImage (BitmapDescriptor imageDescriptor)

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

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

ציבורי ריק setPosition (LatLng latLng)

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

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

ציבורי ריק setPositionFromBounds (LatLngBounds)

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

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

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

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

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

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

ציבורי ריק setTransparency (שקיפות צפה)

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

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

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

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

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

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

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

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