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"). ראה ספריות ב-Maps JavaScript API.

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

המחלקה PinElement

google.maps.marker.PinElement סיווג

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.

שיטות
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 קנה המידה של הסיכה.