הכיתה Map3DElement
google.maps.maps3d.Map3DElement
class
Map3DElement הוא ממשק HTML לתצוגת המפה בתלת-מימד.
רכיב מותאם אישית:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-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:
|
defaultUIDisabled |
סוג:
boolean optionalברירת מחדל:
falseכשהערך של
true הוא 1, כל לחצני ברירת המחדל בממשק המשתמש מושבתים. לא משבית את אמצעי הבקרה של המקלדת והתנועות.מאפיין 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(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
flyCameraAround |
flyCameraAround(options)פרמטרים:
ערך המוחזר: None
בשיטה הזו, המצלמה מסתובבת סביב מיקום נתון למשך פרק זמן נתון, ומבצעת את מספר הסיבובים הנתון באותו פרק זמן. כברירת מחדל, המצלמה מסתובבת בכיוון השעון. אם מציינים מספר שלילי עבור הקפות, המצלמה תנוע במקום זאת במסלול סביב האובייקט בכיוון השעון. השיטה היא אסינכררונית כי אנימציות יכולות להתחיל לפעול רק אחרי שהמפה נטענת במידה מינימלית. השיטה מחזירה תשובה אחרי שהאנימציה מתחילה. אם מספר הסיבובים הוא אפס, לא יתבצע סיבוב והאנימציה תסתיים מיד אחרי שהיא תתחיל. |
flyCameraTo |
flyCameraTo(options)פרמטרים:
ערך המוחזר: None
בשיטה הזו, המצלמה זזה באופן פרבולי מהמיקום הנוכחי למיקום סופי נתון לאורך פרק זמן נתון. השיטה היא אסינכררונית כי אנימציות יכולות להתחיל לפעול רק אחרי שהמפה נטענת במידה מינימלית. השיטה מחזירה תשובה אחרי שהאנימציה מתחילה. |
|
removeEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
stopCameraAnimation |
stopCameraAnimation()פרמטרים: ללא
ערך המוחזר: None
השיטה הזו מפסיקה כל אנימציית טיסה שפועלת. המצלמה נשארת במקום שבו היא נמצאת באמצע האנימציה, היא לא מופיעה באופן מיידי בנקודת הסיום. השיטה אסינכרונית כי אפשר להפעיל או להפסיק אנימציות רק אחרי שהמפה נטענת במידה מינימלית. השיטה מחזירה תשובה אחרי שהאנימציה נעצרת. |
אירועים | |
|---|---|
gmp-animationend |
function(animationEndEvent)ארגומנטים:
האירוע הזה מופעל כשאנימציית הטיסה מסתיימת. האירוע הזה עולה מעלה דרך עץ ה-DOM. |
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 |
defaultUIDisabled 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 |
ממשק FlyAroundAnimationOptions
ממשק google.maps.maps3d.FlyAroundAnimationOptions
אפשרויות התאמה אישית של אנימציית FlyCameraAround.
מאפיינים | |
|---|---|
camera |
סוג:
CameraOptionsהנקודה המרכזית שבה המצלמה צריכה להתמקד במהלך אנימציית האורביטה. חשוב לזכור שהכותרת של המפה תשתנה כשהמצלמה תסתובב סביב נקודת המרכז הזו. |
durationMillis optional |
סוג:
number optionalמשך האנימציה באלפיות שנייה. זהו משך הזמן הכולל של האנימציה, ולא משך הזמן של סיבוב יחיד. |
rounds optional |
סוג:
number optionalמספר הסיבובים סביב המרכז במהלך משך הזמן שצוין. זה קובע את מהירות הסיבוב הכוללת. העברת מספר שלילי ל-rounds תגרום לסיבוב המצלמה בכיוון נגד כיוון השעון במקום בכיוון ברירת המחדל, בכיוון השעון. |
הממשק FlyToAnimationOptions
ממשק google.maps.maps3d.FlyToAnimationOptions
אפשרויות התאמה אישית של אנימציית FlyCameraTo.
מאפיינים | |
|---|---|
endCamera |
סוג:
CameraOptionsהמיקום שאליו המצלמה צריכה להצביע בסוף האנימציה. |
durationMillis optional |
סוג:
number optionalמשך האנימציה באלפיות שנייה. משך זמן של 0 יעביר את המצלמה ישירות למיקום הסיום. |
הממשק CameraOptions
ממשק google.maps.maps3d.CameraOptions
אובייקט CameraOptions שמשמש להגדרת המאפיינים שאפשר להגדיר באובייקט מצלמה. אובייקט המצלמה יכול להיות כל דבר שיש לו מיקום מצלמה, למשל מצב מפה נוכחי או מצב אנימציה עתידי שנבקש.
מאפיינים | |
|---|---|
center optional |
סוג:
LatLngAltitude|LatLngAltitudeLiteral optional |
heading 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 יציב (כלומר, כל העיבוד הגרפי של הסצנה הנוכחית הושלם) או לא. |
הכיתה LocationClickEvent
google.maps.maps3d.LocationClickEvent
class
האירוע הזה נוצר מהקלקה על Map3DElement.
הכיתה הזו היא תת-מחלקה של Event.
אפשר לגשת אליו באמצעות חיוג למספר const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
מאפיינים | |
|---|---|
position |
סוג:
LatLngAltitude optionalקו הרוחב/קו האורך/הגובה שהיו מתחת לסמן כשהאירוע התרחש. חשוב לזכור שברמות רחבות יותר, הנתונים שיוחזרו יהיו פחות מדויקים. כמו כן, ייתכן שהמערכת תחזיר את הגובה של קרקעית הים כערך הגובה כשמקישים על פני המים ממיקומי מצלמה גבוהים יותר. האירוע הזה עולה מעלה דרך עץ ה-DOM. |
הכיתה PlaceClickEvent
google.maps.maps3d.PlaceClickEvent
class
האירוע הזה נוצר מהקלקה על Map3DElement.
הכיתה הזו היא תת-מחלקה של LocationClickEvent.
אפשר לגשת אליו באמצעות חיוג למספר const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
מאפיינים | |
|---|---|
placeId |
סוג:
stringמזהה המקום של התכונה במפה. |
עבר בירושה:
position
| |
Methods | |
|---|---|
fetchPlace |
fetchPlace()פרמטרים: ללא
אחזור של Place למזהה המקום הזה. באובייקט Place שנוצר, מאפיין המזהה יאוכלס. לאחר מכן תוכלו לבקש שדות נוספים דרך Place.fetchFields(), בכפוף להפעלה ולחיוב הרגילים של Places API. ההתחייבות נדחית אם הייתה שגיאה באחזור ה-Place. |
הכיתה Marker3DElement
google.maps.maps3d.Marker3DElement
class
הצגת מיקום במפה תלת-ממדית. הערה: כדי ש-Marker3DElement יוצג, צריך להגדיר את position.
רכיב מותאם אישית:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>
הכיתה הזו היא תת-מחלקה של HTMLElement.
המחלקה הזו מטמיעה את Marker3DElementOptions.
אפשר לגשת אליו באמצעות חיוג למספר const {Marker3DElement} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
יצרן | |
|---|---|
Marker3DElement |
Marker3DElement([options])פרמטרים:
יצירת Marker3DElement עם האפשרויות שצוינו. |
מאפיינים | |
|---|---|
altitudeMode |
סוג:
AltitudeMode optionalברירת מחדל:
AltitudeMode.CLAMP_TO_GROUNDמציין את אופן הפרשנות של רכיב הגובה במיקום.
מאפיין HTML:
|
collisionBehavior |
סוג:
CollisionBehavior optionalברירת מחדל:
CollisionBehavior.REQUIREDספירה שמציינת איך Marker3DElement צריך להתנהג כשהוא מתנגש ב-Marker3DElement אחר או בתוויות של מפת הבסיס.
מאפיין HTML:
|
drawsWhenOccluded |
סוג:
boolean optionalברירת מחדל:
falseקובע אם הסמן הזה יופיע או לא כשהוא חסום. ייתכן שהסימון יוסתר על ידי רכיבי המפה (למשל, בניינים).
מאפיין HTML:
|
extruded |
סוג:
boolean optionalברירת מחדל:
falseקובע אם לחבר את הסמן לקרקע. כדי להדגים סמן, הערך של
altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.מאפיין HTML:
|
label |
סוג:
string optionalהטקסט שיוצג לצד הסמן הזה.
מאפיין HTML:
|
position |
סוג:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalהמיקום של קצה הסמן. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי. |
sizePreserved |
סוג:
boolean optionalברירת מחדל:
falseהשדה מציין אם הסמן הזה ישמור על הגודל שלו או לא, ללא קשר למרחק מהמצלמה. כברירת מחדל, הסמן מותאם לפי המרחק מהמצלמה או לפי ההטיה.
מאפיין HTML:
|
zIndex |
סוג:
number optionalהערך של zIndex בהשוואה לסימנים אחרים.
מאפיין HTML:
|
מכונות מזל | |
|---|---|
default |
כל רכיב מותאם אישית שנוסף ישירות ל- Marker3DElement יוקצה, אבל רק רכיבים מסוגים HTMLImageElement, SVGElement ו-PinElement ישמשו לסימון סמנים, רכיבים אחרים יימחקו. צריך לעטוף את HTMLImageElement ו-SVGElement באלמנט <template> לפני שמקצים אותם למיקום ברירת המחדל של Marker3DElement. תמונות וקבצי SVG עוברים רסטר כרגע לפני שהם עוברים עיבוד בסצנה התלת-ממדית, כך שקוד HTML מותאם אישית שמוטמע בקטגוריות SVG או CSS שנוספו לתמונות לא יחול, וייתכן שהוא לא יופיע כשהסמנים יוצגו במסך. |
Methods | |
|---|---|
|
addEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
|
removeEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
הממשק Marker3DElementOptions
ממשק google.maps.maps3d.Marker3DElementOptions
אובייקט Marker3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Marker3DElement.
מאפיינים | |
|---|---|
altitudeMode optional |
סוג:
AltitudeMode optional |
collisionBehavior optional |
סוג:
CollisionBehavior optional |
drawsWhenOccluded optional |
סוג:
boolean optional |
extruded optional |
סוג:
boolean optional |
label optional |
סוג:
string optional |
position optional |
סוג:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
sizePreserved optional |
סוג:
boolean optional |
zIndex optional |
סוג:
number optional |
הכיתה Marker3DInteractiveElement
google.maps.maps3d.Marker3DInteractiveElement
class
הצגת מיקום במפה תלת-ממדית. הערה: כדי ש-Marker3DInteractiveElement יוצג, צריך להגדיר את position. בניגוד ל-Marker3DElement, Marker3DInteractiveElement מקבל אירוע gmp-click.
רכיב מותאם אישית:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>
הכיתה הזו היא תת-מחלקה של Marker3DElement.
המחלקה הזו מטמיעה את Marker3DInteractiveElementOptions.
אפשר לגשת אליו באמצעות חיוג למספר const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
יצרן | |
|---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options])פרמטרים:
יצירת Marker3DInteractiveElement עם האפשרויות שצוינו. |
מאפיינים | |
|---|---|
עובר בירושה:
altitudeMode,
collisionBehavior,
drawsWhenOccluded,
extruded,
label,
position,
sizePreserved,
zIndex
|
מכונות מזל | |
|---|---|
default |
כל רכיב מותאם אישית שנוסף ישירות ל- Marker3DInteractiveElement יוקצה, אבל רק רכיבים מסוג PinElement ישמשו לציור סמנים, רכיבים אחרים יי игнорו. |
Methods | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
removeEventListener |
removeEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
אירועים | |
|---|---|
gmp-click |
function(clickEvent)ארגומנטים:
האירוע הזה מופעל כשלוחצים על הרכיב Marker3DInteractiveElement. |
הממשק Marker3DInteractiveElementOptions
ממשק google.maps.maps3d.Marker3DInteractiveElementOptions
אובייקט Marker3DInteractiveElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Marker3DInteractiveElement.
הממשק הזה הוא תוספת ל-Marker3DElementOptions.
מאפיינים | |
|---|---|
עובר בירושה:
altitudeMode,
collisionBehavior,
drawsWhenOccluded,
extruded,
label,
position,
sizePreserved,
zIndex
|
הכיתה Model3DElement
google.maps.maps3d.Model3DElement
class
מודל תלת-ממדי שמאפשר עיבוד של מודלים בפורמט gLTF. הערה: כדי ש-Model3DElement יוצג, צריך להגדיר את position ואת src.
צריכה להיות תמיכה במאפיינים המרכזיים של gLTF PBR. בשלב הזה אין תמיכה בתוספים או בנכסי תוספים.
רכיב מותאם אישית:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>
הכיתה הזו היא תת-מחלקה של HTMLElement.
המחלקה הזו מטמיעה את Model3DElementOptions.
אפשר לגשת אליו באמצעות חיוג למספר const {Model3DElement} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
יצרן | |
|---|---|
Model3DElement |
Model3DElement([options])פרמטרים:
יצירת Model3DElement עם האפשרויות שצוינו. |
מאפיינים | |
|---|---|
altitudeMode |
סוג:
AltitudeMode optionalברירת מחדל:
AltitudeMode.CLAMP_TO_GROUNDמציין איך מתפרש הגובה במיקום.
מאפיין HTML:
|
orientation |
סוג:
Orientation3D|Orientation3DLiteral optionalתיאור של סיבוב של מערכת הקואורדינטות של מודל תלת-ממדי כדי למקם את המודל במפה התלת-ממדית. הפיכות חלות על המודל לפי הסדר הבא: רוטציה, הטיה ואז כיוון. |
position |
סוג:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalמגדיר את המיקום של Model3DElement. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי. |
scale |
סוג:
number|Vector3D|Vector3DLiteral optionalברירת מחדל:
1שינוי הגודל של המודל לאורך הצירים x, y ו-z במרחב הקואורדינטות של המודל. |
src |
סוג:
string|URL optionalכתובת ה-URL של המודל התלת-ממדי. בשלב זה יש תמיכה רק במודלים בפורמט
.glb. כל כתובות ה-URL היחסיות מסוג HTTP ימולאו לכתובות ה-URL המוחלטות התואמות. לתשומת ליבכם: אם אתם מארחים את קובצי המודל של .glb באתר או בשרת שונים מאלה של האפליקציה הראשית, חשוב להגדיר את כותרות ה-HTTP הנכונות של CORS. כך האפליקציה תוכל לגשת באופן מאובטח לקובצי המודל מהדומיין השני.מאפיין HTML:
|
Methods | |
|---|---|
|
addEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
|
removeEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
ממשק Model3DElementOptions
ממשק google.maps.maps3d.Model3DElementOptions
אובייקט Model3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Model3DElement.
מאפיינים | |
|---|---|
altitudeMode optional |
סוג:
AltitudeMode optional |
orientation optional |
סוג:
Orientation3D|Orientation3DLiteral optional |
position optional |
סוג:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
scale optional |
סוג:
number|Vector3D|Vector3DLiteral optional |
src optional |
סוג:
string|URL optional |
הכיתה Polyline3DElement
google.maps.maps3d.Polyline3DElement
class
קו פוליגון תלת-ממדי הוא שכבת-על לינארית של קטעי קו מחוברים במפה תלת-ממדית.
רכיב מותאם אישית:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>
הכיתה הזו היא תת-מחלקה של HTMLElement.
המחלקה הזו מטמיעה את Polyline3DElementOptions.
אפשר לגשת אליו באמצעות חיוג למספר const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
יצרן | |
|---|---|
Polyline3DElement |
Polyline3DElement([options])פרמטרים:
יצירת Polyline3DElement עם האפשרויות שצוינו. |
מאפיינים | |
|---|---|
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:
|
outerWidth |
סוג:
number optionalהרוחב החיצוני הוא בין
0.0 ל-1.0. זהו אחוז מתוך strokeWidth.מאפיין HTML:
|
strokeColor |
סוג:
string optionalצבע הקו. יש תמיכה בכל הצבעים של CSS3.
מאפיין HTML:
|
strokeWidth |
סוג:
number optionalעובי הקו בפיקסלים.
מאפיין HTML:
|
zIndex |
סוג:
number optionalהערך של zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML:
|
Methods | |
|---|---|
|
addEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
|
removeEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
הממשק Polyline3DElementOptions
ממשק google.maps.maps3d.Polyline3DElementOptions
אובייקט Polyline3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Polyline3DElement.
מאפיינים | |
|---|---|
altitudeMode optional |
סוג:
AltitudeMode optional |
coordinates optional |
סוג:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
drawsOccludedSegments optional |
סוג:
boolean optional |
extruded optional |
סוג:
boolean optional |
geodesic optional |
סוג:
boolean optional |
outerColor optional |
סוג:
string optional |
outerWidth optional |
סוג:
number optional |
strokeColor optional |
סוג:
string 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" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>
הכיתה הזו היא תת-מחלקה של HTMLElement.
המחלקה הזו מטמיעה את Polygon3DElementOptions.
אפשר לגשת אליו באמצעות חיוג למספר const {Polygon3DElement} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
יצרן | |
|---|---|
Polygon3DElement |
Polygon3DElement([options])פרמטרים:
יצירת Polygon3DElement עם האפשרויות שצוינו. |
מאפיינים | |
|---|---|
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:
|
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:
|
strokeWidth |
סוג:
number optionalעובי הקו בפיקסלים.
מאפיין HTML:
|
zIndex |
סוג:
number optionalהערך של zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML:
|
Methods | |
|---|---|
|
addEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
|
removeEventListener(type, listener[, options])פרמטרים:
ערך המוחזר:
voidהסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener |
הממשק Polygon3DElementOptions
ממשק google.maps.maps3d.Polygon3DElementOptions
אובייקט Polygon3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Polygon3DElement.
מאפיינים | |
|---|---|
altitudeMode optional |
סוג:
AltitudeMode optional |
drawsOccludedSegments optional |
סוג:
boolean optional |
extruded optional |
סוג:
boolean optional |
fillColor optional |
סוג:
string optional |
geodesic optional |
סוג:
boolean optional |
innerCoordinates optional |
סוג:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional |
outerCoordinates optional |
סוג:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
strokeColor optional |
סוג:
string 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 |
מאפשר להציג אובייקטים ביחס לגובה הגבוה ביותר של הקרקע, הבניין או פני המים. כשהמצלמה מעל מים, זה יהיה פני המים. כשהמצלמה מעל פני השטח, זה יהיה פני המבנה (אם יש מבנה) או פני הקרקע (אם אין מבנים). |