3D Maps

הכיתה 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
כשהיא מוגדרת, היא מגבילה את מיקום המצלמה בתוך גבולות קו הרוחב/קו האורך שצוינו. שימו לב שאובייקטים שנמצאים מחוץ לגבולות עדיין עוברים רינדור. אפשר להגביל את הגבולות גם לקו הרוחב וגם לקו האורך, או רק לקו הרוחב או לקו האורך. בגבולות קווי רוחב בלבד, משתמשים בקווי האורך המערביים והמזרחיים של -180 ו-180, בהתאמה. כדי לציין גבולות לפי קו אורך בלבד, צריך להשתמש בקו הרוחב הצפוני 90 ובקו הרוחב הדרומי -90, בהתאמה.
center
מרכז המפה נתון בתור LatLngגובה, שבו הגובה הוא במטרים מעל פני הקרקע. שימו לב: זה לא בהכרח המיקום שבו המצלמה ממוקמת, כי השדה 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 הוא 1, כל לחצני ברירת המחדל בממשק המשתמש מושבתים. לא משבית את אמצעי הבקרה של המקלדת והתנועות.
מאפיין 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)
פרמטרים: 
ערך המוחזר:  None
בשיטה הזו, המצלמה זזה באופן פרבולי מהמיקום הנוכחי למיקום סופי נתון לאורך פרק זמן נתון.

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

השיטה אסינכרונית כי אפשר להפעיל או להפסיק אנימציות רק אחרי שהמפה נטענת במידה מינימלית. השיטה מחזירה תשובה אחרי שהאנימציה נעצרת.
gmp-animationend
function(animationEndEvent)
ארגומנטים: 
  • animationEndEvent:  Event
האירוע הזה מופעל כשאנימציית הטיסה מסתיימת. האירוע הזה עולה מעלה דרך עץ ה-DOM.
gmp-centerchange
function(centerChangeEvent)
ארגומנטים: 
  • centerChangeEvent:  Event
האירוע הזה מופעל כשהמאפיין center של 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
האירוע הזה מופעל כשהמאפיין roll של Map3DElement משתנה.
gmp-steadychange
function(steadyChangeEvent)
ארגומנטים: 
האירוע הזה מופעל כשמצב היציבות של Map3DElement משתנה.
gmp-tiltchange
function(tiltChangeEvent)
ארגומנטים: 
  • tiltChangeEvent:  Event
האירוע הזה מופעל כשיש שינוי במאפיין ההטיה של Map3DElement.

ממשק Map3DElementOptions

ממשק 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

ממשק google.maps.maps3d.FlyAroundAnimationOptions

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

ממשק FlyToAnimationOptions

הממשק של google.maps.maps3d.FlyToAnimationOptions

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

הממשק CameraOptions

ממשק google.maps.maps3d.CameraOptions

אובייקט CameraOptions שמשמש להגדרת המאפיינים שאפשר להגדיר באובייקט מצלמה. אובייקט המצלמה יכול להיות כל דבר שממוקם במיקום המצלמה, למשל מצב מפה נוכחי או מצב אנימציה מבוקש בעתיד.
center optional
Map3DElement.center.
heading optional
סוג:  number optional
Map3DElement.heading.
range optional
סוג:  number optional
Map3DElement.range.
roll optional
סוג:  number optional
Map3DElement.roll.
tilt optional
סוג:  number optional
Map3DElement.tilt.

הכיתה 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 מחלקה

האירוע הזה נוצר מהקלקה על Map3DElement.

הקורס הזה תקף עד LocationClickEvent.

