מחלקת Marker
google.maps.Marker
class
הכיתה הזו היא הרחבה של MVCObject.
אפשר להתקשר אל const {Marker} = await google.maps.importLibrary("marker") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
|---|---|
Marker |
Marker([opts])פרמטרים:
יוצר סמן עם האפשרויות שצוינו. אם מצוינת מפה, הסמן מתווסף למפה כשהיא נוצרת. חשוב לזכור שצריך להגדיר את המיקום כדי שהסמן יוצג. |
Constants | |
|---|---|
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מקבלים את הצורה של 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])פרמטרים:
ערך מוחזר: אין
התחלת אנימציה. כל אנימציה שפועלת תבוטל. האנימציות הנתמכות כרגע הן: Animation.BOUNCE, Animation.DROP. העברה של null תגרום להפסקת האנימציה. |
setClickable |
setClickable(flag)פרמטרים:
ערך מוחזר: אין
הגדרה אם אפשר ללחוץ על Marker. |
setCursor |
setCursor([cursor])פרמטרים:
ערך מוחזר: אין
הגדרת סוג סמן העכבר שמוצג כשמציבים אותו מעל הדף. |
setDraggable |
setDraggable(flag)פרמטרים:
ערך מוחזר: אין
מגדירים אם אפשר לגרור את Marker. |
setIcon |
setIcon([icon])ערך מוחזר: אין
מגדירים את הסמל של Marker. MarkerOptions.icon. |
setLabel |
setLabel([label])פרמטרים:
ערך מוחזר: אין
מגדירים את התווית של Marker. MarkerOptions.label. |
setMap |
setMap(map)פרמטרים:
ערך מוחזר: אין
הפונקציה מעבדת את Marker במפה או בתצוגת הפנורמה שצוינו. אם המפה מוגדרת לערך null, הסמן יוסר. |
setOpacity |
setOpacity([opacity])פרמטרים:
ערך מוחזר: אין
מגדירים את השקיפות של Marker. |
setOptions |
setOptions(options)פרמטרים:
ערך מוחזר: אין
מגדירים את האפשרויות של Marker. |
setPosition |
setPosition([latlng])פרמטרים:
ערך מוחזר: אין
מגדירים את המיקום של Marker. |
setShape |
setShape([shape])פרמטרים:
ערך מוחזר: אין
מגדירים את הצורה של Marker שמשמשת לאינטראקציה. פרטים נוספים זמינים בMarkerOptions.shape ובMarkerShape. |
setTitle |
setTitle([title])פרמטרים:
ערך מוחזר: אין
מגדירים את הכותרת של ההסבר הקצר Marker. MarkerOptions.title. |
setVisible |
setVisible(visible)פרמטרים:
ערך מוחזר: אין
הגדרה אם Marker גלוי. |
setZIndex |
setZIndex([zIndex])פרמטרים:
ערך מוחזר: אין
מגדירים את 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 משתנה. |
|
function(event)ארגומנטים:
האירוע הזה מופעל כשלוחצים לחיצה ימנית על Marker. |
ממשק MarkerOptions
google.maps.MarkerOptions
ממשק
אובייקט MarkerOptions משמש להגדרת המאפיינים שאפשר להגדיר ב-Marker.
מאפיינים | |
|---|---|
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, אפשר לגרור את הסמן. הערה: אם מגדירים את הערך הזה ל-true, אפשר יהיה ללחוץ על הסמן גם אם הערך של clickable הוא false. |
icon 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.
Constants | |
|---|---|
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.
Constants | |
|---|---|
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.
Constants | |
|---|---|
BOUNCE |
הסמן קופץ עד שהאנימציה מופסקת על ידי קריאה ל-Marker.setAnimation עם null. |
DROP |
הסמן נופל מחלק העליון של המפה למיקום הסופי שלו. האנימציה תפסיק כשהסמן יגיע למנוחה וסמל החץ יחזור.Marker.getAnimationnull בדרך כלל מציינים את סוג האנימציה הזה בזמן יצירת הסמן. |