שיעור סמן
כיתה google.maps.Marker
הכיתה הזו מרחיבה את
MVCObject
.
כדי לקבל גישה, צריך להתקשר ל-const {Marker} = await google.maps.importLibrary("marker")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
יצרן | |
---|---|
Marker |
Marker([opts]) פרמטרים:
יצירת סמן עם האפשרויות שצוינו. אם צוינה מפה, הסמן יתווסף למפה בזמן היצירה. הערה: יש להגדיר את המיקום כך שהסמן יוצג. |
שיטות | |
---|---|
getAnimation |
getAnimation() פרמטרים: ללא
ערך החזרה:
Animation|null|undefined מורידים את האנימציה שפועלת כרגע. |
getClickable |
getClickable() פרמטרים: ללא
ערך החזרה:
boolean אם הערך של הסמן ניתן ללחיצה.קבלת הסטטוס שניתן ללחוץ עליו של 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 אם הערך גלוי.הצגת החשיפה של Marker . |
getZIndex |
getZIndex() פרמטרים: ללא
ערך החזרה:
number|null|undefined zאינדקס של הסמן.קבלת אינדקס ה-z של 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]) פרמטרים:
ערך החזרה: אין
מגדירים את אינדקס ה-z של Marker . MarkerOptions.zIndex . |
הועבר בירושה:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
קבועים | |
---|---|
MAX_ZINDEX |
אינדקס ה-z המקסימלי המוגדר כברירת מחדל, שה-API יקצה לסמן. אפשר להגדיר אינדקס z גבוה יותר כדי להציב סמן בחזית. |
אירועים | |
---|---|
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
אובייקט Markupאפשרויות המשמש להגדרת המאפיינים שניתן להגדיר בסמן.
מאפיינים | |
---|---|
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 כל הסמנים מוצגים במפה לפי סדר האינדקס שלהם, כאשר ערכים גבוהים יותר מוצגים לפני הסמנים עם הערכים הנמוכים יותר. כברירת מחדל, הסמנים מוצגים בהתאם למיקום האנכי שלהם במסך, וכשסמנים נמוכים יותר מופיעים לפני הסמנים בחלק העליון של המסך. |
קבועים של CollisionBehavior
google.maps.CollisionBehavior
קבועים
כדי לקבל גישה, צריך להתקשר ל-const {CollisionBehavior} = await google.maps.importLibrary("marker")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
קבועים | |
---|---|
OPTIONAL_AND_HIDES_LOWER_PRIORITY |
יש להציג את הסמן רק אם הוא לא חופף לסמנים אחרים. אם שני סמנים מהסוג הזה חופפים, יוצג סימן זה עם אינדקס האינדקס הגבוה יותר. אם יש להם אותו אינדקס z, מופיע המסך עם המיקום האנכי הנמוך יותר. |
REQUIRED |
תמיד להציג את הסמן ללא קשר להתנגשות. זאת התנהגות ברירת המחדל. |
REQUIRED_AND_HIDES_OPTIONAL |
תמיד להציג את הסמן ללא התנגשות, ולהסתיר סמנים OPTIONAL_AND_HIDES_LOWER_PRIORITY או תוויות החופפות לסמן. |
ממשק Icon
ממשק google.maps.Icon
מבנה שמייצג תמונה של סמל של סמן.
מאפיינים | |
---|---|
url |
סוג:
string כתובת ה-URL של התמונה או הגיליון. |
anchor optional |
סוג:
Point optional המיקום שבו יש להצמיד תמונה בהתאם למיקום הסמן במפה. כברירת מחדל, העוגן ממוקם לאורך נקודת האמצע בתחתית התמונה. |
labelOrigin optional |
סוג:
Point optional מקור התווית באופן יחסי לפינה הימנית העליונה של תמונת הסמל, אם התווית מסופקת על ידי הסמן. כברירת מחדל, המקור נמצא במרכז של התמונה. |
origin optional |
סוג:
Point optional המיקום של התמונה בתוך ה-Sprite, אם יש כזה. כברירת מחדל, המקור נמצא בפינה הימנית העליונה של התמונה (0, 0) . |
scaledSize optional |
סוג:
Size optional גודל התמונה כולה לאחר שינוי קנה המידה, אם יש כזה. באמצעות הנכס הזה ניתן לכווץ/לכווץ תמונה או Sprit. |
size optional |
סוג:
Size optional גודל התצוגה של ה-Sprite או התמונה. כשמשתמשים ב-Sprits, חובה לציין את גודל ה-Sprite. אם לא תספקו את הגודל, הוא יוגדר כשהתמונה תיטען. |
הממשק של MarkerLabel
ממשק google.maps.MarkerLabel
אפשרויות אלה מציינות את המראה של תווית סימון. תווית סמן היא מחרוזת (לרוב תו אחד) שתופיע בתוך הסמן. אם משתמשים בו עם סמן בהתאמה אישית, אפשר למקם אותו מחדש עם המאפיין labelOrigin
בכיתה Icon
.
מאפיינים | |
---|---|
text |
סוג:
string הטקסט שיוצג בתווית. |
className optional |
סוג:
string optional ברירת מחדל:
'' (מחרוזת ריקה)מאפיין className של רכיב התווית (שווה ערך למאפיין המחלקה של הרכיב). אפשר להוסיף כמה קורסים של CSS שמופרדים ברווחים. אפשר להגדיר את הצבע, הגודל, המשקל והמשפחה של הגופן רק במאפיינים אחרים של MarkerLabel . אסור להשתמש בשיעורי CSS כדי לשנות את המיקום או את הכיוון של התווית (למשל, שימוש בתרגומים ובסיבובים) אם משתמשים גם בניהול של תאונות דרכים. |
color optional |
סוג:
string optional ברירת מחדל:
'black' צבע הטקסט של התווית. |
fontFamily optional |
סוג:
string optional משפחת הגופנים של טקסט התווית (שווה ערך לנכס הגופן המשפחתי של CSS). |
fontSize optional |
סוג:
string optional ברירת מחדל:
'14px' גודל הגופן של טקסט התווית (זהה לנכס הגודל של גופן CSS). |
fontWeight optional |
סוג:
string optional משקל הגופן של טקסט התווית (זהה לנכס המשקל ב-CSS). |
הממשק של Marker הצורה
ממשק 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. לאחר התאמת קנה המידה, הסמל יכול להיות בכל גודל. עבור סמלים של Polyline, ברירת המחדל היא משקל המשיכת של ה-Polyline; לאחר התאמת קנה המידה, הסמל חייב להיות בתוך ריבוע בגודל 22 פיקסלים, במרכז של העוגן של הסמל. |
strokeColor optional |
סוג:
string optional צבע הקווים של הסמל. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים. עבור סימני סמלים, ברירת המחדל היא 'שחור'. עבור סמלים של Polyline, ברירת המחדל היא צבע הקווים של המצולע. |
strokeOpacity optional |
סוג:
number optional שקיפות האות של הסמל. בסמני סמלים, ברירת המחדל היא 1. עבור סמלים של polyline, ברירת המחדל היא שקיפות הקווים של ה-polyline. |
strokeWeight optional |
סוג:
number optional ברירת מחדל:
Symbol.scale של הסמל.משקל הסימן של הסמל. |
קבועים של ICONPath
google.maps.SymbolPath
קבועים
נתיבי סמלים מובנים.
כדי לקבל גישה, צריך להתקשר ל-const {SymbolPath} = await google.maps.importLibrary("core")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
קבועים | |
---|---|
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")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
קבועים | |
---|---|
BOUNCE |
הסמן יקפוץ עד שהאנימציה תיפסק. כדי לעשות זאת, צריך להתקשר אל Marker.setAnimation באמצעות null . |
DROP |
הסמן נופל מהחלק העליון של המפה אל המיקום הסופי שלה. האנימציה תיפסק ברגע שהסמן יחזור למצב מנוחה, ו-Marker.getAnimation יחזיר null . הנפשה מסוג זה מופיעה בדרך כלל במהלך יצירת הסמן. |