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

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

אפשרויות סימון

מחלקה סופית ציבורית ציבורית MarkerOptions מרחיבה אובייקט
הטמעה ניתנת להרחבה

מגדיר את אפשרויות הסימון עבור סמן.

מדריך למפתחים

מידע נוסף זמין במדריך למפתחים של Markers.

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

מהממשק android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

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

MarkerOptions()

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

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

MarkerOptions	alpha(אלפא של מספר ממשי (float)) מגדיר את האלפא (האטימות) של הסמן.
MarkerOptions	עוגן(float u, float v) מציינת את העוגן להופיע בנקודה מסוימת בתמונת הסמן.
MarkerOptions	collisionBehavior(int collisionBehavior) מגדיר את מצב ההתנגשות עבור הסמן.
MarkerOptions	draggable(ניתן לגרירה בוליאנית) מגדיר את יכולת הגרירה של הסמן.
MarkerOptions	flat(בוליאני שטוח) הגדרה זו קובעת אם הסמן הזה יחובר למפה `true` או ללוח מודעות שפונה למצלמה `false`.
float	getAlpha() הפונקציה מקבלת את קבוצת האלפא של האובייקט `MarkerOptions`.
float	getAnchorU() מרחק אופקי, מנורמל ל-[0, 1] של העוגן מהקצה השמאלי.
float	getAnchorV() מרחק אנכי, מנורמל ל-[0, 1] של העוגן מהקצה העליון.
int	getCollisionBehavior)
BitmapDescriptor	getIcon() הפונקציה מקבלת את מתאר הסמל המותאם אישית מוגדר לאובייקט `MarkerOptions` הזה.
float	getInfoWindowAnchorU() מרחק אופקי, מנורמל ל-[0, 1] של עוגן חלון המידע מהקצה השמאלי.
float	getInfoWindowAnchorV() מרחק אנכי, מנורמל ל-[0, 1] של עוגן חלון המידע מהקצה העליון.
LatLng	getPosition() מחזירה את המיקום שנקבע עבור אובייקט `MarkerOptions` זה.
float	getRotation() הפונקציה מקבלת את הגדרת הסיבוב של האובייקט `MarkerOptions`.
מחרוזת	getSnippet() הפונקציה מקבלת את קטע הקוד שהוגדר לאובייקט `MarkerOptions` הזה.
מחרוזת	getTitle() הפונקציה מקבלת את הכותרת שהוגדרה לאובייקט `MarkerOptions` הזה.
float	getZIndex() הפונקציה מקבלת את הערך zIndex עבור אובייקט `MarkerOptions` זה.
MarkerOptions	icon(BitmapDescriptor iconDescriptor) הגדרת הסמל של הסמן.
MarkerOptions	infoWindowAnchor(floating u, float v) מציין את נקודת העוגן של חלון המידע בתמונת הסמן.
boolean	isDraggable() הפונקציה מקבלת את ההגדרה של יכולת הגרירה של האובייקט `MarkerOptions`.
boolean	isFlat() הפונקציה מקבלת את ההגדרה שטוחה לאובייקט `MarkerOptions` הזה.
boolean	isVisible() הפונקציה מקבלת את הגדרת החשיפה של האובייקט `MarkerOptions` הזה.
MarkerOptions	position(LatLng latlng) מגדיר את מיקום הסמן.
MarkerOptions	rotation(סיבוב מספר ממשי (float)) מגדיר את סיבוב הסמן במעלות בכיוון השעון סביב נקודת העוגן של הסמן.
MarkerOptions	snippet(קטע קוד של מחרוזת) מגדיר את קטע הקוד עבור הסמן.
MarkerOptions	title(שם המחרוזת) מגדיר את הכותרת של הסמן.
MarkerOptions	visible(גלוי בוליאני) הגדרת החשיפה של הסמן.
MarkerOptions	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)

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

ציבורי MarkerOptions ()

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

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

ציבורי MarkerOptions אלפא (float alpha)

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

פרמטרים

alpha

החזרות

האובייקט שעבורו נקראה השיטה, עם קבוצת האלפא החדשה.

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

מציינת את העוגן להופיע בנקודה מסוימת בתמונת הסמן.

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

נקודת העיגון מצוינת בשטח הרציף [0.0, 1.0] x [0.0, 1.0], כאשר (0, 0) היא הפינה השמאלית העליונה של התמונה ו-(1, 1) היא הפינה הימנית התחתונה. נקודת העיגון בתמונה של W x H היא נקודת הרשת הנפרדת הקרובה ביותר ברשת של (W + 1) x (H + 1), שמתקבלת על ידי שינוי גודל העיגול ואז. לדוגמה, בתמונה בגודל 4 x 2, נקודת העיגון (0.7, 0.6) הופכת לנקודת הרשת (3, 1).

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

פרמטרים

