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

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

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

ספק של משבצות

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

מדד Z

הסדר שבו נוצר שכבת-העל הזו של המשבצות ביחס לשכבות-על אחרות (כולל שכבות-על אחרות (כולל GroundOverlay, Circle, Polyline, ו-Polygon, אבל לא Marker). שכבת-על עם אינדקס-z גדול יותר משורטטת מעל שכבות-על עם אינדקסים קטנים יותר. הסדר של שכבות-העל עם אותו אינדקס z הוא שרירותי. ערך ברירת המחדל של zIndex הוא 0.

שקיפות

שקיפות של שכבת-העל של המשבצות בטווח [0..1]. המשמעות של 0 היא ששכבת-העל אטומה, והמשמעות של 1 היא ששכבת-העל שקופה לחלוטין. אם מפת הסיביות שצוינה כבר שקופה חלקית, השקיפות של כל פיקסל תותאם בהתאם (לדוגמה, אם לפיקסל במפת הסיביות יש ערך אלפא של 200 ואתם מציינים את השקיפות של שכבת-העל של כרטיס המידע כ-0.25, הפיקסל יעובד במסך עם ערך אלפא של 150). המפרט של המאפיין הזה הוא אופציונלי וברירת המחדל של השקיפות היא 0 (אטום).

חשיפה

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

צריך לקרוא ל-methods של המחלקה הזו ב-thread הראשי בלבד. אחרת, יתקבל IllegalStateException.

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

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

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

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

חשוב לזכור שרמת הזום המינימלית שנתמכת במצלמה (תלויה בגורמים שונים) היא GoogleMap.getMinZoomLevel ורמת הזום המקסימלית היא GoogleMap.getMaxZoomLevel.

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

דוגמה

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

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

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

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

מכיתה java.lang.Object

boolean	equals(Object arg0)
סופי כיתה<?>	getClass()
int	hashCode()
תוקף סופי	notify()
תוקף סופי	notifyAll()
מחרוזת	toString()
תוקף סופי	wait(long arg0, int arg1)
תוקף סופי	wait(long arg0)
תוקף סופי	wait()

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

Public void clearTileCache ()

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

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

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

פרמטרים

אחר	Object.

החזרות

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

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

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

החזרות

• true אם המשבצות הופכות לשקופות בהדרגה, false אם לא.

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

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

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

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

החזרות

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

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

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

החזרות

• את zIndex של שכבת-העל של המשבצות.

int ציבורי hashCode ()

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

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

החזרות

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

Public void הסרה ()

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

Public void setFadeIn (boolean fadeIn)

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

פרמטרים

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

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

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

פרמטרים

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

Public void setVisible (boolean visible)

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

פרמטרים

גלוי	true כדי להציג את שכבת-העל הזו, false כדי להסתיר אותה.

Public void setZIndex (float zIndex)

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

פרמטרים

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