סמל שמוצב בנקודה מסוימת על פני השטח של המפה. סמל של סמן מצויר אל מסך המכשיר ולא על פני המפה; כלומר, הוא לא בהכרח ישתנה בגלל סיבובי המפה, הטיה או שינוי מרחק התצוגה.
לסמן יש את המאפיינים הבאים:
- אלפא
- מגדירים את רמת האטימות של הסמן. ברירת המחדל היא 1.0.
- עוגן
- הנקודה בתמונה שתמוקם במיקום
LatLng
של הסמן. ברירת המחדל היא 50% מהחלק השמאלי של התמונה ובחלק התחתון של התמונה. - מיקום
- הערך
LatLng
עבור מיקום הסמן במפה. אפשר לשנות את הערך הזה בכתובת בכל שלב אם ברצונך להזיז את הסמן. - כותרת
- מחרוזת טקסט שמוצגת בחלון מידע כשהמשתמש מקיש על הסמן. אפשר לשנות את הערך הזה בכל שלב.
- קטע טקסט
- טקסט נוסף שמוצג מתחת לכותרת. אפשר לשנות את הערך הזה בכל שלב.
- סמל
- מפת סיביות שמוצגת עבור הסמן. אם הסמל לא מוגדר, סמל ברירת המחדל הוא
מוצגת. אפשר לציין צבע חלופי לסמל ברירת המחדל באמצעות
defaultMarker(float)
. - סטטוס הגרירה
- אם רוצים לאפשר למשתמש לגרור את הסמן, צריך להגדיר את המאפיין הזה ל-
true
. שלך יכול לשנות את הערך הזה בכל שלב. ערך ברירת המחדל הואfalse
. - חשיפה
- כברירת מחדל, הסמן גלוי. כדי להפוך את הסמן לבלתי נראה, יש להגדיר את המאפיין הזה כ-
false
אפשר לשנות את הערך הזה בכל שלב. - שטוח או לוח מודעות
- אם הסמן שטוח על המפה, הוא יישאר תקוע במפה בזמן שהמצלמה
מסתובבת ונוטה לשנות את גודלה, אבל הגודל שלהן עדיין יישאר באותו גודל כמו שינוי מרחק התצוגה של המצלמה, בניגוד ל-
GroundOverlay
. אם הסמן הוא לוח חוצות, הוא תמיד ייכתב מול המצלמה יסתובב ויסתובב עם המצלמה. ברירת המחדל היא שלט חוצות (false
) - סיבוב
- סיבוב הסמן במעלות בכיוון השעון סביב נקודת העוגן של הסמן. הציר של הסיבוב מאונך לסמן. סיבוב של 0 תואם לברירת המחדל מיקום הסמן. כשהסמן שטוח במפה, מיקום ברירת המחדל הוא צפון מיושר והסיבוב כך שהסמן תמיד יישאר שטוח על המפה. כאשר הסמן הוא לוח חוצות, מיקום ברירת המחדל הוא כלפי מעלה והסיבוב הוא כזה הסמן תמיד פונה למצלמה. ערך ברירת המחדל הוא 0.
- zIndex
- סדר השרטוט של הסמן. הסמנים משורטטים לפי הסדר של ה-zIndex סמן ה-zIndex הגבוה ביותר מצויר למעלה. על ידי הגדרת המאפיין zIndex לכל סמן, אתם יכולים לקבוע באיזה יעד הקשה יש סיכוי גבוה יותר למשתמש שלך. ערך ברירת המחדל הוא 0.
- תיוג
Object
המשויך לסמן. לדוגמה,Object
יכול להכיל נתונים לגבי מה שהסמן מייצג. הפעולה הזו קלה יותר מאשר אחסון נפרד שלMap<Marker, Object>
. דוגמה נוספת, אפשר לשייך מזההString
שתואם למזהה מתוך קבוצת נתונים. ערכת ה-SDK של מפות Google ל-Android לא יכולה לקרוא או כותב את המאפיין הזה.
צריך לקרוא לשיטות בכיתה הזו בשרשור של ממשק המשתמש של Android. אם לא, המערכת תשליך IllegalStateException
בזמן הריצה.
דוגמה
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
מדריך למפתחים
מידע נוסף זמין במאמר על מפתחי Markers מותאמת אישית.
סיכום כיתה בתוך כיתה
@interface | Marker.CollisionBehavior | מציין את אופן הטיפול בסמן כשהוא מעורב בהתנגשות עם בסיס או סמנים אחרים תוויות של המפה. |
סיכום השיטה הציבורית
בוליאני | |
מספר ממשי (float) |
getAlpha()
מקבל את האלפא של הסמן.
|
מחרוזת |
getId()
הפונקציה מקבלת את המזהה של הסמן הזה.
|
LatLng |
getPosition()
מחזירה את מיקום הסמן.
|
מספר ממשי (float) |
getRotation()
מקבל את הסיבוב של הסמן.
|
מחרוזת |
getSnippet()
מקבל את הקטע של הסמן.
|
אובייקט |
getTag()
מקבל את התג של הסמן.
|
מחרוזת |
getTitle()
מקבל את הכותרת של הסמן.
|
מספר ממשי (float) |
getZIndex()
מחזירה את zIndex של הסמן.
|
int |
hashCode()
|
ריק |
hideInfoWindow()
הסתרת חלון המידע אם הוא מוצג מהסמן הזה.
|
בוליאני |
isDraggable()
מקבל את יכולת הגרירה של הסמן.
|
בוליאני |
isFlat()
מקבל את ההגדרה השטוחה של עט הסימון.
|
בוליאני |
isInfoWindowShown()
הפונקציה מחזירה אם חלון המידע מוצג כרגע מעל הסמן הזה.
|
בוליאני |
isVisible()
מקבל את הגדרת החשיפה של הסמן הזה.
|
ריק |
remove()
הסרת הסמן הזה מהמפה.
|
ריק |
setAlpha(מספר ממשי (float))
מגדיר את רמת האלפא (אטימוּת) של הסמן.
|
ריק |
setAnchor(עוגן צף, עוגן צף V)
מגדיר את נקודת העיגון של הסמן.
|
ריק |
setDraggable(boolean draggable)
מגדיר את יכולת הגרירה של הסמן.
|
ריק |
setFlat(בוליאני שטוח)
הגדרה זו קובעת אם סמן זה צריך להיות שטוח על המפה
true או לוח חוצות הפונה אל
מצלמה false . |
ריק | |
ריק |
setInfoWindowAnchor(עוגן צף, עוגן צף V)
מציין את הנקודה בתמונת הסמן שבה צריך לעגן את חלון המידע כאשר הוא
מוצגת.
|
ריק | |
ריק |
setRotation(סיבוב מספר ממשי)
מגדיר את הסיבוב של הסמן במעלות בכיוון השעון סביב נקודת העיגון של הסמן.
|
ריק |
setSnippet(קטע קוד במחרוזת)
מגדיר את קטע הטקסט של הסמן.
|
ריק |
setTag(תג אובייקט)
מגדיר את התג של הסמן.
|
ריק |
setTitle(כותרת המחרוזת)
מגדיר את כותרת הסמן.
|
ריק |
setVisible(boolean visible)
מגדיר את החשיפה של הסמן.
|
ריק |
setZIndex(float zIndex)
מגדיר את zIndex של הסמן.
|
ריק |
showInfoWindow()
מציג את חלון המידע של הסמן הזה במפה, אם הסמן
isVisible() . |
סיכום השיטות שעברו בירושה
שיטות ציבוריות
ציבורי בוליאני שווה ל- (אובייקט אחר)
ציבורי מספר ממשי (float) getAlpha ()
מקבל את האלפא של הסמן.
החזרות
- האלפא של הסמן בטווח [0, 1].
ציבורי מחרוזת (String) getId ()
הפונקציה מקבלת את המזהה של הסמן הזה. המזהה יהיה ייחודי בין כל הסמנים במפה.
החזרות
- המזהה של סמן זה.
ציבורי LatLng getPosition ()
מחזירה את מיקום הסמן.
החזרות
- אובייקט
LatLng
שמציין את המיקום הנוכחי של הסמן.
ציבורי מספר ממשי (float) getRotation ()
מקבל את הסיבוב של הסמן.
החזרות
- סיבוב הסמן במעלות בכיוון השעון ממיקום ברירת המחדל.
ציבורי מחרוזת (String) getSnippet ()
מקבל את הקטע של הסמן.
החזרות
- מחרוזת שמכילה את קטע הטקסט של הסמן.
ציבורי אובייקט getTag ()
מקבל את התג של הסמן.
החזרות
- התג אם הוגדר בתג
setTag
null
אם לא הוגדר תג.
ציבורי מחרוזת (String) getTitle ()
מקבל את הכותרת של הסמן.
החזרות
- מחרוזת שמכילה את כותרת הסמן.
ציבורי מספר ממשי (float) getZIndex ()
מחזירה את zIndex של הסמן.
החזרות
- ה-zIndex של הסמן הזה.
ציבורי INT hashCode ()
ציבורי ריק hideInfoWindow ()
הסתרת חלון המידע אם הוא מוצג מהסמן הזה.
לשיטה הזו אין השפעה אם הסמן אינו גלוי.
ציבורי בוליאני isDraggable ()
מקבל את יכולת הגרירה של הסמן. כאשר סמן ניתן לגרירה, המשתמש יכול להזיז אותו על ידי לחיצה ארוכה על הסמן.
החזרות
true
אם ניתן לגרור את הסמן; אחרת, מחזירהfalse
.
ציבורי בוליאני isFlat ()
מקבל את ההגדרה השטוחה של עט הסימון.
החזרות
true
אם הסמן שטוח על המפה;false
אם הסמן לפנות למצלמה.
ציבורי בוליאני isInfoWindowShown ()
הפונקציה מחזירה אם חלון המידע מוצג כרגע מעל הסמן הזה. המודל הזה לא מתייחס אם חלון המידע מוצג בפועל על המסך.
ציבורי בוליאני isVisible ()
מקבל את הגדרת החשיפה של הסמן הזה. לתשומת ליבך, זה לא מציין אם הסמן נמצא באזור התצוגה של המסך. הוא מציין אם הסמן ייבחר אם הוא שבאזור התצוגה של המסך.
החזרות
- החשיפה של הסמן הזה.
ציבורי ריק הסרה ()
הסרת הסמן הזה מהמפה. לאחר הסרת סמן, ההתנהגות של כל שאר הסמן לא מוגדרים.
ציבורי ריק setAlpha (גרסת אלפא צפה)
מגדיר את רמת האלפא (אטימוּת) של הסמן. זהו ערך בין 0 ל-1, כאשר 0 פירושו הסמן שקופה לגמרי ו-1 מציין שהסמן אטום לחלוטין.
פרמטרים
alpha |
---|
ציבורי ריק setAnchor (עוגן צף, עוגן צף (float))
מגדיר את נקודת העיגון של הסמן.
העוגן מציין את הנקודה בתמונת הסמל שמעוגנת למיקום הסמן על פני כדור הארץ.
נקודת העיגון מצוינת במרחב הרציף [0.0, 1.0] x [0.0, 1.0], כאשר (0, 0) הוא הפינה השמאלית העליונה של התמונה, ו-(1, 1) הוא הפינה הימנית התחתונה. נקודת העיגון בתמונה מסוג W x H היא נקודת הרשת הנפרדת הקרובה ביותר בתוך x (W + 1) רשת (H + 1), שמתקבלת על ידי שינוי קנה המידה של הסרגל ולאחר מכן עיגול. לדוגמה, בתמונה בגודל 4x2, נקודת העיגון (0.7, 0.6) מובילה לנקודת הרשת (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
פרמטרים
anchorU | קואורדינטת u של העוגן, כיחס רוחב התמונה (בטווח [0, 1]). |
---|---|
anchorV | קואורדינטת V של העוגן, כיחס של גובה התמונה (בטווח [0, 1]). |
ציבורי ריק setDraggable (ניתן לגרירה בוליאני)
מגדיר את יכולת הגרירה של הסמן. כאשר סמן ניתן לגרירה, המשתמש יכול להזיז אותו על ידי לחיצה ארוכה על הסמן.
פרמטרים
ניתן לגרירה |
---|
ציבורי ריק setFlat (מישור בוליאני)
הגדרה זו קובעת אם סמן זה צריך להיות שטוח על המפה true
או לוח חוצות הפונה אל
מצלמה false
.
פרמטרים
שטוחה |
---|
ציבורי ריק setIcon (BitmapDescriptor iconDescriptor)
מגדיר את הסמל של הסמן.
פרמטרים
iconDescriptor | אם הערך הוא null, המערכת תשתמש בסמן ברירת המחדל. |
---|
ציבורי ריק setInfoWindowAnchor (עוגן צף, עוגן צף (float))
מציין את הנקודה בתמונת הסמן שבה צריך לעגן את חלון המידע כאשר הוא
מוצגת. הוא מצוין באותה מערכת קואורדינטות כמו העוגן. אתה יכול לראות עוד פרטים בכתובת setAnchor(float, float)
. ברירת המחדל היא החלק האמצעי העליון של התמונה.
פרמטרים
anchorU | קואורדינטת u של עוגן חלון המידע, כיחס של רוחב התמונה ( טווח [0, 1]). |
---|---|
anchorV | קואורדינטת V של עוגן חלון המידע, כיחס של גובה התמונה ( טווח [0, 1]). |
ציבורי ריק setRotation (סיבוב צף)
מגדיר את הסיבוב של הסמן במעלות בכיוון השעון סביב נקודת העיגון של הסמן. הציר של הסיבוב מאונך לסמן. סיבוב של 0 תואם למיקום ברירת המחדל של הסמן.
פרמטרים
סבב |
---|
ציבורי ריק setSnippet (קטע קוד במחרוזת)
מגדיר את קטע הטקסט של הסמן.
פרמטרים
תקציר | אם הערך הוא null, קטע הקוד יוסר. |
---|
ציבורי ריק setTag (תג אובייקט)
מגדיר את התג של הסמן.
אפשר להשתמש בנכס הזה כדי לשייך אל Object
שרירותי לסמן הזה. עבור
לדוגמה, Object
יכול להכיל נתונים על מה שהסמן מייצג. זה קל יותר
מאשר לאחסן Map<Marker, Object>
נפרד. דוגמה נוספת, ניתן לשייך
מזהה String
שתואם למזהה מתוך קבוצת נתונים. SDK של מפות Google ל-Android לא
קורא או כותב את המאפיין הזה. באחריותך להתקשר אל setTag(null)
כדי
את התג כשכבר אין בו צורך, כדי למנוע דליפות זיכרון באפליקציה.
פרמטרים
תג | אם הערך הוא null, התג יוסר. |
---|
ציבורי ריק setTitle (כותרת המחרוזת)
מגדיר את כותרת הסמן.
פרמטרים
title | אם הערך הוא null, הכותרת תימחק. |
---|
ציבורי ריק setVisible (בוליאני גלוי)
מגדיר את החשיפה של הסמן. אם המדיניות מוגדרת לערך false
וכרגע מוגדר חלון מידע
מוצג עבור הסמן הזה, חלון המידע יסתיר.
פרמטרים
גלוי |
---|
ציבורי ריק setZIndex (מספר ממשי (zIndex)
מגדיר את zIndex של הסמן.
פרמטרים
zIndex |
---|
ציבורי ריק showInfoWindow ()
מציג את חלון המידע של הסמן הזה במפה, אם הסמן isVisible()
.
קליעות
IllegalArgumentException | אם marker לא מופיע במפה הזו
|
---|