u	קואורדינטת U של העוגן, כיחס של רוחב התמונה (בטווח [0, 1])
v	קואורדינטת ה-v של העוגן, ביחס לגובה התמונה (בטווח [0, 1])

החזרות

האובייקט שעבורו נקראה השיטה, עם קבוצת העוגן החדשה.

באופן ציבורי MarkerOptions collisionBehavior (int collisionBehavior)

מגדיר את מצב ההתנגשות עבור הסמן. הערך הזה הוא Marker.CollisionBehavior. אפשר להגדיר אותה רק פעם אחת.

פרמטרים

collisionBehavior

החזרות

האובייקט שעבורו נקראה השיטה, עם מוגדר מצב ההתנגשות.

Public MarkerOptions ניתן לגרירה (boolean draggable)

מגדיר את יכולת הגרירה של הסמן.

פרמטרים

ניתן לגרירה

החזרות

האובייקט שעבורו נקראה השיטה, עם הוגדר מצב חדש לגרירה.

Public MarkerOptions שטוחה (דירה בוליאנית)

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

פרמטרים

שטוחה

החזרות

האובייקט שעבורו נקראה השיטה, עם המצב השטוח החדש מוגדר.

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

הפונקציה מקבלת את קבוצת האלפא של האובייקט MarkerOptions.

החזרות

האלפא של הסמן בטווח [0, 1].

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

מרחק אופקי, מנורמל ל-[0, 1] של העוגן מהקצה השמאלי.

החזרות

ערך ה-u של העוגן.

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

מרחק אנכי, מנורמל ל-[0, 1] של העוגן מהקצה העליון.

החזרות

ערך ה-v של העוגן.

int ציבורי getCollisionBehavior ()

Public BitmapDescriptor getIcon ()

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

החזרות

BitmapDescriptor שמייצג את הסמל המותאם אישית, או null אם לא הוגדר סמל מותאם אישית.

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

מרחק אופקי, מנורמל ל-[0, 1] של עוגן חלון המידע מהקצה השמאלי.

החזרות

ערך ה-u של העוגן של חלון המידע.

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

מרחק אנכי, מנורמל ל-[0, 1] של עוגן חלון המידע מהקצה העליון.

החזרות

ערך ה-v של העוגן של חלון המידע.

ציבורי LatLng getPosition ()

מחזירה את המיקום שנקבע עבור אובייקט MarkerOptions זה.

החזרות

אובייקט LatLng שמציין את המיקום הנוכחי של הסמן.

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

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

החזרות

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

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

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

החזרות

מחרוזת שמכילה את קטע הטקסט של הסמן.

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

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

החזרות

מחרוזת שמכילה את כותרת הסמן.

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

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

החזרות

את zIndex של הסמן.

ציבורי MarkerOptions סמל (BitmapDescriptor iconDescriptor)

הגדרת הסמל של הסמן.

פרמטרים

iconDescriptor	אם `null`, נעשה שימוש בסמן ברירת המחדל.

החזרות

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

באופן ציבורי MarkerOptions infoWindowAnchor (float u, float v)

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

פרמטרים

u	קואורדינטת U של העוגן של חלון המידע, ביחס לרוחב התמונה (בטווח [0, 1])
v	קואורדינטת V של העוגן של חלון המידע, ביחס לגובה התמונה (בטווח [0, 1])

החזרות

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

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

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

החזרות

true אם הסמן ניתן לגרירה. אחרת, הפונקציה מחזירה את הערך false.

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

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

החזרות

true אם הסמן שטוח על המפה. false אם הסמן צריך לפנות למצלמה.

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

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

החזרות

true אם הסמן גלוי; אחרת, מחזירה false.

ציבורי MarkerOptions position (LatLng latlng)

מגדיר את מיקום הסמן.

פרמטרים

latlng

החזרות

האובייקט שעבורו נקראה השיטה, עם מיקום חדש מוגדר.

באופן ציבורי MarkerOptions רוטציה (סבב הצף)

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

פרמטרים

סבב

החזרות

האובייקט שעבורו נקראה השיטה, עם הגדרת הסיבוב החדשה.

ציבורי MarkerOptions קטע טקסט (קטע קוד של מחרוזת)

מגדיר את קטע הקוד עבור הסמן.

פרמטרים

תקציר

החזרות

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

Public MarkerOptions title (כותרת המחרוזת)

מגדיר את הכותרת של הסמן.

פרמטרים

שם פריט

החזרות

האובייקט שעבורו נקראה השיטה, עם הכותרת החדשה.

ציבורי MarkerOptions גלוי (boolean visible)

הגדרת החשיפה של הסמן.

פרמטרים

גלוי

החזרות

האובייקט שעבורו נקראה השיטה, עם מצב החשיפה החדש מוגדר.

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

מגדיר את zIndex עבור הסמן.

פרמטרים

zIndex

החזרות

האובייקט שעבורו נקראה השיטה, עם הערך החדש zIndex.