Marker (legacy)

סיווג

google.maps.Marker סיווג

הכיתה הזו משתרעת על פני MVCObject.

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

Marker
Marker([opts])
פרמטרים: 
  • optsMarkerOptions optional ארגומנטים אופציונליים בעלי שם
יצירת סמן עם האפשרויות שצוינו. אם תציינו מפה, הסמן יתווסף למפה במהלך הבנייה. חשוב לזכור שצריך להגדיר את המיקום כדי שהסמן יוצג.
MAX_ZINDEX ערך ברירת המחדל המקסימלי של z-index שה-API יקצה לסמן. תוכל להגדיר מדד z גבוה יותר כדי להביא סמן קדימה.
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 האנימציה להפעלה.
ערך החזרה: ללא
מתחילים אנימציה. כל האנימציה המתמשכת תבוטל. האנימציות הנתמכות כרגע הן: 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
ערך החזרה: ללא
מגדירים את ה-zIndex של Marker. MarkerOptions.zIndex.
עברה בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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

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

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
כל הסמנים מוצגים במפה לפי סדר ה-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
מיקום התמונה בתוך Sprite, אם יש. כברירת מחדל, המקור נמצא בפינה השמאלית העליונה של התמונה (0, 0).
scaledSize optional
סוג:  Size optional
הגודל של התמונה כולה לאחר הגדלה באחוזים, אם קיים. השתמשו בתכונה הזו כדי למתוח/לכווץ תמונה או Sprite.
size optional
סוג:  Size optional
גודל התצוגה של ה-Sprite או של התמונה. כשמשתמשים ב-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
משפחת הגופנים של טקסט התווית (שווה למאפיין משפחת הגופנים ב-CSS).
fontSize optional
סוג:  string optional
ברירת מחדל: '14px'
גודל הגופן של טקסט התווית (שווה למאפיין גודל הגופן ב-CSS).
fontWeight optional
סוג:  string optional
משקל הגופן של טקסט התווית (שווה למאפיין משקל הגופן ב-CSS).

ממשק MarkerShape

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

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

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