‫ Places UI Kit: ספרייה מוכנה לשימוש שמאפשרת למפתחים להתאים אישית ולשלוט. כדאי לנסות ולשתף את המשוב שלך על חוויית השימוש בערכת ממשק המשתמש.

דף זה תורגם על ידי Cloud Translation API.

Marker (legacy)

מחלקת Marker

google.maps.Marker class

הוצאה משימוש: החל מ-21 בפברואר 2024, אנחנו מוציאים משימוש את הכלי google.maps.Marker. יש להשתמש בעמודות AdvancedMarkerElement במקומן. בשלב הזה, אין תוכניות להוציא משימוש את הכלי google.maps.Marker, אבל מומלץ להשתמש ב-AdvancedMarkerElement במקום ב-google.maps.Marker. הכלי google.maps.Marker ימשיך לקבל תיקוני באגים לכל רגרסיה משמעותית, אבל באגים קיימים ב-google.maps.Marker לא יטופלו. נודיע לכם לפחות 12 חודשים לפני הפסקת התמיכה. פרטים נוספים זמינים בכתובת https://developers.google.com/maps/deprecations ומדריך ההעברה זמין בכתובת https://developers.google.com/maps/documentation/javascript/advanced-markers/migration.

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {Marker} = await google.maps.importLibrary("marker") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן
`Marker`	`Marker([opts])` פרמטרים: `opts`: `MarkerOptions optional` ארגומנטים אופציונליים עם שם יוצר סמן עם האפשרויות שצוינו. אם מצוינת מפה, הסמן מתווסף למפה כשהיא נוצרת. חשוב לזכור שצריך להגדיר את המיקום כדי שהסמן יוצג.

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()` פרמטרים: אין ערך מוחזר: `string\|Icon\|Symbol\|null\|undefined` מקבלים את הסמל של `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`: `Animation optional` האנימציה להפעלה. ערך מוחזר: אין התחלת אנימציה. כל אנימציה שפועלת תבוטל. האנימציות הנתמכות כרגע הן: `Animation.BOUNCE`, ‏ `Animation.DROP`. העברה של `null` תגרום להפסקת האנימציה.
`setClickable`	`setClickable(flag)` פרמטרים: ‫`flag`: `boolean` אם `true`, אפשר ללחוץ על הסמן. ערך מוחזר: אין הגדרה אם אפשר ללחוץ על `Marker`.
`setCursor`	`setCursor([cursor])` פרמטרים: ‫`cursor`: `string optional` סוג סמן העכבר. ערך מוחזר: אין הגדרת סוג סמן העכבר שמוצג כשמציבים אותו מעל הדף.
`setDraggable`	`setDraggable(flag)` פרמטרים: ‫`flag`: `boolean optional` אם `true`, אפשר לגרור את הסמן. ערך מוחזר: אין מגדירים אם אפשר לגרור את `Marker`.
`setIcon`	`setIcon([icon])` פרמטרים: `icon`: `string\|Icon\|Symbol optional` ערך מוחזר: אין מגדירים את הסמל של `Marker`. `MarkerOptions.icon`.
`setLabel`	`setLabel([label])` פרמטרים: ‫`label`: `string\|MarkerLabel optional` התווית יכולה להיות מחרוזת תווים או אובייקט `MarkerLabel`. ערך מוחזר: אין מגדירים את התווית של `Marker`. `MarkerOptions.label`.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map\|StreetViewPanorama` ערך מוחזר: אין הפונקציה מעבדת את `Marker` במפה או בתצוגת הפנורמה שצוינו. אם המפה מוגדרת לערך `null`, הסמן יוסר.
`setOpacity`	`setOpacity([opacity])` פרמטרים: ‫`opacity`: `number optional` מספר בין 0.0 (שקוף) ל-1.0 (אטום). ערך מוחזר: אין מגדירים את השקיפות של `Marker`.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `MarkerOptions` ערך מוחזר: אין מגדירים את האפשרויות של `Marker`.
`setPosition`	`setPosition([latlng])` פרמטרים: ‫`latlng`: `LatLng\|LatLngLiteral optional` המיקום החדש. ערך מוחזר: אין מגדירים את המיקום של `Marker`.
`setShape`	`setShape([shape])` פרמטרים: `shape`: `MarkerShape optional` ערך מוחזר: אין מגדירים את הצורה של `Marker` שמשמשת לאינטראקציה. פרטים נוספים זמינים ב`MarkerOptions.shape` וב`MarkerShape`.
`setTitle`	`setTitle([title])` פרמטרים: `title`: `string optional` ערך מוחזר: אין מגדירים את הכותרת של ההסבר הקצר `Marker`. `MarkerOptions.title`.
`setVisible`	`setVisible(visible)` פרמטרים: ‫`visible`: `boolean` אם `true`, הסמן גלוי ערך מוחזר: אין הגדרה אם `Marker` גלוי.
`setZIndex`	`setZIndex([zIndex])` פרמטרים: `zIndex`: `number optional` ערך מוחזר: אין מגדירים את zIndex של `Marker`. `MarkerOptions.zIndex`.
בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

