Advanced Markers

המחלקה AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement מחלקה

מציג מיקום במפה. לתשומת ליבך, כדי שה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"). למידע נוסף, אפשר לעיין במאמר בנושא ספריות ב-API של JavaScript במפות.

יצרן
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.

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

המחלקה AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent מחלקה

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

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

כיתה זו תקפה ל-Event.

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

המחלקה PinElement

google.maps.marker.PinElement מחלקה

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

הערה: שימוש כרכיב אינטרנט (למשל שימוש כמחלקה משנה של HTMLElement או דרך HTML) עדיין לא נתמך.

כיתה זו תקפה ל-HTMLElement.

בדומיין הזה מוטמעת PinElementOptions.

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

יצרן
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.

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