Advanced Markers

הכיתה AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement class

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

הערה: השימוש כרכיב אינטרנט (למשל, שימוש ברכיב ה-HTML בהתאמה אישית <gmp-advanced-marker> זמין רק בערוץ v=beta).

רכיב מותאם אישית:
<gmp-advanced-marker 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.
content	סוג:  Node optional AdvancedMarkerElementOptions.content.
element	סוג:  HTMLElement השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שתומך בתצוגה.
gmpClickable	הערה: התכונה זמינה רק בערוץ v=beta. סוג:  boolean optional AdvancedMarkerElementOptions.gmpClickable.
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.

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

הכיתה AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent class

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

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

הכיתה הזו היא תת-מחלקה של Event.

אפשר לגשת אליו באמצעות חיוג למספר const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). ספריות ב-Maps JavaScript API

הכיתה PinElement

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

הממשק PinElementOptions

ממשק 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 הסולם של הסיכה.