מחלקה Marker
מחלקה google.maps.Marker
המחלקה הזו מרחיבה את 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|nullקבלת המפה או הפנורמה שבהן מוצג 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])פרמטרים:
ערך מוחזר: אין
הפעלת אנימציה. כל אנימציה שפועלת תבוטל. האנימציות שנתמכות כרגע הן: 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)ארגומנטים:
האירוע הזה מופעל כשאירוע contextmenu של 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
אובייקט MarkerOptions שמשמש להגדרת המאפיינים שאפשר להגדיר בסמן.
מאפיינים | |
|---|---|
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, אפשר לגרור את הסמן. הערה: אם מגדירים את המאפיין הזה לערך true, אפשר יהיה ללחוץ על הסמן גם אם המאפיין clickable מוגדר לערך false. |
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 שחופפים לסמן. |
ממשק Icon
ממשק 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גודל התצוגה של הספרייט או התמונה. כשמשתמשים בספרייטים, צריך לציין את גודל הספרייט. אם לא מציינים את הגודל, הוא יוגדר כשהתמונה תיטען. |
ממשק 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 – שמגדירים את האזור הלא שקוף של התמונה.
מאפיינים | |
|---|---|
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: הקואורדינטות הן [x1,y1,r] כאשר x1,y2 הן הקואורדינטות של מרכז המעגל, ו-r הוא הרדיוס של המעגל. - poly: הקואורדינטות הן [x1,y1,x2,y2...xn,yn], כאשר כל זוג x,y מכיל את הקואורדינטות של קודקוד אחד של המצולע. - rect: הקואורדינטות הן [x1,y1,x2,y2], כאשר x1,y1 הן הקואורדינטות של הפינה השמאלית העליונה של המלבן ו-x2,y2 הן הקואורדינטות של הפינה הימנית התחתונה של המלבן. |
ממשק Symbol
ממשק google.maps.Symbol
מתאר סמל, שמורכב מנתיב וקטורי עם סגנון. אפשר להשתמש בסמל כסמן או להציב אותו על קו פוליגוני.
מאפיינים | |
|---|---|
path |
סוג:
SymbolPath|stringהנתיב של הסמל, שהוא נתיב סמל מובנה, או נתיב בהתאמה אישית שמבוטא באמצעות סימון נתיב SVG. חובה. |
anchor optional |
סוג:
Point optionalברירת המחדל:
google.maps.Point(0,0)המיקום של הסמל ביחס לסמן או לקו הפוליגוני. הקואורדינטות של נתיב הסמל מתורגמות שמאלה ולמעלה לפי קואורדינטות ה-X וה-Y של העוגן, בהתאמה. המיקום מבוטא באותה מערכת קואורדינטות כמו הנתיב של הסמל. |
fillColor optional |
סוג:
string optionalצבע המילוי של הסמל. כל הצבעים של CSS3 נתמכים, חוץ מצבעים עם שמות מורחבים. בסמני סמלים, ברירת המחדל היא "black". בסמלים על קווים פוליגוניים, ברירת המחדל היא צבע הקו של הקו הפוליגוני המתאים. |
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 נתמכים, חוץ מצבעים עם שמות מורחבים. בסמני סמלים, ברירת המחדל היא "black". בסמלים בקו פוליגוני, ברירת המחדל היא צבע הקו של הקו הפוליגוני. |
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
קבועים
אנימציות שאפשר להפעיל על סמן. כדי להפעיל אנימציה, משתמשים ב-method Marker.setAnimation ב-Marker או באפשרות MarkerOptions.animation.
כדי לקבל גישה, צריך לקרוא ל: const {Animation} = await google.maps.importLibrary("marker").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.
קבועים | |
|---|---|
BOUNCE |
הסמן מקפץ עד שהאנימציה נעצרת על ידי קריאה ל-Marker.setAnimation עם null. |
DROP |
הסמן נופל מהחלק העליון של המפה למיקום הסופי שלו. האנימציה תיפסק כשהסמן יפסיק לזוז, ו-Marker.getAnimation יחזיר את הערך null. בדרך כלל מציינים את סוג האנימציה הזה כשיוצרים את הסמן. |