Marker (legacy)

הכיתה Marker

google.maps.Marker class

הכיתה הזו היא תת-מחלקה של MVCObject.

אפשר לגשת אליו באמצעות חיוג למספר const {Marker} = await google.maps.importLibrary("marker"). ספריות ב-Maps JavaScript API

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

הממשק MarkerOptions

ממשק google.maps.MarkerOptions

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

anchorPoint optional
סוג:  Point optional
ההיסט ממיקום הסמן לקצה של חלון מידע שנפתח עם הסמן כעוגן.
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, אפשר לגרור את הסמן. הערה: אם תגדירו את הערך הזה כ-true, תוכלו ללחוץ על הסמן גם אם הערך של clickable מוגדר כ-false.
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
כל הסמנים מוצגים במפה לפי הערך שלהם ב-zIndex, כאשר סמנים עם ערך גבוה יותר מוצגים לפני סמנים עם ערך נמוך יותר. כברירת מחדל, הסמנים מוצגים לפי המיקום האנכי שלהם במסך, כאשר סמנים נמוכים יותר מופיעים לפני סמנים שנמצאים גבוה יותר במסך.

קבועים של CollisionBehavior

google.maps.CollisionBehavior קבועים

אפשר לגשת אליו באמצעות חיוג למספר const {CollisionBehavior} = await google.maps.importLibrary("marker"). ספריות ב-Maps JavaScript API

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

ממשק סמל

ממשק google.maps.Icon

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

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

הממשק MarkerLabel

ממשק google.maps.MarkerLabel

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

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

הממשק MarkerShape

ממשק google.maps.MarkerShape

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

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

ממשק Symbol

ממשק 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. אחרי שינוי התצוגה, הסמל יכול להיות בכל גודל. בסמלים על קו פוליגון, הערך שמוגדר כברירת מחדל הוא עובי הקו של קו הפוליגון. אחרי שינוי התצוגה, הסמל צריך להימצא בתוך ריבוע בגודל 22 פיקסלים שממורכז בציר של הסמל.
strokeColor optional
סוג:  string optional
צבע הקו של הסמל. יש תמיכה בכל הצבעים של CSS3, מלבד צבעים מורחבים עם שם. לסימוני סמלים, הערך שמוגדר כברירת מחדל הוא 'שחור'. בסמלים על קו פוליגון, הצבע שמוגדר כברירת מחדל הוא צבע הקו של קו הפוליגון.
strokeOpacity optional
סוג:  number optional
שקיפות הקו של הסמל. עבור סמנים של סמלים, הערך שמוגדר כברירת מחדל הוא 1. בסמלים על קו פוליגון, הערך שמוגדר כברירת מחדל הוא ערך האטימות של הקו של קו הפוליגון.
strokeWeight optional
סוג:  number optional
ברירת מחדל: הערך של Symbol.scale של הסמל.
עובי הקו של הסמל.

קבועים של SymbolPath

google.maps.SymbolPath קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {SymbolPath} = await google.maps.importLibrary("core"). ספריות ב-Maps JavaScript API

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

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

google.maps.Animation קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {Animation} = await google.maps.importLibrary("marker"). ספריות ב-Maps JavaScript API

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