שכבת-על של אריח

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

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

ספק משבצות
ה-TileProvider מספק את התמונות שבהן נעשה שימוש בשכבת-העל של המשבצת. צריך לציין את ספק המשבצת לפני הוספתו למפה. ספק המשבצת לא יכול השתנה לאחר ההוספה; עם זאת, אפשר לשנות את ההתנהגות של ספק המשבצת כדי להחזיר תמונות שונות בקואורדינטות ספציפיות. אם המשבצות שסופקו על ידי הלחצן שינוי ספק, עליך להפעיל את clearTileCache() לאחר מכן כדי לוודא המשבצות הקודמות כבר לא מעובדות.
אינדקס Z
הסדר שבו מתבצעת שרטוט של שכבת-העל של המשבצת הזו ביחס לשכבות-על אחרות (כולל GroundOverlay, Circle, Polyline ו-Polygon, אבל לא Markers). שכבת-על עם אינדקס z גדול יותר מצוירת מעל שכבות-על עם גודל קטן יותר סימני z. הסדר של שכבות-על עם אותו z-index הוא שרירותי. ערך ברירת המחדל של zIndex הוא 0.
שקיפות
שקיפות של שכבת-העל של המשבצת בטווח [0..1] שבו 0 פירושו שכבת-העל אטומה ו-1 מציינת ששכבת-העל שקופה לחלוטין. אם מפת הסיביות כבר שקופה באופן חלקי, השקיפות של כל פיקסל תשתנה בהתאם (לדוגמה, אם לפיקסל במפת הביטים יש ערך אלפא של 200, לציין את השקיפות של שכבת-העל של המשבצת כ-0.25, ולאחר מכן הפיקסל יוצג במסך עם ערך אלפא של 150). המפרט של המאפיין הזה הוא אופציונלי ערך ברירת המחדל של השקיפות הוא 0 (אטום).
חשיפה
מראה אם שכבת-העל של המשבצת גלויה או בלתי נראית, כלומר אם היא משורטטת מפה שכבת-על של משבצת בלתי נראית לא משורטטת, אבל כל המאפיינים האחרים שלה נשמרים. ברירת המחדל היא true, כלומר, גלויה.

אפשר להתקשר ל-methods בכיתה הזו רק בשרשור הראשי. אחרת, IllegalStateException.

קואורדינטות של אריחים

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

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

  • ברמת זום 0, אריח אחד מייצג את העולם כולו. הקואורדינטות של אותו אריח הן (x, y) = (0, 0).
  • ברמת זום 1, העולם מחולק ל-4 משבצות שמסודרים ברשת של 2 x 2.
  • ...
  • ברמת זום N, העולם מחולק ל-4 N משבצות שמסודרים לפי 2 N x רשת בגודל 2N.
שימו לב שרמת הזום המינימלית שנתמכת במצלמה (שעשויה להיות תלויה בגורמים שונים) היא GoogleMap.getMinZoomLevel ו רמת הזום המקסימלית היא GoogleMap.getMaxZoomLevel.

הקואורדינטות של המשבצות נמדדות מהפינה השמאלית העליונה (צפון-מערב) של המפה. בשעה רמת הזום N, ערכי x של קואורדינטות המשבצת נעים בין 0 ל-2N - 1 עולה ממערב למזרח והערכים של y נעים בין 0 ל-2N - 1 וגם להגדיל מצפון לדרום.

דוגמה

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));

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

ריק
clearTileCache()
ניקוי המטמון של המשבצות כך שבקשות נוספות של כל המשבצות יישלחו מ-TileProvider.
בוליאני
שווה ל-(אובייקט אחר)
הפונקציה בודקת אם TileOverlay הזה שווה לערך אחר.
בוליאני
getFadeIn()
המדיניות מאפשרת לקבוע אם המשבצות של שכבת-העל אמורות להתעמעם.
מחרוזת
getId()
מקבל את המזהה של שכבת-העל של המשבצת הזו.
מספר ממשי (float)
getTransparency()
מספקת את השקיפות של שכבת-העל של המשבצת הזו.
מספר ממשי (float)
getZIndex()
הפונקציה מקבלת את ה-zIndex של שכבת-העל של המשבצת.
int
hashCode()
בוליאני
isVisible()
קבלת החשיפה של שכבת-העל של המשבצת הזו.
ריק
remove()
הסרת שכבת-העל של משבצת זו מהמפה.
ריק
setFadeIn(boolean fadeIn)
מגדירה אם המשבצות של שכבת-העל צריכות להתעמעם.
ריק
setTransparency(שקיפות ציפה)
הגדרת השקיפות של שכבת-העל של המשבצת.
ריק
setVisible(boolean visible)
הגדרת החשיפה של שכבת-העל של המשבצת.
ריק
setZIndex(float zIndex)
מגדיר את ה-zIndex של שכבת-העל של המשבצת.

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

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

ציבורי ריק clearTileCache ()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ציבורי INT hashCode ()

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

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

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

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

הסרת שכבת-העל של משבצת זו מהמפה.

ציבורי ריק setFadeIn (עמעום בוליאני)

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

פרמטרים
fadeIn true כדי לטשטש את המשבצות. false כדי לעבד אותם באופן מיידי.

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

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

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

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

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

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

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

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

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