קבלת גישה באמצעות חיוג אל const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). ספריות ב-Maps JavaScript API
placeId
סוג:  string
מזהה המקום של התכונה במפה.
עבר בירושה: position
fetchPlace
fetchPlace()
פרמטרים: ללא
ערך המוחזר:  Promise<Place>
אחזור של 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:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
סוג:  CollisionBehavior optional
ברירת המחדל: CollisionBehavior.REQUIRED
ספירה שמציינת איך Marker3DElement צריך להתנהג כשהוא מתנגש ב-Marker3DElement אחר או בתוויות של מפת הבסיס.
מאפיין HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
סוג:  boolean optional
ברירת המחדל: false
קובע אם הסמן הזה יופיע או לא כשהוא חסום. ניתן להסתיר את הסמן על ידי גיאומטריה של המפה (למשל, בניינים).
מאפיין HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
סוג:  boolean optional
ברירת מחדל: false
מציינת אם לחבר את הסמן לקרקע. כדי להדגים סמן, הערך של altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.
מאפיין HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
סוג:  string optional
הטקסט שיוצג לצד הסמן הזה.
מאפיין HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
המיקום של קצה הסמן. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן היא אופציונלית.
sizePreserved
סוג:  boolean optional
ברירת המחדל: false
השדה מציין אם הסמן הזה ישמור על הגודל שלו או לא, ללא קשר למרחק מהמצלמה. כברירת מחדל, הסמן מותאם לפי המרחק מהמצלמה או לפי ההטיה.
מאפיין HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
סוג:  number optional
הערך של zIndex בהשוואה לסימנים אחרים.
מאפיין HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
כל רכיב מותאם אישית שיתווסף ישירות אל Marker3DElement יופיע במיקומים מסוימים, אבל רק רכיבים מסוג HTMLImageElement, SVGElement ו-PinElement ישמשו לסמנים של שרטוט. המערכת תתעלם מרכיבים אחרים. צריך לעטוף את
HTMLImageElement ו-SVGElement באלמנט <template> לפני שמקצים אותם למיקום ברירת המחדל של Marker3DElement.

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

הממשק Marker3DElementOptions

ממשק google.maps.maps3d.Marker3DElementOptions

אובייקט Mark3DElementOptions המשמש להגדרת המאפיינים שניתן להגדיר ב-Mark3DElement.
altitudeMode optional
סוג:  AltitudeMode optional
Marker3DElement.altitudeMode.
collisionBehavior optional
סוג:  CollisionBehavior optional
Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
סוג:  boolean optional
Marker3DElement.drawsWhenOccluded.
extruded optional
סוג:  boolean optional
Marker3DElement.extruded.
label optional
סוג:  string optional
Marker3DElement.label.
position optional
Marker3DElement.position.
sizePreserved optional
סוג:  boolean optional
Marker3DElement.sizePreserved.
zIndex optional
סוג:  number optional
Marker3DElement.zIndex.

הכיתה 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 ישמשו לציור סמנים, רכיבים אחרים יי игнорו.
addEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת רגישה לאותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו.
  • listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. הכתובת הזו חייבת להיות פונקציה או אובייקט עם method headEvent.
  • options:  boolean|AddEventListenerOptions optional אפשר לעיין באפשרויות. אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך המוחזר:  void
הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
removeEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר האזנה לאירועים.
  • listener:  EventListener|EventListenerObject ה-event listener של גורם הטיפול באירוע שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשר לעיין באפשרויות
ערך המוחזר:  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 מחלקה

מודל תלת-ממדי שמאפשר עיבוד גרפי של מודלים בפורמט 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:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
תיאור של סיבוב של מערכת הקואורדינטות של מודל תלת-ממדי כדי למקם את המודל במפה התלת-ממדית.

הפיכות חלות על המודל לפי הסדר הבא: רוטציה, הטיה ואז כיוון.
position
מגדיר את המיקום של Model3DElement. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי.
scale
סוג:  number|Vector3D|Vector3DLiteral optional
ברירת מחדל: 1
שינוי הגודל של המודל לאורך הצירים x,‏ y ו-z במרחב הקואורדינטות של המודל.
src
סוג:  string|URL optional
כתובת ה-URL של המודל התלת-ממדי. בשלב זה יש תמיכה רק במודלים בפורמט .glb.

כל כתובות ה-URL היחסיות מסוג HTTP ימולאו לכתובות ה-URL המוחלטות התואמות.

