Advanced Markers

‫AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement class

הצגת מיקום במפה. הערה: כדי שהשדה AdvancedMarkerElement יוצג, צריך להגדיר את position.

רכיב בהתאמה אישית:
<gmp-advanced-marker gmp-clickable position="lat,lng" title="string"></gmp-advanced-marker>

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

במחלקה הזו מיושם AdvancedMarkerElementOptions.

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

מאפיינים
collisionBehavior	סוג:  CollisionBehavior optional AdvancedMarkerElementOptions.collisionBehavior.
gmpClickable	סוג:  boolean optional AdvancedMarkerElementOptions.gmpClickable. מאפיין HTML: <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
gmpDraggable	סוג:  boolean optional AdvancedMarkerElementOptions.gmpDraggable.
map	סוג:  Map optional AdvancedMarkerElementOptions.map.
position	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional AdvancedMarkerElementOptions.position. מאפיין HTML: <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	סוג:  string AdvancedMarkerElementOptions.title. מאפיין HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	סוג:  number optional AdvancedMarkerElementOptions.zIndex.
element	סוג:  HTMLElement השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה.
content	סוג:  Node optional AdvancedMarkerElementOptions.content.

אירועים
click	function(event) ארגומנטים:  event:  MapMouseEvent האירוע הזה מופעל כשלוחצים על רכיב AdvancedMarkerElement. לא זמין עם addEventListener() (אפשר להשתמש ב-gmp-click במקום).
drag	function(event) ארגומנטים:  event:  MapMouseEvent האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את AdvancedMarkerElement. לא זמין ב-addEventListener().
dragend	function(event) ארגומנטים:  event:  MapMouseEvent האירוע הזה מופעל כשהמשתמש מפסיק לגרור את AdvancedMarkerElement. לא זמין ב-addEventListener().
dragstart	function(event) ארגומנטים:  event:  MapMouseEvent האירוע הזה מופעל כשהמשתמש מתחיל לגרור את AdvancedMarkerElement. לא זמין ב-addEventListener().
gmp-click	function(event) ארגומנטים:  event:  AdvancedMarkerClickEvent האירוע הזה מופעל כשלוחצים על רכיב AdvancedMarkerElement. מומלץ להשתמש ב-addEventListener() (במקום ב-addListener()).

ממשק AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptions ממשק

אפשרויות ליצירת AdvancedMarkerElement.

מאפיינים
collisionBehavior optional	סוג:  CollisionBehavior optional ספירה שמציינת איך רכיב AdvancedMarkerElement צריך להתנהג כשהוא מתנגש עם רכיב AdvancedMarkerElement אחר או עם התוויות של מפת הבסיס במפת וקטור. הערה: התנגשות בין AdvancedMarkerElement ל-AdvancedMarkerElement פועלת במפות רסטר ובמפות וקטוריות, אבל התנגשות בין AdvancedMarkerElement לתווית של מפת הבסיס פועלת רק במפות וקטוריות.
content optional	סוג:  Node optional ברירת מחדל: PinElement.element רכיב ה-DOM שמאחורי התצוגה החזותית של AdvancedMarkerElement. הערה: הפונקציה AdvancedMarkerElement לא משכפלת את רכיב ה-DOM שמועבר אליה. אחרי שמעבירים את רכיב ה-DOM ל-AdvancedMarkerElement, העברה של אותו רכיב DOM ל-AdvancedMarkerElement אחר תגרום להעברה של רכיב ה-DOM ולכך ש-AdvancedMarkerElement הקודם ייראה ריק.
gmpClickable optional	סוג:  boolean optional ברירת מחדל: false אם true, הרכיב AdvancedMarkerElement יהיה קליקבילי ויפעיל את האירוע gmp-click, והוא יהיה אינטראקטיבי למטרות נגישות (למשל, יאפשר ניווט באמצעות מקשי החצים).
gmpDraggable optional	סוג:  boolean optional ברירת מחדל: false אם true, אפשר לגרור את AdvancedMarkerElement. הערה: אי אפשר לגרור את AdvancedMarkerElement עם הגובה.
map optional	סוג:  Map optional המפה שבה יוצג AdvancedMarkerElement. כדי להציג את AdvancedMarkerElement צריך להוסיף מפה. אפשר להוסיף מפה על ידי הגדרת AdvancedMarkerElement.map אם לא צוינה מפה בשלב ההגדרה.
position optional	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional מגדיר את המיקום של AdvancedMarkerElement. אפשר ליצור AdvancedMarkerElement בלי מיקום, אבל הוא לא יוצג עד שיוגדר לו מיקום – למשל, על ידי פעולות או בחירות של משתמש. אפשר לציין את המיקום של AdvancedMarkerElement על ידי הגדרת AdvancedMarkerElement.position אם לא צוין מיקום בזמן היצירה. הערה: AdvancedMarkerElement עם גובה נתמך רק במפות וקטוריות.
title optional	סוג:  string optional טקסט לגלגול. אם מספקים טקסט נגישות (למשל לשימוש עם קוראי מסך), הוא יתווסף לרכיב AdvancedMarkerElement עם הערך שסופק.
zIndex optional	סוג:  number optional כל AdvancedMarkerElements מוצגים במפה לפי סדר zIndex שלהם, כאשר ערכים גבוהים יותר מוצגים לפני AdvancedMarkerElements עם ערכים נמוכים יותר. כברירת מחדל, רכיבי AdvancedMarkerElement מוצגים לפי המיקום האנכי שלהם במסך, כך שרכיבי AdvancedMarkerElement שנמצאים בחלק התחתון של המסך מוצגים לפני רכיבי AdvancedMarkerElement שנמצאים בחלק העליון של המסך. שימו לב: zIndex משמש גם כדי לקבוע את העדיפות היחסית בין CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY סמנים מתקדמים. ערך גבוה יותר של zIndex מציין עדיפות גבוהה יותר.

‫AdvancedMarkerClickEvent class

google.maps.marker.AdvancedMarkerClickEvent class

האירוע הזה נוצר כשלוחצים על סמן מתקדם. אפשר לגשת למיקום הסמן באמצעות event.target.position.

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

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

PinElement class

google.maps.marker.PinElement class

‫PinElement מייצג רכיב DOM שמורכב מצורה וגליף. לצורה יש את אותו סגנון בועה כמו בברירת המחדל AdvancedMarkerElement. הגליף הוא רכיב DOM אופציונלי שמוצג בצורת בועה. יכול להיות שלPinElement יהיה יחס גובה-רוחב שונה בהתאם לPinElement.scale.

הערה: עדיין אין תמיכה בשימוש כרכיב אינטרנט (למשל, שימוש כסיווג משנה של HTMLElement או באמצעות HTML).

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

במחלקה הזו מיושם PinElementOptions.

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

Methods
addEventListener	addEventListener(type, listener[, options]) פרמטרים:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional ערך מוחזר:  void הפונקציה הזו עדיין לא זמינה לשימוש.
removeEventListener	removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PinElementOptions interface

google.maps.marker.PinElementOptions ממשק

אפשרויות ליצירת PinElement.