מחלקת 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() ארגומנטים: אין
האירוע הזה מופעל כשמשתנה המאפיין Marker clickable. |
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.getAnimation null בדרך כלל מציינים את סוג האנימציה הזה בזמן יצירת הסמן. |