טוש

שיעור סיום ציבורי סמן מרחיב את אובייקט

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

לסמן יש את המאפיינים הבאים:

אלפא
מגדירים את רמת האטימות של הסמן. ברירת המחדל היא 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 מציין את אופן הטיפול בסמן כשהוא מעורב בהתנגשות עם בסיס או סמנים אחרים תוויות של המפה.

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

בוליאני
שווה ל-(אובייקט אחר)
הפונקציה בודקת אם Marker הזה שווה לערך אחר.
מספר ממשי (float)
getAlpha()
מקבל את האלפא של הסמן.
מחרוזת
getId()
הפונקציה מקבלת את המזהה של הסמן הזה.
LatLng
getPosition()
מחזירה את מיקום הסמן.
מספר ממשי (float)
getRotation()
מקבל את הסיבוב של הסמן.
מחרוזת
getSnippet()
מקבל את הקטע של הסמן.
אובייקט
getTag()
מקבל את התג של הסמן.
מחרוזת
getTitle()
מקבל את הכותרת של הסמן.
מספר ממשי (float)
getZIndex()
מחזירה את zIndex של הסמן.
int
ריק
hideInfoWindow()
הסתרת חלון המידע אם הוא מוצג מהסמן הזה.
בוליאני
isDraggable()
מקבל את יכולת הגרירה של הסמן.
בוליאני
isFlat()
מקבל את ההגדרה השטוחה של עט הסימון.
בוליאני
isInfoWindowShown()
הפונקציה מחזירה אם חלון המידע מוצג כרגע מעל הסמן הזה.
בוליאני
isVisible()
מקבל את הגדרת החשיפה של הסמן הזה.
ריק
remove()
הסרת הסמן הזה מהמפה.
ריק
setAlpha(מספר ממשי (float))
מגדיר את רמת האלפא (אטימוּת) של הסמן.
ריק
setAnchor(עוגן צף, עוגן צף V)
מגדיר את נקודת העיגון של הסמן.
ריק
setDraggable(boolean draggable)
מגדיר את יכולת הגרירה של הסמן.
ריק
setFlat(בוליאני שטוח)
הגדרה זו קובעת אם סמן זה צריך להיות שטוח על המפה true או לוח חוצות הפונה אל מצלמה false.
ריק
setIcon(BitmapDescriptor iconDescriptor)
מגדיר את הסמל של הסמן.
ריק
setInfoWindowAnchor(עוגן צף, עוגן צף V)
מציין את הנקודה בתמונת הסמן שבה צריך לעגן את חלון המידע כאשר הוא מוצגת.
ריק
setPosition(LatLng latlng)
מגדיר את מיקום הסמן.
ריק
setRotation(סיבוב מספר ממשי)
מגדיר את הסיבוב של הסמן במעלות בכיוון השעון סביב נקודת העיגון של הסמן.
ריק
setSnippet(קטע קוד במחרוזת)
מגדיר את קטע הטקסט של הסמן.
ריק
setTag(תג אובייקט)
מגדיר את התג של הסמן.
ריק
setTitle(כותרת המחרוזת)
מגדיר את כותרת הסמן.
ריק
setVisible(boolean visible)
מגדיר את החשיפה של הסמן.
ריק
setZIndex(float zIndex)
מגדיר את zIndex של הסמן.
ריק
showInfoWindow()
מציג את חלון המידע של הסמן הזה במפה, אם הסמן isVisible().

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

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

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

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

פרמטרים
אחר Object.
החזרות
  • true אם שני האובייקטים הם אותו אובייקט, כלומר הערך הזה הוא == other.

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

ציבורי ריק setPosition (LatLng latlng)

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

פרמטרים
latlng

ציבורי ריק 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 לא מופיע במפה הזו