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.

יצרן
AdvancedMarkerElement	AdvancedMarkerElement([options]) פרמטרים:  options:  AdvancedMarkerElementOptions optional יוצרת AdvancedMarkerElement עם האפשרויות שצוינו. אם מציינים מפה, ה-AdvancedMarkerElement מתווסף למפה בזמן הבנייה.

מאפיינים
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	הוצא משימוש: צריך להשתמש ישירות ב-AdvancedMarkerElement. סוג:  HTMLElement השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה.
content	הוצא משימוש: במקומו צריך להשתמש ב-.children. סוג:  Node optional AdvancedMarkerElementOptions.content.

Methods
addEventListener	addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף על addEventListener
addListener	addListener(eventName, handler) פרמטרים:  eventName:  string אירוע שנצפה. ‫handler:  Function פונקציה לטיפול באירועים. ערך מוחזר:  MapsEventListener פונקציית event listener שנוצרת. הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע שצוין במערכת Eventing של מפות Google.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

אירועים
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	הערה: התכונה זמינה רק בערוץ v=beta. 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	הערה: התכונה זמינה רק בערוץ v=beta. סוג:  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

הערה: התכונה זמינה רק בערוץ v=beta.

האירוע הזה נוצר כשלוחצים על סמן מתקדם. אפשר לגשת למיקום הסמן באמצעות 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.

יצרן
PinElement	PinElement([options]) פרמטרים:  options:  PinElementOptions optional

מאפיינים
background	סוג:  string optional PinElementOptions.background.
borderColor	סוג:  string optional PinElementOptions.borderColor.
element	סוג:  HTMLElement השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה.
glyph	סוג:  string|Element|URL optional PinElementOptions.glyph.
glyphColor	סוג:  string optional PinElementOptions.glyphColor.
scale	סוג:  number optional PinElementOptions.scale.

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional ערך מוחזר:  void הפונקציה הזו עדיין לא זמינה לשימוש.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. 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.

מאפיינים
background optional	סוג:  string optional צבע הרקע של צורת הסיכה. אפשר להשתמש בכל ערך צבע של CSS.
borderColor optional	סוג:  string optional צבע הגבול של צורת הסיכה. אפשר להשתמש בכל ערך צבע של CSS.
glyph optional	סוג:  string|Element|URL optional רכיב ה-DOM שמוצג בסיכה.
glyphColor optional	סוג:  string optional הצבע של הגליף. אפשר להשתמש בכל ערך צבע של CSS.
scale optional	סוג:  number optional ברירת מחדל: 1 הגודל של הסיכה.