לתשומת ליבכם: אם אתם מארחים את קובצי המודל של .glb באתר או בשרת שונים מאלה של האפליקציה הראשית, חשוב להגדיר את כותרות ה-HTTP הנכונות של CORS. כך האפליקציה יכולה לגשת באופן מאובטח לקובצי המודל מהדומיין השני.
מאפיין HTML:
  • <gmp-model-3d src="src"></gmp-model-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת רגישה לאותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו.
  • listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. זה חייב להיות פונקציה או אובייקט עם שיטת handleEvent
  • options:  boolean|AddEventListenerOptions optional לעיון באפשרויות. אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך המוחזר:  void
הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת שמציינת את סוג האירוע שעבורו רוצים להסיר את מאזין האירועים.
  • listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים להסרה מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשר לעיין באפשרויות
ערך ההחזרה:  void
הסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener

ממשק Model3DElementOptions

ממשק google.maps.maps3d.Model3DElementOptions

אובייקט Model3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Model3DElement.
altitudeMode optional
סוג:  AltitudeMode optional
Model3DElement.altitudeMode.
orientation optional
Model3DElement.orientation.
position optional
Model3DElement.position.
scale optional
סוג:  number|Vector3D|Vector3DLiteral optional
Model3DElement.scale.
src optional
סוג:  string|URL optional
Model3DElement.src.

מחלקה Polyline3DElement

google.maps.maps3d.Polyline3DElement מחלקה

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

רכיב מותאם אישית:
<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:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
הרצף המסודר של הקואורדינטות של הקו הפוליגוני. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי.
drawsOccludedSegments
סוג:  boolean optional
ברירת מחדל: false
מציין אם חלקים של קו הפוליגון שעשויים להיות מוסתרים מצוירים או לא. אפשר להסתיר קווים פוליגוניים באמצעות גיאומטריה של המפה (למשל, בניינים).
מאפיין HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
סוג:  boolean optional
ברירת מחדל: false
מציין אם יש לחבר את קו הפוליגון לקרקע. כדי להדגים קו פוליגוני, הערך של altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.
מאפיין HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
סוג:  boolean optional
ברירת מחדל: false
כשהערך של true הוא 1, הקצוות של הפוליגון מפורשים כקווים גיאודזיים ויימשכו לפי עקומת כדור הארץ. כשהערך הוא false, הקצוות של הקו הפוליגוני מוצגים כקווים ישרים בשטח המסך.
מאפיין HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
סוג:  string optional
הצבע החיצוני. כל צבעי CSS3 נתמכים.
מאפיין HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
סוג:  number optional
הרוחב החיצוני הוא בין 0.0 ל-1.0. זהו אחוז מסוים של strokeWidth.
מאפיין HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
סוג:  string optional
צבע הקו. כל צבעי CSS3 נתמכים.
מאפיין HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
סוג:  number optional
עובי הקו בפיקסלים.
מאפיין HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
סוג:  number optional
הערך של zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת רגישה לאותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו.
  • listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. זה חייב להיות פונקציה או אובייקט עם שיטת handleEvent
  • options:  boolean|AddEventListenerOptions optional אפשר לעיין באפשרויות. אירועים בהתאמה אישית תומכים רק ב-capture וב-passive.
ערך המוחזר:  void
הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת שמציינת את סוג האירוע שעבורו רוצים להסיר את מאזין האירועים.
  • listener:  EventListener|EventListenerObject ה-event listener של גורם הטיפול באירוע שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשר לעיין באפשרויות
ערך המוחזר:  void
הסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener

הממשק Polyline3DElementOptions

ממשק google.maps.maps3d.Polyline3DElementOptions

אובייקט Polyline3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Polyline3DElement.
altitudeMode optional
סוג:  AltitudeMode optional
Polyline3DElement.altitudeMode.
coordinates optional
Polyline3DElement.coordinates.
drawsOccludedSegments optional
סוג:  boolean optional
Polyline3DElement.drawsOccludedSegments.
extruded optional
סוג:  boolean optional
Polyline3DElement.extruded.
geodesic optional
סוג:  boolean optional
Polyline3DElement.geodesic.
outerColor optional
סוג:  string optional
Polyline3DElement.outerColor.
outerWidth optional
סוג:  number optional
Polyline3DElement.outerWidth.
strokeColor optional
סוג:  string optional
Polyline3DElement.strokeColor.
strokeWidth optional
סוג:  number optional
Polyline3DElement.strokeWidth.
zIndex optional
סוג:  number optional
Polyline3DElement.zIndex.

