סיווג
google.maps.Marker
סיווג
הכיתה הזו משתרעת על פני
MVCObject
.
ניתן לגשת באמצעות חיוג אל const {Marker} = await google.maps.importLibrary("marker")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Marker |
Marker([opts]) פרמטרים:
יצירת סמן עם האפשרויות שצוינו. אם תציינו מפה, הסמן יתווסף למפה במהלך הבנייה. חשוב לזכור שצריך להגדיר את המיקום כדי שהסמן יוצג. |
קבועים | |
---|---|
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() פרמטרים: ללא
קבלת הסמל של 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]) פרמטרים:
ערך החזרה: ללא
|
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() ארגומנטים: ללא
האירוע הזה מופעל כשהמאפיין 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 משתנה. |
|
function(event) ארגומנטים:
האירוע הזה מופעל בעקבות לחיצה ימנית על Marker . |
ממשק MarkerOptions
ממשק google.maps.MarkerOptions
אובייקט MarkupOptions המשמש להגדרת המאפיינים שניתן להגדיר בסמן.
תכונות | |
---|---|
anchorPoint optional |
סוג:
Point optional הסטייה מהמיקום של הסמן אל קצה ה-InfoWindow (חלון מידע) שנפתח עם הסמן כעוגן. |
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 מיקום התמונה בתוך 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 . סוג האנימציה הזה מצוין בדרך כלל במהלך יצירת הסמן. |