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 האנימציה להפעלה.
ערך מוחזר:  אין
התחלת אנימציה. כל אנימציה שפועלת תבוטל. האנימציות הנתמכות כרגע הן: 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()
ארגומנטים:  אין
האירוע הזה מופעל כשמשתנה המאפיין Markerclickable.
contextmenu
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהאירוע contextmenu של DOM מופעל ב-Marker
cursor_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמאפיין הסמן Marker משתנה.
dblclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים לחיצה כפולה על הסמל Marker.
drag
function(event)
ארגומנטים: 
האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את Marker.
dragend
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש מפסיק לגרור את Marker.
draggable_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמאפיין Marker draggable משתנה.
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 title משתנה.
visible_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמאפיין Marker visible משתנה.
zindex_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמאפיין Marker zIndex משתנה.
rightclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים לחיצה ימנית על Marker.

ממשק MarkerOptions

google.maps.MarkerOptions ממשק

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

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 ולא מציינים את התג 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 constants

אפשר להתקשר אל 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 של התמונה או של גיליון הספריטים.
anchor optional
סוג:  Point optional
המיקום שבו התמונה מעוגנת בהתאם למיקום הסמן במפה. כברירת מחדל, העוגן ממוקם לאורך נקודת המרכז של החלק התחתון של התמונה.
labelOrigin optional
סוג:  Point optional
המיקום של התווית ביחס לפינה הימנית העליונה של תמונת הסמל, אם הסמן מספק תווית. כברירת מחדל, המקור ממוקם בנקודת המרכז של התמונה.
origin optional
סוג:  Point optional
המיקום של התמונה בספריית הסמלים, אם יש כזה. כברירת מחדל, המקור ממוקם בפינה הימנית העליונה של התמונה (0, 0).
scaledSize optional
סוג:  Size optional
הגודל של התמונה כולה אחרי שינוי הגודל, אם יש כזה. אפשר להשתמש במאפיין הזה כדי למתוח או לכווץ תמונה או ספרייט.
size optional
סוג:  Size optional
גודל התצוגה של הספרייט או התמונה. כשמשתמשים בספרייטים, צריך לציין את הגודל שלהם. אם לא מציינים את הגודל, הוא יוגדר כשהתמונה תיטען.

MarkerLabel interface

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'
גודל הגופן של טקסט התווית (שווה לתכונת CSS font-size).
fontWeight optional
סוג:  string optional
משקל הגופן של טקסט התווית (שווה לתכונת CSS font-weight).

MarkerShape interface

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 is [x1,y1,x2,y2] where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.

ממשק 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 constants

google.maps.SymbolPath constants

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

אפשר להתקשר אל 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 constants

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

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

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