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 מרכז המפה נתון בתור LatLngגובה, שבו הגובה הוא במטרים מעל פני הקרקע. חשוב לשים לב שלא מדובר בהכרח במיקום שבו המצלמה ממוקמת, מכיוון שהשדה
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(type, listener[, options]) פרמטרים:
ערך החזרה:
void הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יגיע ליעד. ראו addEventListener |
|
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
. האירוע יופיע בבועות דרך עץ ה-DOM.
הקורס הזה נמשך
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 קו הרוחב/קו האורך/הגובה שהיו מתחת לסמן כשהאירוע התרחש. חשוב לדעת: ברמות גסות יותר, יוחזרו נתונים פחות מדויקים. בנוסף, ניתן להחזיר את גובה קרקעית הים לערך הגובה בעת לחיצה על פני המים ממיקומים גבוהים יותר של המצלמה. האירוע יופיע בבועות דרך עץ ה-DOM. |
CenterChangeEvent כיתה
google.maps.maps3d.CenterChangeEvent
כיתה
האירוע הזה נוצר בעקבות שינוי במרכז המעקב בתאריך Map3DElement
. האירוע יופיע בבועות דרך עץ ה-DOM.
הקורס הזה נמשך
Event
קבלת גישה באמצעות חיוג אל const {CenterChangeEvent} = await google.maps.importLibrary("maps3d")
. מידע נוסף זמין בקטע ספריות ב-Maps JavaScript API.
HeadingChangeEvent כיתה
google.maps.maps3d.HeadingChangeEvent
כיתה
האירוע הזה נוצר ממעקב אחרי שינוי הכותרת בתאריך Map3DElement
. האירוע יופיע בבועות דרך עץ ה-DOM.
הקורס הזה נמשך
Event
קבלת גישה באמצעות חיוג אל const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d")
. מידע נוסף זמין בקטע ספריות ב-Maps JavaScript API.
RangeChangeEvent כיתה
google.maps.maps3d.RangeChangeEvent
כיתה
האירוע הזה נוצר בעקבות שינוי בטווח המעקב בתאריך Map3DElement
. האירוע יופיע בבועות דרך עץ ה-DOM.
הקורס הזה נמשך
Event
קבלת גישה באמצעות חיוג אל const {RangeChangeEvent} = await google.maps.importLibrary("maps3d")
. מידע נוסף זמין בקטע ספריות ב-Maps JavaScript API.
RollChangeEvent כיתה
google.maps.maps3d.RollChangeEvent
כיתה
האירוע הזה נוצר בעקבות שינוי ברשימת המעקב בתאריך Map3DElement
. האירוע יופיע בבועות דרך עץ ה-DOM.
הקורס הזה נמשך
Event
קבלת גישה באמצעות חיוג אל const {RollChangeEvent} = await google.maps.importLibrary("maps3d")
. מידע נוסף זמין בקטע ספריות ב-Maps JavaScript API.
TiltChangeEvent כיתה
google.maps.maps3d.TiltChangeEvent
כיתה
האירוע הזה נוצר ממעקב אחרי השינוי בהטיה בתאריך Map3DElement
. האירוע יופיע בבועות דרך עץ ה-DOM.
הקורס הזה נמשך
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 הרצף הסדור של הקואורדינטות של קו הפוליגוני. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן היא אופציונלית. |
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(type, listener[, options]) פרמטרים:
ערך החזרה:
void הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יגיע ליעד. ראו addEventListener |
|
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(type, listener[, options]) פרמטרים:
ערך החזרה:
void הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יגיע ליעד. ראו addEventListener |
|
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 |
מאפשר לבטא אובייקטים ביחס למיקום הגבוה ביותר של פני הקרקע+בניין+המים. מתחת למים, זה יהיה פני המים. כשמעלים את פני השטח, השטח יהיה שטח הבניין (אם קיים) או פני הקרקע (אם אין מבנים). |