3D Maps

‫Map3DElement class

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
אם ההגדרה הזו מופעלת, המיקום של המצלמה מוגבל לגבולות של קווי הרוחב והאורך שצוינו. חשוב לזכור שאובייקטים שנמצאים מחוץ לגבולות עדיין יעברו רינדור. אפשר להגביל את קווי האורך והרוחב, או להגביל רק את קו הרוחב או רק את קו האורך. כדי להגדיר גבולות של קו רוחב בלבד, משתמשים בקווי האורך המערבי והמזרחי של -180 ו-180, בהתאמה. כדי להגדיר גבולות של קווי אורך בלבד, צריך להשתמש בקווי הרוחב הצפוני והדרומי 90 ו--90, בהתאמה.
center
מרכז המפה, שמוגדר כ-LatLngAltitude, כאשר הגובה הוא במטרים מעל פני הקרקע. שימו לב: זה לא בהכרח המיקום של המצלמה, כי השדה range משפיע על המרחק של המצלמה ממרכז המפה. אם לא מגדירים את המדיניות, ברירת המחדל היא {lat: 0, lng: 0, altitude: 63170000}. הגובה המקסימלי המותר הוא 63,170,000 מטרים (רדיוס כדור הארץ כפול 10).
מאפיין HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
סוג:  boolean optional
ברירת מחדל: false
כשמגדירים את האפשרות true, תוויות ברירת המחדל של המפה לא מוצגות.
מאפיין HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
סוג:  boolean optional
ברירת מחדל: false
אם המדיניות true, כל לחצני ברירת המחדל בממשק המשתמש מושבתים. המקלדת ואמצעי הבקרה של תנועות הידיים לא מושבתים.
מאפיין HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
סוג:  number optional
הכיוון של המפה במצפן, במעלות, כאשר צפון הוא אפס. אם אין הטיה, כל גלגול יפורש ככיוון.
מאפיין HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
סוג:  number optional
הגובה המקסימלי מעל פני הקרקע שיוצג במפה. ערך תקין הוא בין 0 ל-63170000 מטרים (הרדיוס של כדור הארץ כפול 10).
מאפיין HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
סוג:  number optional
הזווית המקסימלית של הכיוון (סיבוב) של המפה. הערך התקין הוא בין 0 ל-360 מעלות. ‫minHeading ו-maxHeading מייצגים מרווח של ‎ <= 360 מעלות שבו מותרות תנועות של שינוי כיוון. ‫minHeading = 180 ו-maxHeading = 90 יאפשרו כותרת ב-[0, 90] וכותרת ב-[180, 360]. ההגדרות minHeading = 90 ו-maxHeading = 180 יאפשרו את הכותרת ב-[90, 180].
מאפיין HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
סוג:  number optional
זווית הפגיעה המקסימלית של המפה. הערך התקין הוא בין 0 ל-90 מעלות.
מאפיין HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
סוג:  number optional
הגובה המינימלי מעל פני הקרקע שיוצג במפה. ערך תקין הוא בין 0 ל-63170000 מטרים (הרדיוס של כדור הארץ כפול 10).
מאפיין HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
סוג:  number optional
הזווית המינימלית של כיוון (סיבוב) המפה. הערך התקין הוא בין 0 ל-360 מעלות. ‫minHeading ו-maxHeading מייצגים מרווח של ‎ <= 360 מעלות שבו מותרות תנועות של שינוי כיוון. ‫minHeading = 180 ו-maxHeading = 90 יאפשרו כותרת ב-[0, 90] וכותרת ב-[180, 360]. ההגדרות minHeading = 90 ו-maxHeading = 180 יאפשרו את הכותרת ב-[90, 180].
מאפיין HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
סוג:  number optional
זווית הפגיעה המינימלית של המפה. הערך התקין הוא בין 0 ל-90 מעלות.
מאפיין HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
סוג:  number optional
המרחק מהמצלמה למרכז המפה, במטרים.
מאפיין HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
סוג:  number optional
הגלגול של המצלמה סביב וקטור התצוגה במעלות. כדי לפתור אי בהירויות, כשאין הטיה, כל גלגול יפורש ככיוון.
מאפיין HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
סוג:  number optional
ההטיה של וקטור זווית הצילום של המצלמה במעלות. לווקטור של תצוגה שמכוון ישירות כלפי מטה אל כדור הארץ יהיה שיפוע של אפס מעלות. וקטור של תצוגה שמצביע הרחק מכדור הארץ יהיה מוטה ב-180 מעלות.
מאפיין HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
flyCameraAround
flyCameraAround(options)
פרמטרים: 
ערך מוחזר:  אין
השיטה הזו מקיפה את המצלמה סביב מיקום נתון למשך זמן נתון, ומבצעת את מספר הסיבובים הנתון בזמן הזה.

כברירת מחדל, המצלמה מסתובבת עם כיוון השעון. אם מציינים מספר שלילי של סיבובים, המצלמה תסתובב בכיוון הפוך לשעון.

השיטה היא אסינכרונית כי אפשר להתחיל את האנימציות רק אחרי שהמפה נטענה בכמות מינימלית. השיטה מחזירה ערך אחרי שהאנימציה מתחילה.

אם מספר הסיבובים הוא אפס, לא יתבצע סיבוב והאנימציה תסתיים מיד אחרי שהיא תתחיל.
flyCameraTo
flyCameraTo(options)
פרמטרים: 
ערך מוחזר:  אין
בשיטה הזו המצלמה זזה בצורה פרבולית מהמיקום הנוכחי למיקום סופי נתון במשך פרק זמן נתון.

