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])
פרמטרים: 
  • typestring מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • listenerEventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • optionsboolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
flyCameraAround
flyCameraAround(options)
פרמטרים: 
ערך מוחזר:  אין
השיטה הזו מקיפה את המצלמה סביב מיקום נתון למשך זמן נתון, ומבצעת את מספר הסיבובים הנתון בזמן הזה.

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

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

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

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

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

Map3DElementOptions interface

google.maps.maps3d.Map3DElementOptions ממשק

אובייקט Map3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Map3DElement.

bounds optional
center 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 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 משמש להגדרת המאפיינים שאפשר להגדיר באובייקט מצלמה. אובייקט המצלמה יכול להיות כל דבר שיש לו מיקום מצלמה, למשל מצב מפה נוכחי או מצב אנימציה עתידי מבוקש.

center optional
heading optional
סוג:  number optional
range optional
סוג:  number optional
roll optional
סוג:  number optional
tilt optional
סוג:  number optional

SteadyChangeEvent class

google.maps.maps3d.SteadyChangeEvent class

האירוע הזה נוצר ממעקב אחר מצב יציב של Map3DElement. האירוע הזה עולה דרך עץ ה-DOM.

הכיתה הזו היא הרחבה של Event.

אפשר להתקשר אל const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

isSteady
סוג:  boolean
מציין אם Map3DElement יציב (כלומר, כל הרכיבים של הסצנה הנוכחית עברו רינדור) או לא.

LocationClickEvent class

google.maps.maps3d.LocationClickEvent class

האירוע הזה נוצר כשלוחצים על Map3DElement.

הכיתה הזו היא הרחבה של Event.

אפשר להתקשר אל const {LocationClickEvent} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

position
סוג:  LatLngAltitude optional
קו הרוחב, קו האורך והגובה שהיו מתחת לסמן כשהאירוע התרחש. חשוב לזכור שברמות גסות יותר, יוחזרו נתונים פחות מדויקים. בנוסף, יכול להיות שערך הגובה שיוחזר יהיה הגובה של קרקעית הים אם תלחצו על פני המים ממיקום מצלמה גבוה יותר. האירוע הזה עולה דרך עץ ה-DOM.

PlaceClickEvent class

google.maps.maps3d.PlaceClickEvent class

האירוע הזה נוצר כשלוחצים על Map3DElement.

הכיתה הזו היא הרחבה של LocationClickEvent.

אפשר להתקשר אל const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

placeId
סוג:  string
מזהה המקום של התכונה במפה.
Inherited: position
fetchPlace
fetchPlace()
פרמטרים:  אין
ערך מוחזר:  Promise<Place>
מאחזר Place לפי מזהה המקום. במזהה המאפיין של אובייקט Place שמתקבל, יאוכלס המזהה. אפשר לבקש בהמשך שדות נוספים דרך Place.fetchFields() בכפוף להפעלה ולחיוב הרגילים של Places API. ההבטחה נדחית אם הייתה שגיאה באחזור של Place.

Marker3DElement class

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])
פרמטרים: 
  • typestring מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • listenerEventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • optionsboolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • listenerEventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • optionsboolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

Marker3DElementOptions interface

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
sizePreserved optional
סוג:  boolean optional
zIndex optional
סוג:  number optional

Marker3DInteractiveElement class

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])
פרמטרים: 
  • typestring מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • listenerEventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • optionsboolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף על addEventListener
removeEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • listenerEventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • optionsboolean|EventListenerOptions optional ראו אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף על removeEventListener
gmp-click
function(clickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על רכיב Marker3DInteractiveElement.

Marker3DInteractiveElementOptions interface

google.maps.maps3d.Marker3DInteractiveElementOptions ממשק

אובייקט Marker3DInteractiveElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Marker3DInteractiveElement.

הממשק הזה מרחיב את Marker3DElementOptions.

בירושה: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Model3DElement class

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 המוחלטות התואמות.

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

ממשק Model3DElementOptions

google.maps.maps3d.Model3DElementOptions ממשק

אובייקט Model3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Model3DElement.

altitudeMode optional
סוג:  AltitudeMode optional
orientation optional
position optional
scale optional
סוג:  number|Vector3D|Vector3DLiteral optional
src optional
סוג:  string|URL optional

Polyline3DElement class

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, הקצוות של הקו המרוסק מתפרשים כגאודזיים ויעקבו אחרי הקימור של כדור הארץ. כשמגדירים את הערך 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])
פרמטרים: 
  • typestring מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • listenerEventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • optionsboolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • listenerEventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • optionsboolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

Polyline3DElementOptions interface

google.maps.maps3d.Polyline3DElementOptions ממשק

אובייקט Polyline3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Polyline3DElement.

altitudeMode optional
סוג:  AltitudeMode optional
coordinates 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 class

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, הקצוות של הפוליגון מתפרשים כגאודזיים ויעקבו אחרי הקימור של כדור הארץ. כשמגדירים את הערך false, הקצוות של הפוליגון מוצגים כקווים ישרים במרחב המסך.
מאפיין 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])
פרמטרים: 
  • typestring מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • listenerEventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • optionsboolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • listenerEventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • optionsboolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

Polygon3DElementOptions interface

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
outerCoordinates optional
strokeColor optional
סוג:  string optional
strokeWidth optional
סוג:  number optional
zIndex optional
סוג:  number optional

AltitudeMode constants

google.maps.maps3d.AltitudeMode constants

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

אפשר להתקשר אל const {AltitudeMode} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

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