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

דף זה תורגם על ידי Cloud Translation API.

אפשרויות קרקע

מחלקה סופית ציבורית ציבורית GroundOverlayOptions מרחיבה את Object
הטמעה Parcelable

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

סיכום קבוע

float NO_DIMENSION סימון למקרים שבהם לא צוינה מימד עבור הגובה.

סיכום של ערכים קבועים בירושה

מהממשק android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

סיכום של הבנייה הציבורית

GroundOverlayOptions()

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

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

GroundOverlayOptions	עוגן(float u, float v) מציין את העוגן.
GroundOverlayOptions	נושא(נושאת ציפה) מראה את נשיאת שכבת-העל של הקרקע במעלות בכיוון השעון מצפון.
GroundOverlayOptions	ניתנת ללחיצה(ערך בוליאני לחיץ) מציינת אם ניתן ללחוץ על שכבת העל של הקרקע.
float	getAnchorU() עוגן יחסי אופקי; `0.0` ו-`1.0` מציינים קצוות שמאליים וימניים בהתאמה.
float	getAnchorV() עוגן יחסי אנכי; `0.0` ו-`1.0` מציינים את הקצוות העליונים והתחתונים, בהתאמה.
float	getBearing() הפונקציה מקבלת את הגדרת הנושא של אובייקט `GroundOverlayOptions` זה.
LatLngBounds	getBounds() הפונקציה מקבלת את הגבולות שהוגדרו לאובייקט `GroundOverlayOptions` הזה.
float	getHeight() הפונקציה מקבלת את הגובה שהוגדר לאובייקט `GroundOverlayOptions` הזה.
BitmapDescriptor	getImage() הפונקציה מקבלת את המערכת של מתאר התמונה לאובייקט `GroundOverlayOptions` הזה.
LatLng	getLocation() הפונקציה מקבלת את המיקום שהוגדר לאובייקט `GroundOverlayOptions` הזה.
float	getTransparency() הפונקציה מקבלת את הגדרת השקיפות שהוגדרה לאובייקט `GroundOverlayOptions` הזה.
float	getWidth() הפונקציה מקבלת את הרוחב שהוגדר לאובייקט `GroundOverlayOptions` הזה.
float	getZIndex() הפונקציה מקבלת את הערך zIndex עבור אובייקט `GroundOverlayOptions` זה.
GroundOverlayOptions	image(BitmapDescriptor imageDescriptor) מציין את התמונה עבור שכבת העל הזו.
boolean	isClickable() הפונקציה מקבלת את הגדרת הקליקביליות של האובייקט `GroundOverlayOptions`.
boolean	isVisible() הפונקציה מקבלת את הגדרת החשיפה של האובייקט `GroundOverlayOptions` הזה.
GroundOverlayOptions	position(מיקום LatLng, רוחב צף) מציינת את המיקום של שכבת-העל הזו על הקרקע באמצעות נקודת עוגן (`LatLng`) ואת הרוחב (במטרים).
GroundOverlayOptions	position(מיקום LatLng, רוחב צף, גובה צף) המדיניות מציינת את המיקום של שכבת-העל הזו על הקרקע באמצעות נקודת עיגון (`LatLng`), רוחב וגובה (במטרים).
GroundOverlayOptions	positionFromBounds(LatLngBounds bounds) מציין את המיקום של שכבת-העל הזו.
GroundOverlayOptions	transparency(שקיפות צפה) מציין את השקיפות של שכבת-העל של הקרקע.
GroundOverlayOptions	visible(גלוי בוליאני) מציין את הנראות של שכבת-העל של הקרקע.
GroundOverlayOptions	zIndex(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()

מהממשק android.os.Parcelable

INT מופשטים	describeContents()
מופשט וריק	writeToParcel(Parcel arg0, int arg1)

קבועים

ערך סטטיסטי ציבורי סטטי סופי NO_DIMENSION

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

ערך קבוע: -1.0

בניינים ציבוריים

ציבורי GroundOverlayOptions ()

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

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

Public GroundOverlayOptions עוגן (float u, float v)

מציין את העוגן.

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

נקודת העיגון מצוינת במרחב רציף דו-ממדי שבו (0,0), (1,0), (0,1) ו-(1,1) מציינים את הפינות השמאלית העליונה, הימנית העליונה, השמאלית התחתונה והפינה הימנית התחתונה, בהתאמה.

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*

פרמטרים

u	קואורדינטת ה-U של העוגן
v	קואורדינטת ה-v של העוגן

החזרות

אובייקט GroundOverlayOptions הזה עם קבוצת עוגן חדשה.

Public GroundOverlayOptions נושאת (נושאת ציפה)

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

חשוב לזכור שקו האורך של קו רוחב חל לפני הסיבוב.

פרמטרים

נשיאה	את הכיוון במעלות בכיוון השעון מצפון. הערכים שמחוץ לטווח של [0, 360) יעברו נירמול.

החזרות

את האובייקט GroundOverlayOptions עם קבוצת נושאים חדשה.

ציבורי GroundOverlayOptions ניתנת ללחיצה (לחיצה בוליאנית)

מציינת אם ניתן ללחוץ על שכבת העל של הקרקע. הקליקביליות שמוגדרת כברירת מחדל היא false.

פרמטרים

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

החזרות

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

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

עוגן יחסי אופקי; 0.0 ו-1.0 מציינים קצוות שמאליים וימניים בהתאמה. ערכי עוגן אחרים עוברים אינטרפולציה בהתאם.

החזרות

מיקום העוגן היחסי לקצה האופקי.

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

עוגן יחסי אנכי; 0.0 ו-1.0 מציינים את הקצוות העליונים והתחתונים, בהתאמה. ערכי עוגן אחרים עוברים אינטרפולציה בהתאם.

החזרות

את מיקום העוגן ביחס לקצה האנכי.

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

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

החזרות

ההשפעה של שכבת העל.

ציבורי LatLngBounds getBounds ()

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

החזרות

את הגבולות של שכבת העל של הקרקע. הערך יהיה null אם המיקום הוגדר באמצעות position(LatLng, float) או position(LatLng, float, float)

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

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

החזרות

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

Public BitmapDescriptor getImage ()

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

החזרות

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

ציבורי LatLng getLocation ()

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

החזרות

המיקום כדי למקם את העוגן של שכבת-העל לקרקע. הערך יהיה null אם המיקום הוגדר באמצעות positionFromBounds(LatLngBounds).

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

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

החזרות

השקיפות של שכבת העל.

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

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

החזרות

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

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

הפונקציה מקבלת את הערך zIndex עבור אובייקט GroundOverlayOptions זה.

החזרות

את zIndex של שכבת העל של הקרקע.

ציבורי GroundOverlayOptions תמונה (BitmapDescriptor imageDescriptor)

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

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

פרמטרים

imageDescriptor	`BitmapDescriptor` שישמש לשכבת-העל של הקרקע הזו

החזרות

את האובייקט GroundOverlayOptions הזה עם קבוצת תמונה חדשה.

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

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

החזרות

true אם ניתן ללחוץ על שכבת-העל של הקרקע, false אם לא ניתן ללחוץ עליה.

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

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

החזרות

true אם שכבת-העל הזו גלויה. אם היא לא גלויה, false.

ציבורי GroundOverlayOptions position (LatLng, רוחב הצף)

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

פרמטרים

מיקום	המיקום במפה `LatLng` שאליו תישאר נקודת העוגן בתמונה הנתונה. העוגן יישאר מקובע למיקום על הקרקע כאשר מוחלות טרנספורמציות (למשל, setDimensions, setBearing וכו').
רוחב	רוחב שכבת-העל (במטרים). הגובה ייקבע באופן אוטומטי על סמך יחס הגובה-רוחב של התמונה.

החזרות

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

קליעות

IllegalArgumentException	אם העוגן הוא `null`
IllegalArgumentException	אם הרוחב שלילי
IllegalStateException	אם המיקום כבר הוגדר באמצעות `positionFromBounds(LatLngBounds)`

Public GroundOverlayOptions position (LatLng, רוחב הצף, גובה הציפה)

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

פרמטרים

מיקום	המיקום במפה `LatLng` שאליו תישאר נקודת העוגן בתמונה הנתונה. העוגן יישאר מקובע למיקום על הקרקע כאשר מוחלות טרנספורמציות (למשל, setDimensions, setBearing וכו').
רוחב	רוחב שכבת-העל (במטרים)
גובה	גובה שכבת-העל (במטרים)

החזרות

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

קליעות

IllegalArgumentException	אם העוגן הוא `null`
IllegalArgumentException	אם הרוחב או הגובה שליליים
IllegalStateException	אם המיקום כבר הוגדר באמצעות `positionFromBounds(LatLngBounds)`

Public GroundOverlayOptions positionFromBounds (LatLngBounds bounds)

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

פרמטרים

גבולות	`LatLngBounds` שבו תציב את שכבת-העל של הקרקע

החזרות

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

קליעות

IllegalStateException	אם המיקום כבר הוגדר באמצעות `position(LatLng, float)` או `position(LatLng, float, float)`

Public GroundOverlayOptions שקיפות (שקיפות צפה)

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

פרמטרים

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

החזרות

אובייקט GroundOverlayOptions הזה עם הגדרת שקיפות חדשה.

קליעות

IllegalArgumentException	ערך השקיפות מחוץ לטווח [0..1].

Public GroundOverlayOptions גלוי (boolean visible)

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

פרמטרים

גלוי

החזרות

אובייקט GroundOverlayOptions הזה עם הגדרת חשיפה חדשה.

ציבורי GroundOverlayOptions zIndex (float zIndex)

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

פרמטרים

zIndex

החזרות

אובייקט GroundOverlayOptions זה עם קבוצת zIndex חדשה.