Marker

שיעור סמן

כיתה google.maps.Marker

הכיתה הזו מרחיבה את MVCObject.

כדי לקבל גישה, צריך להתקשר ל-const {Marker} = await google.maps.importLibrary("marker"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

Marker
Marker([opts])
פרמטרים: 
  • optsMarkerOptions optional ארגומנטים אופציונליים עם שם
יצירת סמן עם האפשרויות שצוינו. אם צוינה מפה, הסמן יתווסף למפה בזמן היצירה. הערה: יש להגדיר את המיקום כך שהסמן יוצג.
getAnimation
getAnimation()
פרמטרים: ללא
ערך החזרה:  Animation|null|undefined
מורידים את האנימציה שפועלת כרגע.
getClickable
getClickable()
פרמטרים: ללא
ערך החזרה:  boolean אם הערך של הסמן ניתן ללחיצה.
קבלת הסטטוס שניתן ללחוץ עליו של Marker.
getCursor
getCursor()
פרמטרים: ללא
ערך החזרה:  string|null|undefined
הצגת סוג הסמן של העכבר כשמעבירים את העכבר מעליו.
getDraggable
getDraggable()
פרמטרים: ללא
ערך החזרה:  boolean True אם הסמן ניתן לגרירה.
קבלת הסטטוס הניתן לגרירה של Marker.
getIcon
getIcon()
פרמטרים: ללא
ערך החזרה:  string|Icon|Symbol|null|undefined
קבלת הסמל של Marker. MarkerOptions.icon.
getLabel
getLabel()
פרמטרים: ללא
ערך החזרה:  MarkerLabel|string|null|undefined
קבלת התווית של Marker. MarkerOptions.label.
getMap
getMap()
פרמטרים: ללא
ערך החזרה:  Map|StreetViewPanorama
אפשר לקבל את המפה או הפנורמה שבה מעבדים את Marker.
getOpacity
getOpacity()
פרמטרים: ללא
ערך החזרה:  number|null|undefined מספר בין 0.0 ל-1.0.
קבלת השקיפות של Marker.
getPosition
getPosition()
פרמטרים: ללא
ערך החזרה:  LatLng|null|undefined
קבלת המיקום של Marker.
getShape
getShape()
פרמטרים: ללא
ערך החזרה:  MarkerShape|null|undefined
קבלת הצורה של Marker המשמשת לאינטראקציה. פרטים נוספים זמינים בMarkerOptions.shape ובMarkerShape.
getTitle
getTitle()
פרמטרים: ללא
ערך החזרה:  string|null|undefined
מורידים את הכותרת של ההסבר הקצר Marker. MarkerOptions.title.
getVisible
getVisible()
פרמטרים: ללא
ערך החזרה:  boolean אם הערך גלוי.
הצגת החשיפה של Marker.
getZIndex
getZIndex()
פרמטרים: ללא
ערך החזרה:  number|null|undefined zאינדקס של הסמן.
קבלת אינדקס ה-z של Marker. MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
פרמטרים: 
  • animationAnimation optional האנימציה להפעלה.
ערך החזרה: אין
מפעילים אנימציה. האנימציה השוטפת תבוטל. האנימציות הנתמכות כרגע הן: Animation.BOUNCE, Animation.DROP. מעבר בתוך null יגרום לאנימציה כלשהי להפסיק.
setClickable
setClickable(flag)
פרמטרים: 
  • flagboolean אם true, ניתן ללחוץ על הסמן.
ערך החזרה: אין
המדיניות קובעת אם ניתן ללחוץ על Marker.
setCursor
setCursor([cursor])
פרמטרים: 
  • cursorstring optional סוג סמן העכבר.
ערך החזרה: אין
הגדרת סוג הסמן של העכבר שמוצג כשמעבירים את העכבר מעליו.
setDraggable
setDraggable(flag)
פרמטרים: 
  • flagboolean optional אם true, אפשר לגרור את הסמן.
ערך החזרה: אין
אפשר לקבוע אם ניתן לגרור את Marker.
setIcon
setIcon([icon])
פרמטרים: 
ערך החזרה: אין
הגדרת הסמל של Marker. MarkerOptions.icon.
setLabel
setLabel([label])
פרמטרים: 
  • labelstring|MarkerLabel optional התווית יכולה להיות מחרוזת של תווים או אובייקט MarkerLabel.
ערך החזרה: אין
הגדרת התווית של Marker. MarkerOptions.label.
setMap
setMap(map)
פרמטרים: 
ערך החזרה: אין
עיבוד של ה-Marker במפה או בפנורמה שצוינו. אם המפה מוגדרת לערך null, הסמן יוסר.
setOpacity
setOpacity([opacity])
פרמטרים: 
  • opacitynumber optional מספר בין 0.0, שקיפות ו-1.0, אטום.
ערך החזרה: אין
הגדרה של אטימות של Marker.
setOptions
setOptions(options)
פרמטרים: 
ערך החזרה: אין
הגדרת האפשרויות ל-Marker.
setPosition
setPosition([latlng])
פרמטרים: 
ערך החזרה: אין
הגדרת הבדיחה עבור Marker.
setShape
setShape([shape])
פרמטרים: 
ערך החזרה: אין
הגדרת הצורה של Marker המשמשת לאינטראקציה. פרטים נוספים זמינים בMarkerOptions.shape ובMarkerShape.
setTitle
setTitle([title])
פרמטרים: 
  • titlestring optional
ערך החזרה: אין
הגדרת הכותרת של ההסבר הקצר Marker. MarkerOptions.title.
setVisible
setVisible(visible)
פרמטרים: 
  • visibleboolean אם true, הסמן נראה
ערך החזרה: אין
המדיניות הזו קובעת אם Marker גלוי.
setZIndex
setZIndex([zIndex])
פרמטרים: 
  • zIndexnumber optional
ערך החזרה: אין
מגדירים את אינדקס ה-z של Marker. MarkerOptions.zIndex.
הועבר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
MAX_ZINDEX אינדקס ה-z המקסימלי המוגדר כברירת מחדל, שה-API יקצה לסמן. אפשר להגדיר אינדקס z גבוה יותר כדי להציב סמן בחזית.
animation_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס האנימציה Marker משתנה.
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כאשר לוחצים על הסמל Marker.
clickable_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר המאפיין Marker הניתן ללחיצה משתנה.
contextmenu
function(event)
ארגומנטים: 
האירוע הזה מופעל כאשר אירוע תפריט ההקשר DOM מופעל ב-Marker
cursor_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס הסמן Marker משתנה.
dblclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כאשר לוחצים לחיצה כפולה על הסמל Marker.
drag
function(event)
ארגומנטים: 
האירוע הזה מופעל שוב ושוב כשהמשתמש גורר את Marker.
dragend
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש מפסיק לגרור את Marker.
draggable_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר הנכס Marker הניתן לגרירה משתנה.
dragstart
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש מתחיל לגרור את Marker.
flat_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר הנכס השטוח Marker משתנה.
icon_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס הסמל Marker משתנה.
mousedown
function(event)
ארגומנטים: 
האירוע הזה מופעל כדי להפסיק את השימוש ב-Marker.
mouseout
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהעכבר עוזב את האזור של הסמל Marker.
mouseover
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהעכבר נכנס לאזור של הסמל Marker.
mouseup
function(event)
ארגומנטים: 
האירוע הזה מופעל כדי לקבל תמונת מצב ב-Marker.
position_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס המיקום של Marker משתנה.
shape_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס הצורה Marker משתנה.
title_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס שם הפריט Marker משתנה.
visible_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר הנכס הגלוי Marker משתנה.
zindex_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס zindex של Marker משתנה.
rightclick
function(event)
ארגומנטים: 
האירוע הזה מופעל בלחיצה ימנית על Marker.

הממשק של MarkerOptions

ממשק google.maps.MarkerOptions

אובייקט Markupאפשרויות המשמש להגדרת המאפיינים שניתן להגדיר בסמן.

anchorPoint optional
סוג:  Point optional
ההיסט מהמיקום של הסמן אל הקצה של InfoWindow שנפתח עם הסמן כעוגן.
animation optional
סוג:  Animation optional
ברירת מחדל: null
איזו אנימציה להפעיל כשמוסיפים סמן למפה.
clickable optional
סוג:  boolean optional
ברירת מחדל: true
אם true, הסמן מקבל אירועי עכבר ומגע.
BetacollisionBehavior optional
סוג:  string|CollisionBehavior optional
ברירת מחדל: null
הגדרת התנהגות התנגשות עבור סמנים במפות וקטוריות.
crossOnDrag optional
סוג:  boolean optional
ברירת מחדל: true
אם false, מתבצעת השבתה של צלב שמופיע מתחת לסמן כשגוררים.
cursor optional
סוג:  string optional
ברירת מחדל: pointer
סוג סמן העכבר שיוצג לאחר העברת העכבר מעליו.
draggable optional
סוג:  boolean optional
ברירת מחדל: false
אם true, אפשר לגרור את הסמן.
icon optional
סוג:  string|Icon|Symbol optional
סמל של החזית. אם צוינה מחרוזת, היא תיחשב כ-Icon עם המחרוזת כ-url.
label optional
סוג:  string|MarkerLabel optional
ברירת מחדל: null
הוספת תווית לסמן. תווית סמן היא אות או מספר שמופיעים בתוך סמן. התווית יכולה להיות מחרוזת או אובייקט MarkerLabel. אם לא סופק טקסט ו-MarkerOptions.title לא מסופק, טקסט נגישות (לדוגמה, לשימוש עם קוראי מסך) יתווסף לסמן עם הטקסט של התווית שצוינה. לתשומת ליבך, label משמש כרגע רק לטקסט נגישות עבור סמנים לא אופטימליים.
map optional
סוג:  Map|StreetViewPanorama optional
מפה שבה יוצג הסמן. המפה נדרשת כדי להציג את הסמן וניתן לספק אותו עם Marker.setMap אם לא סופק בבניית הסמן.
opacity optional
סוג:  number optional
ברירת מחדל: 1.0
מספר בין 0.0, שקיפות ו-1.0, אטום.
optimized optional
סוג:  boolean optional
אופטימיזציה משפרת את הביצועים על ידי הצגת סמנים רבים כרכיב סטטי יחיד. האפשרות הזו שימושית במקרים שבהם יש צורך במספר גדול של סמנים. מידע נוסף על אופטימיזציה של סמן.
position optional
סוג:  LatLng|LatLngLiteral optional
הגדרת מיקום הסמן. סמן יכול להיבנות אך לא יוצג עד למיקום שלו - לדוגמה, לפי פעולות או אפשרויות שהמשתמש בחר. ניתן לספק מיקום סמן באמצעות Marker.setPosition אם הוא לא סופק בבניית הסמן.
shape optional
סוג:  MarkerShape optional
הגדרת האזור במפה במפה משמשת לגרירה/לחיצה.
title optional
סוג:  string optional
ברירת מחדל: undefined
גלילת טקסט. אם סופק, טקסט נגישות (לדוגמה, לשימוש בקוראי מסך) יתווסף לסמן המיועד לערך שצוין. לתשומת ליבך, title משמש כרגע רק לטקסט נגישות עבור סמנים לא אופטימליים.
visible optional
סוג:  boolean optional
ברירת מחדל: true
אם true, הסמן יופיע.
zIndex optional
סוג:  number optional
כל הסמנים מוצגים במפה לפי סדר האינדקס שלהם, כאשר ערכים גבוהים יותר מוצגים לפני הסמנים עם הערכים הנמוכים יותר. כברירת מחדל, הסמנים מוצגים בהתאם למיקום האנכי שלהם במסך, וכשסמנים נמוכים יותר מופיעים לפני הסמנים בחלק העליון של המסך.

קבועים של CollisionBehavior

google.maps.CollisionBehavior קבועים

כדי לקבל גישה, צריך להתקשר ל-const {CollisionBehavior} = await google.maps.importLibrary("marker"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

OPTIONAL_AND_HIDES_LOWER_PRIORITY יש להציג את הסמן רק אם הוא לא חופף לסמנים אחרים. אם שני סמנים מהסוג הזה חופפים, יוצג סימן זה עם אינדקס האינדקס הגבוה יותר. אם יש להם אותו אינדקס z, מופיע המסך עם המיקום האנכי הנמוך יותר.
REQUIRED תמיד להציג את הסמן ללא קשר להתנגשות. זאת התנהגות ברירת המחדל.
REQUIRED_AND_HIDES_OPTIONAL תמיד להציג את הסמן ללא התנגשות, ולהסתיר סמנים OPTIONAL_AND_HIDES_LOWER_PRIORITY או תוויות החופפות לסמן.

ממשק Icon

ממשק google.maps.Icon

מבנה שמייצג תמונה של סמל של סמן.

url
סוג:  string
כתובת ה-URL של התמונה או הגיליון.
anchor optional
סוג:  Point optional
המיקום שבו יש להצמיד תמונה בהתאם למיקום הסמן במפה. כברירת מחדל, העוגן ממוקם לאורך נקודת האמצע בתחתית התמונה.
labelOrigin optional
סוג:  Point optional
מקור התווית באופן יחסי לפינה הימנית העליונה של תמונת הסמל, אם התווית מסופקת על ידי הסמן. כברירת מחדל, המקור נמצא במרכז של התמונה.
origin optional
סוג:  Point optional
המיקום של התמונה בתוך ה-Sprite, אם יש כזה. כברירת מחדל, המקור נמצא בפינה הימנית העליונה של התמונה (0, 0).
scaledSize optional
סוג:  Size optional
גודל התמונה כולה לאחר שינוי קנה המידה, אם יש כזה. באמצעות הנכס הזה ניתן לכווץ/לכווץ תמונה או Sprit.
size optional
סוג:  Size optional
גודל התצוגה של ה-Sprite או התמונה. כשמשתמשים ב-Sprits, חובה לציין את גודל ה-Sprite. אם לא תספקו את הגודל, הוא יוגדר כשהתמונה תיטען.

הממשק של MarkerLabel

ממשק google.maps.MarkerLabel

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

text
סוג:  string
הטקסט שיוצג בתווית.
className optional
סוג:  string optional
ברירת מחדל: '' (מחרוזת ריקה)
מאפיין className של רכיב התווית (שווה ערך למאפיין המחלקה של הרכיב). אפשר להוסיף כמה קורסים של CSS שמופרדים ברווחים. אפשר להגדיר את הצבע, הגודל, המשקל והמשפחה של הגופן רק במאפיינים אחרים של MarkerLabel. אסור להשתמש בשיעורי CSS כדי לשנות את המיקום או את הכיוון של התווית (למשל, שימוש בתרגומים ובסיבובים) אם משתמשים גם בניהול של תאונות דרכים.
color optional
סוג:  string optional
ברירת מחדל: 'black'
צבע הטקסט של התווית.
fontFamily optional
סוג:  string optional
משפחת הגופנים של טקסט התווית (שווה ערך לנכס הגופן המשפחתי של CSS).
fontSize optional
סוג:  string optional
ברירת מחדל: '14px'
גודל הגופן של טקסט התווית (זהה לנכס הגודל של גופן CSS).
fontWeight optional
סוג:  string optional
משקל הגופן של טקסט התווית (זהה לנכס המשקל ב-CSS).

הממשק של Marker הצורה

ממשק google.maps.MarkerShape

אובייקט זה מגדיר את האזור הלחיצים של תמונת סמן. הצורה מורכבת משני מאפיינים – type ו-coord — שמגדירים את האזור הלא שקוף של התמונה.

coords
סוג:  Array<number>
הפורמט של המאפיין הזה תלוי בערך של type, והוא תואם למפרט w3 AREA coords שמופיע בכתובת http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
המאפיין coords הוא מערך של מספרים שלמים שמציינים את מיקום הפיקסלים בצורה בצורה ביחס לפינה הימנית העליונה של תמונת היעד. הקואורדינטות תלויות בערך של type באופן הבא:
- circle: הקואורדינטות הן [x1,y1,r] כאשר x1,y2 הוא הקואורדינטות של מרכז המעגל, ו-r הוא הרדיוס של העיגול.
- poly: הקואורדינטות הן [x1,y1,x2,y2...xn,yn] כאשר כל צמד של x,y מכיל את הקואורדינטות של קודקוד אחד של הפוליגון.
- rect: הקואורדינטות הן [x1,y1,x2,y2] כאשר x1,y1 הוא הקואורדינטות של הפינה השמאלית העליונה של המלבן, ו-x2,y2 הן הקואורדינטות של הקואורדינטות שבפינה הימנית התחתונה של המלבן.
type
סוג:  string
מתאר את סוג הצורה ויכול להיות circle, poly או rect.

ממשק הסמל

ממשק google.maps.Symbol

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

path
סוג:  SymbolPath|string
נתיב הסמל, שהוא נתיב סמלים מובנה, או נתיב מותאם אישית שמופיע בסימון של נתיב SVG. חובה.
anchor optional
סוג:  Point optional
ברירת מחדל: google.maps.Point(0,0)
מיקום הסמל באופן יחסי לסמן או למצולע. הקואורדינטות של נתיב הסמל מתורגמות שמאלה ולמעלה על ידי הקואורדינטות x ו-y של העוגן בהתאמה. המיקום מיוצג באותה מערכת קואורדינטות כמו נתיב הסמל.
fillColor optional
סוג:  string optional
צבע המילוי של הסמל. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים. עבור סימני סמלים, ברירת המחדל היא 'שחור'. עבור סמלים של קווים מרובים, ברירת המחדל היא צבע הקווים של המצולע המתאים.
fillOpacity optional
סוג:  number optional
ברירת מחדל: 0
שקיפות המילוי של הסמל.
labelOrigin optional
סוג:  Point optional
ברירת מחדל: google.maps.Point(0,0)
מקור התווית ביחס למקור של הנתיב, אם התווית מסופקת על ידי הסמן. המקור מתבטא באותה מערכת קואורדינטות כמו נתיב הסמל. הנכס הזה לא בשימוש לסימון סמלים בקווים מרובים.
rotation optional
סוג:  number optional
ברירת מחדל: 0
הזווית שבאמצעותה ניתן לסובב את הסמל, מבוטאת בכיוון השעון במעלות. הסמל ב-IconSequence שבו הערך fixedRotation הוא false מסתובב בין זווית הקצה שבו הוא נמצא.
scale optional
סוג:  number optional
סכום הגודל של הסמל. עבור סימני סמלים, ברירת המחדל היא 1. לאחר התאמת קנה המידה, הסמל יכול להיות בכל גודל. עבור סמלים של Polyline, ברירת המחדל היא משקל המשיכת של ה-Polyline; לאחר התאמת קנה המידה, הסמל חייב להיות בתוך ריבוע בגודל 22 פיקסלים, במרכז של העוגן של הסמל.
strokeColor optional
סוג:  string optional
צבע הקווים של הסמל. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים. עבור סימני סמלים, ברירת המחדל היא 'שחור'. עבור סמלים של Polyline, ברירת המחדל היא צבע הקווים של המצולע.
strokeOpacity optional
סוג:  number optional
שקיפות האות של הסמל. בסמני סמלים, ברירת המחדל היא 1. עבור סמלים של polyline, ברירת המחדל היא שקיפות הקווים של ה-polyline.
strokeWeight optional
סוג:  number optional
ברירת מחדל: Symbol.scale של הסמל.
משקל הסימן של הסמל.

קבועים של ICONPath

google.maps.SymbolPath קבועים

נתיבי סמלים מובנים.

כדי לקבל גישה, צריך להתקשר ל-const {SymbolPath} = await google.maps.importLibrary("core"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

BACKWARD_CLOSED_ARROW חץ סגור שמצביע לאחור.
BACKWARD_OPEN_ARROW חץ פתוח הפונה אחורה.
CIRCLE עיגול.
FORWARD_CLOSED_ARROW חץ סגור שמצביע קדימה.
FORWARD_OPEN_ARROW חץ פתוח שמצביע קדימה.

קבועיםאנימציה

google.maps.Animation קבועים

אנימציות שניתן להפעיל על סמן. יש להשתמש בשיטה Marker.setAnimation בסמן או באפשרות MarkerOptions.animation כדי להפעיל אנימציה.

כדי לקבל גישה, צריך להתקשר ל-const {Animation} = await google.maps.importLibrary("marker"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

BOUNCE הסמן יקפוץ עד שהאנימציה תיפסק. כדי לעשות זאת, צריך להתקשר אל Marker.setAnimation באמצעות null.
DROP הסמן נופל מהחלק העליון של המפה אל המיקום הסופי שלה. האנימציה תיפסק ברגע שהסמן יחזור למצב מנוחה, ו-Marker.getAnimation יחזיר null. הנפשה מסוג זה מופיעה בדרך כלל במהלך יצירת הסמן.