Advanced Markers

AdvancedMarkerElement class

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

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

רכיב בהתאמה אישית:
<gmp-advanced-marker anchor-left="string" anchor-top="string" 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 מתווסף למפה בזמן היצירה.

מאפיינים
anchorLeft	סוג:  string optional ברירת מחדל: "-50%" ערך אחוז אורך CSS שמשמש להסטת נקודת העיגון של הסמן מהפינה השמאלית העליונה של הסמן. האפשרות הזו שימושית כשמשתמשים ברכיב חזותי עם נקודת עיגון שונה מהנקודה הרגילה במרכז התחתון של סמן ברירת המחדל. מאפיין HTML: <gmp-advanced-marker anchor-left="string"></gmp-advanced-marker>
anchorTop	סוג:  string optional ברירת מחדל: "-100%" ערך אחוז אורך CSS שמשמש להסטת נקודת העיגון של הסמן מהפינה השמאלית העליונה של הסמן. האפשרות הזו שימושית כשמשתמשים ברכיב חזותי עם נקודת עיגון שונה מהנקודה הרגילה במרכז התחתון של סמן ברירת המחדל. מאפיין HTML: <gmp-advanced-marker anchor-top="string"></gmp-advanced-marker>
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 הנתונה לשם האירוע הנתון במערכת האירועים של מפות Google.
removeEventListener	removeEventListener(type, listener[, options]) פרמטרים:  type:  string מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener. ‫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	function(event) ארגומנטים:  event:  AdvancedMarkerClickEvent האירוע הזה מופעל כשלוחצים על הרכיב AdvancedMarkerElement. מומלץ להשתמש ב-addEventListener() (במקום ב-addListener()).

ממשק AdvancedMarkerElementOptions

ממשק google.maps.marker.AdvancedMarkerElementOptions

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

מאפיינים
anchorLeft optional	סוג:  string optional ברירת מחדל: "-50%" ערך אחוז אורך CSS שמשמש להסטת נקודת העיגון של הסמן מהפינה השמאלית העליונה של הסמן. האפשרות הזו שימושית כשמשתמשים ברכיב חזותי עם נקודת עיגון שונה מהנקודה הרגילה במרכז התחתון של סמן ברירת המחדל.
anchorTop optional	סוג:  string optional ברירת מחדל: "-100%" ערך אחוז אורך CSS שמשמש להסטת נקודת העיגון של הסמן מהפינה השמאלית העליונה של הסמן. האפשרות הזו שימושית כשמשתמשים ברכיב חזותי עם נקודת עיגון שונה מהנקודה הרגילה במרכז התחתון של סמן ברירת המחדל.
collisionBehavior optional	סוג:  CollisionBehavior optional רשימה שמציינת איך AdvancedMarkerElement אמור להתנהג כשהוא מתנגש עם AdvancedMarkerElement אחר או עם תוויות מפת הבסיס במפה וקטורית. הערה: התנגשות בין AdvancedMarkerElement ל-AdvancedMarkerElement פועלת גם במפות רסטר וגם במפות וקטוריות, אבל התנגשות בין AdvancedMarkerElement לתווית של מפת הבסיס פועלת רק במפות וקטוריות.
content optional	סוג:  Node optional ברירת המחדל: PinElement רכיב ה-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 אם הוא לא צוין ב-constructor. הערה: 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

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

המחלקה הזו מרחיבה את Event.

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

הכיתה PinElement

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

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

המחלקה הזו מרחיבה את 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.
glyphColor	סוג:  string optional PinElementOptions.glyphColor.
glyphSrc	סוג:  URL|string optional PinElementOptions.glyphSrc.
glyphText	סוג:  string optional PinElementOptions.glyphText.
scale	סוג:  number optional PinElementOptions.scale.
element	הוצא משימוש: צריך להשתמש ישירות ב-PinElement. סוג:  HTMLElement השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמגבה את התצוגה.
glyph	הוצא משימוש: במקומו צריך להשתמש ב-PinElementOptions.glyphText או ב-PinElementOptions.glyphSrc. סוג:  string|Element|URL optional PinElementOptions.glyph.

Methods
addEventListener	addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת תלויית אותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent ‫options:  boolean|AddEventListenerOptions optional לאפשרויות. אירועים בהתאמה אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדירה פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. אפשר לעיין במאמר בנושא addEventListener.
removeEventListener	removeEventListener(type, listener[, options]) פרמטרים:  type:  string מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener. ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. ‫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	הוצא משימוש: במקומו צריך להשתמש ב-PinElementOptions.glyphText או ב-PinElementOptions.glyphSrc. סוג:  string|Element|URL optional רכיב ה-DOM שמוצג בסיכה.
glyphColor optional	סוג:  string optional הצבע של הגליף. תומך בכל ערך צבע ב-CSS.
glyphSrc optional	סוג:  URL|string optional מקור התמונה של הגליף שיוצג בסיכה.
glyphText optional	סוג:  string optional הטקסט שמוצג בסיכה.
scale optional	סוג:  number optional ברירת המחדל: 1 קנה המידה של הסיכה.