המחלקה 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]) פרמטרים:
הפונקציה יוצרת AdvancedMarkerElement עם האפשרויות שצוינו. אם תציינו מפה, AdvancedMarkerElement יתווסף למפה בזמן הבנייה. |
תכונות | |
---|---|
collisionBehavior |
סוג:
CollisionBehavior optional |
content |
סוג:
Node optional |
element |
סוג:
HTMLElement השדה הזה הוא לקריאה בלבד. רכיב DOM שמגבה את התצוגה. |
gmpDraggable |
סוג:
boolean optional |
map |
סוג:
Map optional |
position |
סוג:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional מאפיין HTML:
|
title |
סוג:
string מאפיין HTML:
|
zIndex |
סוג:
number optional |
שיטות | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מגדירה פונקציה שתיקרא בכל פעם שהאירוע שצוין מועבר ליעד. ראו את addEventListener |
addListener |
addListener(eventName, handler) פרמטרים:
ערך החזרה:
MapsEventListener האזנה לאירוע שמתקבל.מוסיף את פונקציית ה-listener הנתונה לשם האירוע הנתון במערכת האירועים של מפות Google. |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מסיר מהיעד האזנה לאירוע שנרשם בעבר באמצעות addEventListener. ראו את removeEventListener |
אירועים | |
---|---|
click |
function(event) ארגומנטים:
האירוע הזה מופעל כשמשתמש לוחץ על הרכיב AdvancedMarkerElement .לא זמין עם addEventListener() (יש להשתמש במקום זאת ב-gmp-click ). |
drag |
function(event) ארגומנטים:
האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את AdvancedMarkerElement .לא זמין עם addEventListener() . |
dragend |
function(event) ארגומנטים:
|
dragstart |
function(event) ארגומנטים:
|
gmp-click |
function(event) ארגומנטים:
האירוע הזה מופעל כשמשתמש לוחץ על הרכיב AdvancedMarkerElement . השימוש הטוב ביותר הוא עם addEventListener() (במקום עם addListener() ). |
ממשק AdvancedMarkerElementOptions
ממשק google.maps.marker.AdvancedMarkerElementOptions
אפשרויות ליצירה של AdvancedMarkerElement
.
תכונות | |
---|---|
collisionBehavior optional |
סוג:
CollisionBehavior optional ספירה שמציינת איך AdvancedMarkerElement צריך להתנהג כשהוא מתנגש עם AdvancedMarkerElement אחר או עם תוויות הבסיס של המפה וקטורית. הערה: |
content optional |
סוג:
Node optional ברירת מחדל:
PinElement.element רכיב ה-DOM שמגבה את הרכיבים החזותיים של AdvancedMarkerElement . הערה: |
gmpDraggable optional |
סוג:
boolean optional ברירת מחדל:
false אם הערך true , ניתן לגרור את AdvancedMarkerElement . הערה: לא ניתן לגרור |
map optional |
סוג:
Map optional המפה שבה יוצג AdvancedMarkerElement . נדרשת מפה כדי להציג את AdvancedMarkerElement . ניתן לספק אותה על ידי הגדרה של AdvancedMarkerElement.map אם היא לא סופקה בזמן הבנייה. |
position optional |
סוג:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional קביעת המיקום של AdvancedMarkerElement . AdvancedMarkerElement יכול להיווצר ללא מיקום, אבל הוא לא יוצג עד שהמיקום שלו יסופק - לדוגמה, בהתאם לפעולות או לבחירות של המשתמש. אפשר לציין את המיקום של AdvancedMarkerElement על ידי הגדרת הערך AdvancedMarkerElement.position אם הוא לא סופק בזמן הבנייה. הערה: הפרמטר |
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
. הגליף הוא רכיב DOM אופציונלי שמוצג בצורה של בלון. יחס הגובה-רוחב של PinElement
עשוי להיות שונה בהתאם ל-PinElement.scale
שלו.
הערה: עדיין אין תמיכה בשימוש כרכיב אינטרנט (למשל שימוש כסיווג משנה של HTMLElement או דרך HTML).
הכיתה הזו משתרעת על פני
HTMLElement
.
במחלקה הזו מוטמעת PinElementOptions
.
ניתן לגשת באמצעות חיוג אל const {PinElement} = await google.maps.importLibrary("marker")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
PinElement |
PinElement([options]) פרמטרים:
|
תכונות | |
---|---|
background |
סוג:
string optional |
borderColor |
סוג:
string optional |
element |
סוג:
HTMLElement השדה הזה הוא לקריאה בלבד. רכיב DOM שמגבה את התצוגה. |
glyph |
|
glyphColor |
סוג:
string optional |
scale |
סוג:
number optional |
שיטות | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void הפונקציה הזו עדיין לא זמינה לשימוש. |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מסיר מהיעד האזנה לאירוע שנרשם בעבר באמצעות addEventListener. ראו את removeEventListener |
ממשק PinElementOptions
ממשק google.maps.marker.PinElementOptions
אפשרויות ליצירת PinElement
.
תכונות | |
---|---|
background optional |
סוג:
string optional צבע הרקע של צורת הסיכה. תומך בכל ערך צבע של CSS. |
borderColor optional |
סוג:
string optional צבע הגבול של צורת הסיכה. תומך בכל ערך צבע של CSS. |
glyph optional |
רכיב ה-DOM שמוצג בסיכה. |
glyphColor optional |
סוג:
string optional צבע הגליף. תומך בכל ערך צבע של CSS. |
scale optional |
סוג:
number optional ברירת מחדל:
1 קנה המידה של הסיכה. |