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

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

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

שיעור סיום ציבורי GroundOverlayOptions מרחיב את אובייקט
implements ניתן לפינוי

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

סיכום קבוע

מספר ממשי (float) NO_DIMENSION סימון כשלא צוין מימד לגובה.

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

מהממשק android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

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

GroundOverlayOptions()

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

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

GroundOverlayOptions	עוגן(float u, float v) מציינת את העוגן.
GroundOverlayOptions	נושא(נושא צף) מציינת את כיוון שכבת-העל של הקרקע במעלות בכיוון השעון מצפון.
GroundOverlayOptions	clickable(בוליאני קליקבילי) מציין אם ניתן ללחוץ על שכבת-העל של הקרקע.
מספר ממשי (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) ציון התמונה עבור שכבת-העל הזו.
בוליאני	isClickable() הפונקציה מקבלת את הגדרת הקליקביליות של אובייקט `GroundOverlayOptions` הזה.
בוליאני	isVisible() הפונקציה מקבלת את הגדרת החשיפה של אובייקט `GroundOverlayOptions` הזה.
GroundOverlayOptions	position(מיקום LatLng, רוחב צף) מציינת את המיקום של שכבת-העל הזו באמצעות נקודת עוגן (`LatLng`) רוחב (במטרים).
GroundOverlayOptions	position(מיקום LatLng, רוחב מספר ממשי (float), גובה צף) מציינת את המיקום של שכבת-העל הזו באמצעות נקודת עוגן (`LatLng`), רוחב וגובה (שניהם במטרים).
GroundOverlayOptions	positionFromBounds(גבולות LatLngBounds) מציין את המיקום של שכבת-העל של הקרקע.
GroundOverlayOptions	transparency(שקיפות צפה) מציינת את השקיפות של שכבת-העל של הקרקע.
GroundOverlayOptions	visible(boolean visible) מציין את הרשאות הגישה לשכבת-העל של הקרקע.
GroundOverlayOptions	zIndex(float zIndex) מציין את ה-zIndex של שכבת-העל של הקרקע, כלומר הסדר שבו היא תילקח.

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

מהכיתה JavaScript.lang.Object

בוליאני	equals(אובייקט arg0)
סופי כיתה<?>	getClass()
int	hashCode()
סופי ריק	notify()
סופי ריק	notifyAll()
מחרוזת	toString()
סופי ריק	wait(long arg0, int arg1)
סופי ריק	wait(ארוך arg0)
סופי ריק	wait()

מהממשק android.os.Parcelable

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

קבועים

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

סימון כשלא צוין מימד לגובה.

ערך קבוע: 1.0-

בנייה ציבורית

ציבורי GroundOverlayOptions ()

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

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

ציבורי 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 הזה עם קבוצת עוגן חדשה.

ציבורי GroundOverlayOptions נושא (נושא צף)

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

חשוב לשים לב שקו הרוחב-גובה חל לפני הסיבוב.

פרמטרים

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

החזרות

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

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

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

פרמטרים

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

החזרות

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

ציבורי מספר ממשי (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)

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

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

החזרות

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

ציבורי BitmapDescriptor getImage ()

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

החזרות

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

ציבורי LatLng getLocation ()

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

החזרות

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

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

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

החזרות

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

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

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

החזרות

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

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

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

החזרות

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

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

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

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

פרמטרים

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

החזרות

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

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

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

החזרות

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

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

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

החזרות

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

ציבורי GroundOverlayOptions מיקום (LatLng מיקום, רוחב צף)

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

פרמטרים

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

החזרות

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

קליעות

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

ציבורי GroundOverlayOptions מיקום (LatLng מיקום, רוחב צף, גובה צף)

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

פרמטרים

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

החזרות

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

קליעות

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

ציבורי GroundOverlayOptions positionFromBounds (LatLngBounds)

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

פרמטרים

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

החזרות

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

קליעות

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

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

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

פרמטרים

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

החזרות

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

קליעות

IllegalArgumentException	אם השקיפות נמצאת מחוץ לטווח [0..1].

ציבורי GroundOverlayOptions גלוי (בוליאני גלוי)

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

פרמטרים

גלוי

החזרות

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

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

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

פרמטרים

zIndex

החזרות

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