הכיתה Map3DElement
google.maps.maps3d.Map3DElement
class
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 מרכז המפה שמוצג כ-LatLngAltitude, כאשר הגובה הוא במטרים מעל פני הקרקע. שימו לב: זה לא בהכרח המיקום שבו המצלמה ממוקמת, כי השדה
range משפיע על המרחק של המצלמה ממרכז המפה. אם לא מגדירים את הפרמטר, ערך ברירת המחדל שלו הוא {lat: 0, lng: 0, altitude: 63170000} . 63,170,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:
|
Methods | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
ערך המוחזר:
void הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
ערך המוחזר:
void הסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
אירועים | |
---|---|
gmp-centerchange |
function(centerChangeEvent) ארגומנטים:
האירוע הזה מופעל כשהנכס center של Map3DElement משתנה. |
gmp-click |
function(clickEvent) ארגומנטים:
האירוע הזה מופעל כשלוחצים על הרכיב Map3DElement . |
gmp-headingchange |
function(headingChangeEvent) ארגומנטים:
האירוע הזה מופעל כשהערך של מאפיין הכיוון של Map3DElement משתנה. |
gmp-rangechange |
function(rangeChangeEvent) ארגומנטים:
האירוע הזה מופעל כשיש שינוי במאפיין הטווח של Map3DElement. |
gmp-rollchange |
function(rollChangeEvent) ארגומנטים:
האירוע הזה מופעל כשהמאפיין roll של 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
class
האירוע הזה נוצר במסגרת מעקב אחרי מצב יציב של Map3DElement
. האירוע הזה עולה מעלה דרך עץ ה-DOM.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
מאפיינים | |
---|---|
isSteady |
סוג:
boolean מציין אם ה-Map3DElement יציב (כלומר, כל העיבוד הגרפי של הסצנה הנוכחית הושלם) או לא. |
הכיתה ClickEvent
google.maps.maps3d.ClickEvent
class
האירוע הזה נוצר מהקלקה על Map3DElement.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {ClickEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
מאפיינים | |
---|---|
position |
סוג:
LatLngAltitude optional קו הרוחב/קו האורך/הגובה שהיו מתחת לסמן כשהאירוע התרחש. חשוב לזכור שברמות רחבות יותר, הנתונים שיוחזרו יהיו פחות מדויקים. כמו כן, ייתכן שהמערכת תחזיר את הגובה של קרקעית הים כערך הגובה כשמקישים על פני המים ממיקומי מצלמה גבוהים יותר. האירוע הזה עולה מעלה דרך עץ ה-DOM. |
הכיתה CenterChangeEvent
google.maps.maps3d.CenterChangeEvent
class
האירוע הזה נוצר כתוצאה משינוי במרכז המעקב בתאריך Map3DElement
. האירוע הזה עולה מעלה דרך עץ ה-DOM.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {CenterChangeEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
הכיתה HeadingChangeEvent
google.maps.maps3d.HeadingChangeEvent
class
האירוע הזה נוצר מהמעקב אחרי שינוי הכותרת ב-Map3DElement
. האירוע הזה עולה מעלה דרך עץ ה-DOM.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
הכיתה RangeChangeEvent
google.maps.maps3d.RangeChangeEvent
class
האירוע הזה נוצר כתוצאה משינוי בטווח המעקב ב-Map3DElement
. האירוע הזה עולה מעלה דרך עץ ה-DOM.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {RangeChangeEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
הכיתה RollChangeEvent
google.maps.maps3d.RollChangeEvent
class
האירוע הזה נוצר כתוצאה משינוי בקבוצת המעקב בתאריך Map3DElement
. האירוע הזה עולה מעלה דרך עץ ה-DOM.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {RollChangeEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
הכיתה TiltChangeEvent
google.maps.maps3d.TiltChangeEvent
class
האירוע הזה נוצר מהמעקב אחרי שינוי השיפוע ב-Map3DElement
. האירוע הזה עולה מעלה דרך עץ ה-DOM.
הכיתה הזו היא תת-מחלקה של Event
.
אפשר לגשת אליו באמצעות חיוג למספר const {TiltChangeEvent} = await google.maps.importLibrary("maps3d")
. ספריות ב-Maps JavaScript API
הכיתה Polyline3DElement
google.maps.maps3d.Polyline3DElement
class
קו פוליגון תלת-ממדי הוא שכבת-על לינארית של קטעי קו מחוברים במפה תלת-ממדית.
רכיב מותאם אישית:
<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 הרצף המסודר של הקואורדינטות של הקו הפוליגוני. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי. |
drawsOccludedSegments |
סוג:
boolean optional ברירת מחדל:
false מציין אם חלקים של קו הפוליגון שעשויים להיות מוסתרים מצוירים או לא. גיאומטריה של מפה (למשל, מבנים) עשויה להסתיר קווים פוליגונים.
מאפיין HTML:
|
extruded |
סוג:
boolean optional ברירת מחדל:
false מציין אם יש לחבר את קו הפוליגון לקרקע. כדי להדגים קו פוליגוני, הערך של
altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE .מאפיין HTML:
|
geodesic |
סוג:
boolean optional ברירת מחדל:
false כשהערך של
true הוא 1, הקצוות של קו הפוליגון מפורשים כקווים גיאודזיים ויימשכו לפי עקומת כדור הארץ. כשהערך של false הוא 1, הקצוות של קו הפוליגון מוצגים כקווים ישרים במרחב המסך.מאפיין 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:
|
Methods | |
---|---|
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
class
מצולע תלת-ממדי (כמו קו פוליגוני תלת-ממדי) מגדיר סדרה של קואורדינטות מחוברות בסדר מסודר. בנוסף, פוליגונים יוצרים לולאה סגורה ומגדירים אזור מלא.
רכיב מותאם אישית:
<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 הוא 1, הקצוות של הפוליגון מפורשים כגיאודזיים ויימשכו לפי עקומת כדור הארץ. כשהערך של false הוא 1, הקצוות של הפוליגון מוצגים כקווים ישרים במרחב המסך.מאפיין 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:
|
Methods | |
---|---|
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 |
מאפשר להציג אובייקטים ביחס לגובה הגבוה ביותר של הקרקע, הבניין או פני המים. כשהמצלמה מעל מים, זה יהיה פני המים. כשהמצלמה מעל פני השטח, זה יהיה פני המבנה (אם יש מבנה) או פני הקרקע (אם אין מבנים). |