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.