הכיתה Marker
google.maps.Marker
class
הכיתה הזו היא תת-מחלקה של MVCObject
.
אפשר לגשת אליו באמצעות חיוג למספר const {Marker} = await google.maps.importLibrary("marker")
. ספריות ב-Maps JavaScript API
יצרן | |
---|---|
Marker |
Marker([opts]) פרמטרים:
יצירת סמן עם האפשרויות שצוינו. אם צוינה מפה, הסמן יתווסף למפה במהלך היצירה. חשוב לזכור שצריך להגדיר את המיקום כדי שהסמן יוצג. |
קבועים | |
---|---|
MAX_ZINDEX |
הערך המקסימלי של z-index שמוגדר כברירת מחדל וה-API מקצה לסמן. אפשר להגדיר ערך גבוה יותר של z-index כדי להציג את הסמן בחזית. |
Methods | |
---|---|
getAnimation |
getAnimation() פרמטרים: ללא
ערך המוחזר:
Animation|null|undefined אחזור האנימציה שפועלת כרגע. |
getClickable |
getClickable() פרמטרים: ללא
ערך המוחזר:
boolean True אם אפשר ללחוץ על הסמן.אחזור הסטטוס של האפשרות Marker לקליק. |
getCursor |
getCursor() פרמטרים: ללא
ערך המוחזר:
string|null|undefined הצגת סוג סמן העכבר כשמציבים את העכבר מעליו. |
getDraggable |
getDraggable() פרמטרים: ללא
ערך המוחזר:
boolean True אם אפשר לגרור את הסמן.הצגת הסטטוס של האפשרות לגרירה של Marker . |
getIcon |
getIcon() פרמטרים: ללא
מקבלים את הסמל של 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 |
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]) פרמטרים:
ערך המוחזר: None
מתחילים אנימציה. כל אנימציה שתתבצע באותו זמן תבוטל. האנימציות הנתמכות כרגע הן: Animation.BOUNCE , Animation.DROP . העברה של null תגרום להפסקת כל אנימציה. |
setClickable |
setClickable(flag) פרמטרים:
ערך המוחזר: None
מגדירים אם אפשר ללחוץ על Marker . |
setCursor |
setCursor([cursor]) פרמטרים:
ערך המוחזר: None
הגדרת סוג סמן העכבר שיוצג במהלך ההעברה מעליו. |
setDraggable |
setDraggable(flag) פרמטרים:
ערך המוחזר: None
מגדירים אם אפשר לגרור את Marker . |
setIcon |
setIcon([icon]) ערך המוחזר: None
מגדירים את הסמל של Marker . MarkerOptions.icon . |
setLabel |
setLabel([label]) פרמטרים:
ערך המוחזר: None
מגדירים את התווית של Marker . MarkerOptions.label . |
setMap |
setMap(map) פרמטרים:
ערך המוחזר: None
עיבוד ה- Marker במפה או בתצוגת הפנורמה שצוינו. אם המפה מוגדרת כ-null , הסמן יוסר. |
setOpacity |
setOpacity([opacity]) פרמטרים:
ערך המוחזר: None
מגדירים את השקיפות של Marker . |
setOptions |
setOptions(options) פרמטרים:
ערך המוחזר: None
מגדירים את האפשרויות של Marker . |
setPosition |
setPosition([latlng]) פרמטרים:
ערך המוחזר: None
מגדירים את המיקום של Marker . |
setShape |
setShape([shape]) פרמטרים:
ערך המוחזר: None
מגדירים את הצורה של Marker שמשמש לאינטראקציה. פרטים נוספים זמינים בMarkerOptions.shape ובMarkerShape . |
setTitle |
setTitle([title]) פרמטרים:
ערך המוחזר: None
הגדרת הכותרת של ההסבר הקצר Marker . MarkerOptions.title . |
setVisible |
setVisible(visible) פרמטרים:
ערך המוחזר: None
מגדירים אם Marker גלוי. |
setZIndex |
setZIndex([zIndex]) פרמטרים:
ערך המוחזר: 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 . |
|
function(event) ארגומנטים:
האירוע הזה מופעל בלחיצה ימנית על Marker . |
הממשק MarkerOptions
ממשק google.maps.MarkerOptions
אובייקט MarkerOptions שמשמש להגדרת המאפיינים שאפשר להגדיר בסמן.
מאפיינים | |
---|---|
anchorPoint optional |
סוג:
Point optional ההיסט ממיקום הסמן לקצה של חלון מידע שנפתח עם הסמן כעוגן. |
animation optional |
סוג:
Animation optional ברירת מחדל:
null איזו אנימציה תוצג כשהסימון יתווסף למפה. |
clickable optional |
סוג:
boolean optional ברירת מחדל:
true אם הערך הוא true , הסמן מקבל אירועי עכבר ומגע. |
|
סוג:
string|CollisionBehavior optional ברירת מחדל:
null הגדרת התנהגות התנגשות של סמנים במפות וקטוריות. |
crossOnDrag optional |
סוג:
boolean optional ברירת מחדל:
true אם הערך הוא false , הצלבו שתופיע מתחת לסמן בזמן גרירה יושבת. |
cursor optional |
סוג:
string optional ברירת מחדל:
pointer סוג סמן העכבר שיוצג כשמעבירים מעליו את העכבר. |
draggable optional |
סוג:
boolean optional ברירת מחדל:
false אם הערך הוא true , אפשר לגרור את הסמן. |
icon 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
– שמגדירים את האזור הלא שקוף בתמונה.
מאפיינים | |
---|---|
coords |
סוג:
Array<number> הפורמט של המאפיין הזה נקבע לפי הערך של 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 הן הקואורדינטות של הפינה השמאלית התחתונה של המלבן. |
type |
סוג:
string מתאר את סוג הצורה, והוא יכול להיות circle , poly או rect . |
ממשק 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 . בדרך כלל מציינים את סוג האנימציה הזה במהלך יצירת הסמן. |