הכיתה Polygon3DElement

google.maps.maps3d.Polygon3DElement מחלקה

פוליגון תלת-ממדי (כמו קו פוליגוני תלת-ממדי) מגדיר סדרה של קואורדינטות מחוברות לפי סדר מסודר. בנוסף, פוליגונים יוצרים לולאה סגורה ומגדירים אזור מלא.

רכיב מותאם אישית:
<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:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
סוג:  boolean optional
ברירת מחדל: false
מציין אם חלקים של הפוליגון שעשויים להיות מוסתרים מצוירים או לא. פוליגונים יכולים להיות מוסתרים על ידי גיאומטריה של מפה (למשל, בניינים).
מאפיין HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
סוג:  boolean optional
ברירת מחדל: false
מציין אם לחבר את הפוליגון לקרקע. כדי להרחיב פוליגון, הערך של altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.
מאפיין HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
סוג:  string optional
צבע המילוי. יש תמיכה בכל הצבעים של CSS3.
מאפיין HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
סוג:  boolean optional
ברירת מחדל: false
כשהערך של true הוא 1, הקצוות של הפוליגון מפורשים כגיאודזיים ויימשכו לפי עקומת כדור הארץ. כשהערך של false הוא 1, הקצוות של הפוליגון מוצגים כקווים ישרים במרחב המסך.
מאפיין HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
רצף מסודר של קואורדינטות שמציין לולאה סגורה. בניגוד לקו פוליגון, מצולע יכול להכיל נתיב אחד או יותר, שיוצרים כמה חתכים בתוך המרובע.
outerCoordinates
רצף מסודר של קואורדינטות שמציין לולאה סגורה. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי.
strokeColor
סוג:  string optional
צבע הקו. כל צבעי CSS3 נתמכים.
מאפיין HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
סוג:  number optional
עובי הקו בפיקסלים.
מאפיין HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
סוג:  number optional
הערך של zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת תלוית אותיות רישיות שמייצגת את סוג האירוע שצריך להאזין לו.
  • listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. הכתובת הזו חייבת להיות פונקציה או אובייקט עם method headEvent.
  • options:  boolean|AddEventListenerOptions optional לעיון באפשרויות. אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך המוחזר:  void
הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת שמציינת את סוג האירוע שעבורו רוצים להסיר את מאזין האירועים.
  • listener:  EventListener|EventListenerObject ה-event listener של גורם הטיפול באירוע שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional לעיון באפשרויות
ערך המוחזר:  void
הסרה של האזנה לאירוע שנרשם בעבר ב-addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener

הממשק Polygon3DElementOptions

ממשק google.maps.maps3d.Polygon3DElementOptions

אובייקט Polygon3DElementOptions משמש להגדרת המאפיינים שניתן להגדיר ב-Polygon3DElement.
altitudeMode optional
סוג:  AltitudeMode optional
Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
סוג:  boolean optional
Polygon3DElement.drawsOccludedSegments.
extruded optional
סוג:  boolean optional
Polygon3DElement.extruded.
fillColor optional
סוג:  string optional
Polygon3DElement.fillColor.
geodesic optional
סוג:  boolean optional
Polygon3DElement.geodesic.
innerCoordinates optional
Polygon3DElement.innerCoordinates.
outerCoordinates optional
Polygon3DElement.outerCoordinates.
strokeColor optional
סוג:  string optional
Polygon3DElement.strokeColor.
strokeWidth optional
סוג:  number optional
Polygon3DElement.strokeWidth.
zIndex optional
סוג:  number optional
Polygon3DElement.zIndex.

קבועים של 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 מאפשר להציג אובייקטים ביחס לגובה הגבוה ביותר של הקרקע, הבניין או פני המים. כשהמצלמה מעל מים, זה יהיה פני המים. כשהמצלמה מעל פני השטח, זה יהיה פני המבנה (אם יש מבנה) או פני הקרקע (אם אין מבנים).