המחלקה Map3DElement
google.maps.maps3d.Map3DElement
סיווג
Map3DElement הוא ממשק HTML לתצוגת מפה תלת-ממדית.
רכיב מותאם אישית:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>
הכיתה הזו משתרעת על פני
HTMLElement
.
במחלקה הזו מוטמעת Map3DElementOptions
.
ניתן לגשת באמצעות חיוג אל const {Map3DElement} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Map3DElement |
Map3DElement([options]) פרמטרים:
|
תכונות | |
---|---|
bounds |
סוג:
LatLngBounds|LatLngBoundsLiteral optional כשההגדרה מוגדרת, מגבילה את מיקום המצלמה בגבולות קווי הרוחב/אורך שצוינו. חשוב לזכור שאובייקטים שנמצאים מחוץ לתחום עדיין עוברים רינדור. אפשר להגביל גם את קווי האורך וגם את קווי הרוחב, או להגביל את קווי האורך והרוחב בלבד. בגבולות של קווי רוחב בלבד צריך להשתמש בקווי אורך מערביים ומזרחיים, -180 ו-180 , בהתאמה. בגבולות של קווי אורך בלבד צריך להשתמש בקווי הרוחב הצפוניים והדרומיים של 90 ו--90 , בהתאמה. |
center |
סוג:
LatLngAltitude|LatLngAltitudeLiteral optional מרכז המפה המוצג כקו רוחב/אורך, שבו הגובה נמצא במטרים מעל פני הקרקע. הערה: זה לא בהכרח המיקום שבו המצלמה ממוקמת, כי השדה
range משפיע על מרחק המצלמה ממרכז המפה. אם המדיניות לא מוגדרת, ברירת המחדל היא {lat: 0, lng: 0, altitude: 63170000} . הגובה המקסימלי המותר הוא 63170,000 מטר (רדיוס כדור הארץ כפול 10).מאפיין HTML:
|
defaultLabelsDisabled |
סוג:
boolean optional ברירת מחדל:
false כאשר
true , תוויות ברירת המחדל של המפה אינן מעובדים.מאפיין HTML:
|
heading |
סוג:
number optional כיוון המצפן של המפה, במעלות, כאשר הצפון הוא אפס. אם אין הטיה, כל גלגול יפורש ככותרת.
מאפיין HTML:
|
maxAltitude |
סוג:
number optional הגובה המקסימלי מעל פני הקרקע שיוצג במפה. ערך חוקי הוא בין
0 ל-63170000 מטרים (רדיוס כדור הארץ כפול 10).מאפיין HTML:
|
maxHeading |
סוג:
number optional הזווית המקסימלית לגבי הכיוון (סיבוב) של המפה. ערך חוקי הוא בין
0 ל-360 מעלות. minHeading ו-maxHeading מייצגים מרווח של <= 360 מעלות שבו מותר להשתמש בתנועות של כותרות. minHeading = 180 ו-maxHeading = 90 יאפשרו כותרות ב[0, 90] וכותרת ב[180, 360] . minHeading = 90 ו-maxHeading = 180 יאפשרו כותרות ב[90, 180] .מאפיין HTML:
|
maxTilt |
סוג:
number optional זווית הצילום המקסימלית במפה. ערך חוקי הוא בין
0 ל-90 מעלות.מאפיין HTML:
|
minAltitude |
סוג:
number optional הגובה המינימלי מעל פני הקרקע שיוצג במפה. ערך חוקי הוא בין
0 ל-63170000 מטרים (רדיוס כדור הארץ כפול 10).מאפיין HTML:
|
minHeading |
סוג:
number optional הזווית המינימלית של הכיוון (סיבוב) במפה. ערך חוקי הוא בין
0 ל-360 מעלות. minHeading ו-maxHeading מייצגים מרווח של <= 360 מעלות שבו מותר להשתמש בתנועות של כותרות. minHeading = 180 ו-maxHeading = 90 יאפשרו כותרות ב[0, 90] וכותרת ב[180, 360] . minHeading = 90 ו-maxHeading = 180 יאפשרו כותרות ב[90, 180] .מאפיין HTML:
|
minTilt |
סוג:
number optional זווית הפגיעה המינימלית במפה. ערך חוקי הוא בין
0 ל-90 מעלות.מאפיין HTML:
|
range |
סוג:
number optional המרחק מהמצלמה למרכז המפה, במטרים.
מאפיין HTML:
|
roll |
סוג:
number optional סיבוב המצלמה מסביב לווקטור התצוגה במעלות. כדי לפתור אי בהירות, כאשר אין הטיה, כל גלגול יפורש ככותרת.
מאפיין HTML:
|
tilt |
סוג:
number optional ההטיה של וקטור התצוגה של המצלמה במעלות. לווקטור תצוגה שמביט ישירות אל כדור הארץ תהיה הטיה של אפס מעלות. לווקטור של התצוגה שמצביע הרחק מכדור הארץ, תהיה הטיה של
180 מעלות.מאפיין HTML:
|
שיטות | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מגדירה פונקציה שתיקרא בכל פעם שהאירוע שצוין מועבר ליעד. ראו את addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מסיר מהיעד האזנה לאירוע שנרשם בעבר באמצעות addEventListener. ראו את removeEventListener |
אירועים | |
---|---|
gmp-centerchange |
function(centerChangeEvent) ארגומנטים:
האירוע הזה מופעל כשמשתנה מאפיין מרכז Map3DElement. |
gmp-click |
function(clickEvent) ארגומנטים:
האירוע הזה מופעל כשמשתמש לוחץ על הרכיב Map3DElement . |
gmp-headingchange |
function(headingChangeEvent) ארגומנטים:
האירוע הזה מופעל כשתכונת הכותרת של Map3DElement משתנה. |
gmp-rangechange |
function(rangeChangeEvent) ארגומנטים:
האירוע הזה מופעל כשמאפיין הטווח של Map3DElement משתנה. |
gmp-rollchange |
function(rollChangeEvent) ארגומנטים:
האירוע הזה מופעל כשנכס-העל של Map3DElement משתנה. |
gmp-steadychange |
function(steadyChangeEvent) ארגומנטים:
האירוע הזה מופעל כשהמצב היציב של Map3DElement משתנה. |
gmp-tiltchange |
function(tiltChangeEvent) ארגומנטים:
האירוע הזה מופעל כשתכונת ההטיה של Map3DElement משתנה. |
ממשק Map3DElementOptions
ממשק google.maps.maps3d.Map3DElementOptions
אובייקט Map3DElementOptions המשמש להגדרת המאפיינים שניתן להגדיר ב- Map3DElement.
תכונות | |
---|---|
bounds optional |
סוג:
LatLngBounds|LatLngBoundsLiteral optional |
center optional |
סוג:
LatLngAltitude|LatLngAltitudeLiteral optional |
defaultLabelsDisabled optional |
סוג:
boolean optional |
heading optional |
סוג:
number optional |
maxAltitude optional |
סוג:
number optional |
maxHeading optional |
סוג:
number optional |
maxTilt optional |
סוג:
number optional |
minAltitude optional |
סוג:
number optional |
minHeading optional |
סוג:
number optional |
minTilt optional |
סוג:
number optional |
range optional |
סוג:
number optional |
roll optional |
סוג:
number optional |
tilt optional |
סוג:
number optional |
מחלקה SteadyChangeEvent
google.maps.maps3d.SteadyChangeEvent
סיווג
האירוע הזה נוצר בעקבות מעקב אחר מצב יציב של Map3DElement
.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
isSteady |
סוג:
boolean מציין אם Map3DElement יציב (כלומר כל הרינדור של הסצנה הנוכחית הושלם) או לא. |
הסיווג ClickEvent
google.maps.maps3d.ClickEvent
סיווג
האירוע הזה נוצר מלחיצה על Map3DElement.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {ClickEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
position |
סוג:
LatLngAltitude optional קו הרוחב/קו האורך/הגובה שהיו מתחת לסמן כשהאירוע התרחש. שימו לב שברמות גסות יותר יוחזרו נתונים פחות מדויקים. כמו כן, ייתכן שיוחזרו גובה פני הים עבור ערך הגובה כשלוחצים על פני המים ממיקומי מצלמה גבוהים. |
המחלקה CenterChangeEvent
google.maps.maps3d.CenterChangeEvent
סיווג
האירוע הזה נוצר בעקבות שינוי במרכז המעקב בתאריך Map3DElement
.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {CenterChangeEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
המחלקה HeadingChangeEvent
google.maps.maps3d.HeadingChangeEvent
סיווג
האירוע הזה נוצר בעקבות מעקב אחר שינוי הכותרת בתאריך Map3DElement
.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
הסיווג RangeChangeEvent
google.maps.maps3d.RangeChangeEvent
סיווג
האירוע הזה נוצר בעקבות שינוי בטווח המעקב בתאריך Map3DElement
.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {RangeChangeEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
המחלקה RollChangeEvent
google.maps.maps3d.RollChangeEvent
סיווג
האירוע הזה נוצר בעקבות שינוי ברצף המעקב בתאריך Map3DElement
.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {RollChangeEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
מחלקה של TiltChangeEvent
google.maps.maps3d.TiltChangeEvent
סיווג
האירוע הזה נוצר בעקבות מעקב אחר שינוי ההטיה בתאריך Map3DElement
.
הכיתה הזו משתרעת על פני
Event
.
ניתן לגשת באמצעות חיוג אל const {TiltChangeEvent} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
המחלקה Polyline3DElement
google.maps.maps3d.Polyline3DElement
סיווג
קו פוליגוני תלת-ממדי הוא שכבת-על ליניארית של קטעי קו מחוברים במפה תלת-ממדית.
רכיב מותאם אישית:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-opacity="number" outer-width="number" stroke-color="string" stroke-opacity="number" stroke-width="number" z-index="number"></gmp-polyline-3d>
הכיתה הזו משתרעת על פני
HTMLElement
.
במחלקה הזו מוטמעת Polyline3DElementOptions
.
ניתן לגשת באמצעות חיוג אל const {Polyline3DElement} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) פרמטרים:
|
תכונות | |
---|---|
altitudeMode |
סוג:
AltitudeMode optional ברירת מחדל:
AltitudeMode.ABSOLUTE מציין את האופן שבו המערכת מפרשת רכיבי גובה בקואורדינטות.
מאפיין HTML:
|
coordinates |
סוג:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional הרצף הסדור של הקואורדינטות של ה-Polyline. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן היא אופציונלית. |
drawsOccludedSegments |
סוג:
boolean optional ברירת מחדל:
false מגדירה אם חלקים של קו הפוליגוני שאפשר לחסום משורטטים או לא. קווים פוליגוניים יכולים להיות חסומים על ידי גיאומטריה של המפה (למשל בניינים).
מאפיין HTML:
|
extruded |
סוג:
boolean optional ברירת מחדל:
false מציין אם לחבר את הקו הפוליגוני לקרקע. כדי לחלץ קו פוליגוני,
altitudeMode חייב להיות RELATIVE_TO_GROUND או ABSOLUTE .מאפיין HTML:
|
geodesic |
סוג:
boolean optional ברירת מחדל:
false כאשר
true , הקצוות של הקו הפוליגוני מתפרשים כגיאודזיים וימשיכו לעקום של כדור הארץ. כשהערך הוא false , הקצוות של הקו הפוליגוני מוצגים כקווים ישרים בשטח המסך.מאפיין HTML:
|
outerColor |
סוג:
string optional הצבע החיצוני. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים עם שם.
מאפיין HTML:
|
outerOpacity |
סוג:
number optional השקיפות החיצונית בין
0.0 ל-1.0 .מאפיין HTML:
|
outerWidth |
סוג:
number optional הרוחב החיצוני הוא בין
0.0 ל-1.0 . זהו אחוז מתוך strokeWidth .מאפיין HTML:
|
strokeColor |
סוג:
string optional צבע הקו. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים עם שם.
מאפיין HTML:
|
strokeOpacity |
סוג:
number optional שקיפות הקו בין
0.0 ל-1.0 .מאפיין HTML:
|
strokeWidth |
סוג:
number optional עובי הקו בפיקסלים.
מאפיין HTML:
|
zIndex |
סוג:
number optional את zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML:
|
שיטות | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מגדירה פונקציה שתיקרא בכל פעם שהאירוע שצוין מועבר ליעד. ראו את addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מסיר מהיעד האזנה לאירוע שנרשם בעבר באמצעות addEventListener. ראו את removeEventListener |
ממשק Polyline3DElementOptions
ממשק google.maps.maps3d.Polyline3DElementOptions
אובייקט Polyline3DElementOptions המשמש להגדרת המאפיינים שניתן להגדיר ב-Polyline3DElement.
תכונות | |
---|---|
altitudeMode optional |
סוג:
AltitudeMode optional ברירת מחדל:
AltitudeMode.ABSOLUTE |
coordinates optional |
סוג:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
drawsOccludedSegments optional |
סוג:
boolean optional ברירת מחדל:
false |
extruded optional |
סוג:
boolean optional ברירת מחדל:
false |
geodesic optional |
סוג:
boolean optional ברירת מחדל:
false |
outerColor optional |
סוג:
string optional |
outerOpacity optional |
סוג:
number optional |
outerWidth optional |
סוג:
number optional |
strokeColor optional |
סוג:
string optional |
strokeOpacity optional |
סוג:
number optional |
strokeWidth optional |
סוג:
number optional |
zIndex optional |
סוג:
number optional |
המחלקה Polygon3DElement
google.maps.maps3d.Polygon3DElement
סיווג
מצולע תלת-ממדי (כמו קו פוליגוני תלת-ממדי) מגדיר סדרה של קואורדינטות מחוברות ברצף סדור. בנוסף, פוליגונים יוצרים לולאה סגורה ומגדירים אזור מלא.
רכיב מותאם אישית:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" fill-opacity="number" geodesic stroke-color="string" stroke-opacity="number" stroke-width="number" z-index="number"></gmp-polygon-3d>
הכיתה הזו משתרעת על פני
HTMLElement
.
במחלקה הזו מוטמעת Polygon3DElementOptions
.
ניתן לגשת באמצעות חיוג אל const {Polygon3DElement} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) פרמטרים:
|
תכונות | |
---|---|
altitudeMode |
סוג:
AltitudeMode optional ברירת מחדל:
AltitudeMode.ABSOLUTE מציין את האופן שבו המערכת מפרשת רכיבי גובה בקואורדינטות.
מאפיין HTML:
|
drawsOccludedSegments |
סוג:
boolean optional ברירת מחדל:
false מציין אם משורטטים או לא חלקים בפוליגון שניתן לחסום. אפשר לחסום פוליגונים על ידי גיאומטריה של המפה (למשל, מבנים).
מאפיין HTML:
|
extruded |
סוג:
boolean optional ברירת מחדל:
false מציין אם לחבר את הפוליגון לקרקע. כדי לחלץ פוליגון, ה-
altitudeMode חייב להיות RELATIVE_TO_GROUND או ABSOLUTE .מאפיין HTML:
|
fillColor |
סוג:
string optional צבע המילוי. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים עם שם.
מאפיין HTML:
|
fillOpacity |
סוג:
number optional שקיפות המילוי בין 0.0 ל-1.0.
מאפיין HTML:
|
geodesic |
סוג:
boolean optional ברירת מחדל:
false כאשר
true , הקצוות של המצולע מפוענחים כגיאודזיים וימשיכו לצורת העקום של כדור הארץ. כשהערך הוא false , הקצוות של הפוליגון מוצגים כקווים ישרים בשטח המסך.מאפיין HTML:
|
innerCoordinates |
סוג:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional הרצף הסדור של קואורדינאטות שמגדיר לולאה סגורה. בשונה מקווים פוליגוניים, פוליגון יכול לכלול נתיב אחד או יותר, כך שיוצרים מספר מקטעים בתוך הפוליגון. |
outerCoordinates |
סוג:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional הרצף הסדור של קואורדינאטות שמגדיר לולאה סגורה. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן היא אופציונלית. |
strokeColor |
סוג:
string optional צבע הקו. כל צבעי ה-CSS3 נתמכים, מלבד צבעים מורחבים עם שם.
מאפיין HTML:
|
strokeOpacity |
סוג:
number optional שקיפות הקו בין
0.0 ל-1.0 .מאפיין HTML:
|
strokeWidth |
סוג:
number optional עובי הקו בפיקסלים.
מאפיין HTML:
|
zIndex |
סוג:
number optional את zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML:
|
שיטות | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מגדירה פונקציה שתיקרא בכל פעם שהאירוע שצוין מועבר ליעד. ראו את addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
הערך המוחזר:
void מסיר מהיעד האזנה לאירוע שנרשם בעבר באמצעות addEventListener. ראו את removeEventListener |
ממשק Polygon3DElementOptions
ממשק google.maps.maps3d.Polygon3DElementOptions
אובייקט Polygon3DElementOptions המשמש להגדרת המאפיינים שניתן להגדיר ב-Polygon3DElement.
תכונות | |
---|---|
altitudeMode optional |
סוג:
AltitudeMode optional ברירת מחדל:
AltitudeMode.ABSOLUTE |
drawsOccludedSegments optional |
סוג:
boolean optional ברירת מחדל:
false |
extruded optional |
סוג:
boolean optional ברירת מחדל:
false |
fillColor optional |
סוג:
string optional |
fillOpacity optional |
סוג:
number optional |
geodesic optional |
סוג:
boolean optional ברירת מחדל:
false |
innerCoordinates optional |
סוג:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional |
outerCoordinates optional |
סוג:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
strokeColor optional |
סוג:
string optional |
strokeOpacity optional |
סוג:
number optional |
strokeWidth optional |
סוג:
number optional |
zIndex optional |
סוג:
number optional |
קבועים של AltitudeMode
google.maps.maps3d.AltitudeMode
קבועים
מציין את האופן שבו המערכת מפרשת רכיבי גובה בקואורדינטות.
ניתן לגשת באמצעות חיוג אל const {AltitudeMode} = await google.maps.importLibrary("maps3d")
. ראה ספריות ב-Maps JavaScript API.
קבועים | |
---|---|
ABSOLUTE |
מאפשר לבטא אובייקטים ביחס לגובה הממוצע הממוצע של הים. כלומר, אם רמת הפירוט של פני השטח משתנה מתחת לאובייקט, המיקום המוחלט שלו יישאר ללא שינוי. |
CLAMP_TO_GROUND |
מאפשר לבטא אובייקטים שממוקמים על הקרקע. הם יישארו בגובה פני הקרקע מתחת לפני השטח, ללא קשר לגובה שסופק. אם העצם מוצב על מאגר מים גדול, הוא ימוקם בגובה פני הים. |
RELATIVE_TO_GROUND |
מאפשר לבטא אובייקטים ביחס לפני הקרקע. אם רמת הפירוט של פני השטח משתנה, מיקומו של האובייקט יישאר קבוע ביחס לקרקע. כשמעל המים, הגובה יפורש כערך במטרים מעל פני הים. |
RELATIVE_TO_MESH |
מאפשרת לבטא אובייקטים ביחס לגובה הגבוה ביותר של פני השטח, בניין + קרקע. כאשר מעל המים, אלה יהיו פני המים. כאשר מעל פני השטח, אלה יהיו פני השטח של הבניין (אם קיים) או פני הקרקע (אם אין מבנים). |