אירועים
`animation_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין האנימציה `Marker` משתנה.
`click`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשלוחצים על הסמל `Marker`.
`clickable_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמשתנה המאפיין `Marker`clickable.
`contextmenu`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהאירוע contextmenu של DOM מופעל ב-`Marker`
`cursor_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין הסמן `Marker` משתנה.
`dblclick`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשלוחצים לחיצה כפולה על הסמל `Marker`.
`drag`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את `Marker`.
`dragend`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש מפסיק לגרור את `Marker`.
`draggable_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין `Marker` draggable משתנה.
`dragstart`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש מתחיל לגרור את `Marker`.
`flat_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כש`Marker`הנכס השטוח משתנה.
`icon_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין הסמל `Marker` משתנה.
`mousedown`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשמתבצעת לחיצה על העכבר על `Marker`.
`mouseout`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהעכבר יוצא מהאזור של הסמל `Marker`.
`mouseover`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהעכבר נכנס לאזור של הסמל `Marker`.
`mouseup`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשמשחררים את לחצן העכבר על `Marker`.
`position_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין המיקום `Marker` משתנה.
`shape_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין הצורה `Marker` משתנה.
`title_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין `Marker` title משתנה.
`visible_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין `Marker` visible משתנה.
`zindex_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין `Marker` zIndex משתנה.
`rightclick`	הוצא משימוש: כדי לתמוך בדפוסי שימוש כמו קליק עם Ctrl ב-macOS, צריך להשתמש באירוע `Marker.contextmenu` במקום זאת. `function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשלוחצים לחיצה ימנית על `Marker`.

ממשק MarkerOptions

google.maps.MarkerOptions ממשק

אובייקט MarkerOptions משמש להגדרת המאפיינים שאפשר להגדיר ב-Marker.

מאפיינים
`anchorPoint optional`	סוג: `Point optional` ההיסט ממיקום הסמן לקצה של חלון מידע שנפתח כשהסמן משמש כנקודת עיגון.
`animation optional`	סוג: `Animation optional` ברירת מחדל: `null` איזו אנימציה להפעיל כשסמן נוסף למפה.
`clickable optional`	סוג: `boolean optional` ברירת מחדל: `true` אם `true`, הסמן מקבל אירועי עכבר ומגע.
`collisionBehavior optional`	הוצאה משימוש: `collisionBehavior` הוצא משימוש החל מיולי 2023. במקום זאת, אתם צריכים להשתמש ב-`AdvancedMarkerElement.collisionBehavior`. הערה: התכונה זמינה רק בערוץ v=beta. סוג: `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`	סוג: `string\|Icon\|Symbol 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`	סוג:

Marker (legacy) קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מחלקת Marker

יצרן

Constants

Methods

אירועים

ממשק MarkerOptions

מאפיינים

Marker (legacy)