השיטה היא אסינכרונית כי אפשר להתחיל את האנימציות רק אחרי שהמפה נטענה בכמות מינימלית. השיטה מחזירה ערך אחרי שהאנימציה מתחילה.
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.
stopCameraAnimation
stopCameraAnimation()
פרמטרים:  אין
ערך מוחזר:  אין
השיטה הזו מפסיקה כל אנימציה של מעבר שמתרחשת. המצלמה נשארת במיקום שבו היא נמצאת באמצע האנימציה, ולא עוברת לנקודת הסיום.

השיטה היא אסינכרונית כי אפשר להתחיל או להפסיק אנימציות רק אחרי שהמפה נטענה במידה מסוימת. השיטה תחזיר ערך אחרי שהאנימציה תופסק.
gmp-animationend
function(animationEndEvent)
ארגומנטים: 
  • animationEndEvent:  Event
האירוע הזה מופעל כשהאנימציה של המעוף מסתיימת. האירוע הזה עולה דרך עץ ה-DOM.
gmp-centerchange
function(centerChangeEvent)
ארגומנטים: 
  • centerChangeEvent:  Event
האירוע הזה מופעל כשמאפיין המרכז של Map3DElement משתנה.
gmp-click
function(clickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על רכיב Map3DElement.
gmp-headingchange
function(headingChangeEvent)
ארגומנטים: 
  • headingChangeEvent:  Event
האירוע הזה מופעל כשמאפיין הכותרת של Map3DElement משתנה.
gmp-rangechange
function(rangeChangeEvent)
ארגומנטים: 
  • rangeChangeEvent:  Event
האירוע הזה מופעל כשמאפיין הטווח של Map3DElement משתנה.
gmp-rollchange
function(rollChangeEvent)
ארגומנטים: 
  • rollChangeEvent:  Event
האירוע הזה מופעל כשמאפיין הגלגול של Map3DElement משתנה.
gmp-steadychange
function(steadyChangeEvent)
ארגומנטים: 
האירוע הזה מופעל כשמצב היציבות של Map3DElement משתנה.
gmp-tiltchange
function(tiltChangeEvent)
ארגומנטים: 
  • tiltChangeEvent:  Event
האירוע הזה מופעל כשמאפיין ההטיה של Map3DElement משתנה.

‫Map3DElementOptions interface

google.maps.maps3d.Map3DElementOptions ממשק

אובייקט Map3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Map3DElement.
bounds optional
Map3DElement.bounds.
center optional
Map3DElement.center.
defaultLabelsDisabled optional
סוג:  boolean optional
Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
סוג:  boolean optional
Map3DElement.defaultUIDisabled.
heading optional
סוג:  number optional
Map3DElement.heading.
maxAltitude optional
סוג:  number optional
Map3DElement.maxAltitude.
maxHeading optional
סוג:  number optional
Map3DElement.maxHeading.
maxTilt optional
סוג:  number optional
Map3DElement.maxTilt.
minAltitude optional
סוג:  number optional
Map3DElement.minAltitude.
minHeading optional
סוג:  number optional
Map3DElement.minHeading.
minTilt optional
סוג:  number optional
Map3DElement.minTilt.
range optional
סוג:  number optional
Map3DElement.range.
roll optional
סוג:  number optional
Map3DElement.roll.
tilt optional
סוג:  number optional
Map3DElement.tilt.

‫FlyAroundAnimationOptions interface

google.maps.maps3d.FlyAroundAnimationOptions ממשק

אפשרויות להתאמה אישית של האנימציה FlyCameraAround.
camera
סוג:  CameraOptions
הנקודה המרכזית שאליה המצלמה צריכה להסתכל במהלך אנימציית הסיבוב. שימו לב שהכותרת של המפה תשתנה כשהמצלמה תסתובב סביב נקודת המרכז הזו.
durationMillis optional
סוג:  number optional
משך האנימציה באלפיות השנייה. זהו משך הזמן הכולל של האנימציה, ולא משך הזמן של סיבוב בודד.
rounds optional
סוג:  number optional
מספר הסיבובים סביב המרכז במשך הזמן הנתון. ההגדרה הזו קובעת את המהירות הכוללת של הרוטציה. אם מעבירים מספר שלילי לפונקציית העיגול, המצלמה תסתובב נגד כיוון השעון במקום בכיוון השעון שמוגדר כברירת מחדל.

‫FlyToAnimationOptions interface

google.maps.maps3d.FlyToAnimationOptions ממשק

אפשרויות להתאמה אישית של האנימציה FlyCameraTo.
endCamera
סוג:  CameraOptions
המיקום שאליו המצלמה צריכה להיות מכוונת בסוף האנימציה.
durationMillis optional
סוג:  number optional
משך האנימציה באלפיות השנייה. משך זמן של 0 יגרום למצלמה לעבור ישירות למיקום הסופי.

‫CameraOptions interface

google.maps.maps3d.CameraOptions ממשק

אובייקט CameraOptions משמש להגדרת המאפיינים שאפשר להגדיר באובייקט מצלמה. אובייקט המצלמה יכול להיות כל דבר שיש לו מיקום מצלמה, למשל מצב מפה נוכחי או מצב אנימציה עתידי מבוקש.