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

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

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

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

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

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

הממשק Marker3DElementOptions

ממשק google.maps.maps3d.Marker3DElementOptions

אובייקט Marker3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Marker3DElement.
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 האובייקט שמקבל התראה. זה חייב להיות פונקציה או אובייקט עם שיטת handleEvent
  • 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 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:
  • <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 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:
  • <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 הוא 1, הקצוות של קו הפוליגון מוצגים כקווים ישרים במרחב המסך.
מאפיין 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 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:
  • <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 האובייקט שמקבל התראה. זה חייב להיות פונקציה או אובייקט עם שיטת 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

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