Advanced Markers

שיעור ב-AdvancedMarkerElement

כיתה google.maps.marker.AdvancedMarkerElement

הצגת מיקום במפה. חשוב להגדיר את position להצגת AdvancedMarkerElement.

הערה: השימוש כרכיב אינטרנט (למשל: באמצעות רכיב ה-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 של מפות Google JavaScript.

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

נכסים
collisionBehavior	סוג:  CollisionBehavior optional AdvancedMarkerElementOptions.collisionBehavior.
content	סוג:  Node optional AdvancedMarkerElementOptions.content.
element	סוג:  HTMLElement השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה.
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 ידיEvent options:  boolean|AddEventListenerOptions optional יש לעיין באפשרויות. אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך החזרה:  void מגדירה פונקציה שתופיע בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
addListener	addListener(eventName, handler) פרמטרים:  eventName:  string האירוע שנצפה. handler:  Function פונקציה לטיפול באירועים. ערך החזרה:  MapsEventListener מאזין האירוע כתוצאה מכך. הפונקציה מוסיפה את פונקציית ההאזנה הנתונה לשם האירוע הנתון במערכת Eventing Maps.
removeEventListener	הערה: זמין רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  type:  string מחרוזת שמציינת את סוג האירוע שעבורו יש להסיר את ה-event listener. listener:  EventListener|EventListenerObject מאזינים של האירוע של הגורם שמפעיל את האירוע כדי להסיר אותו מיעד האירוע. 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 הקודם להיראות ריק.
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 מוצגים במפה לפי סדר האינדקס שלהם, כאשר ערכים גבוהים יותר מוצגים לפני 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 של מפות Google 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 של מפות Google 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 מאזינים של האירוע של הגורם שמפעיל את האירוע כדי להסיר אותו מיעד האירוע. options:  boolean|EventListenerOptions optional הצגת אפשרויות ערך החזרה:  void הסרה של event listener שנרשם בעבר עם 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 קנה המידה של הסיכה.