3D Maps

‫Map3DElement class

google.maps.maps3d.Map3DElement class

‫Map3DElement הוא ממשק HTML לתצוגת המפה בתלת-ממד. הערה: צריך להגדיר את mode כדי שהמפה בתלת-ממד תתחיל לעבור רינדור.

רכיב בהתאמה אישית:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" 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>
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>
mode
סוג:  MapMode optional
מציין את המצב שבו המפה תוצג. אם לא מגדירים את המאפיין הזה, המפה לא תוצג.
מאפיין HTML:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></gmp-map-3d>
range
סוג:  number optional
המרחק מהמצלמה למרכז המפה, במטרים.
מאפיין HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
סוג:  number optional
הגלגול של המצלמה סביב וקטור התצוגה במעלות. כדי לפתור אי בהירויות, כשאין הטיה, כל גלגול יפורש ככיוון.
מאפיין HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
סוג:  number optional
ההטיה של וקטור זווית הצילום של המצלמה במעלות. לווקטור של תצוגה שמכוון ישירות כלפי מטה אל כדור הארץ יהיה שיפוע של אפס מעלות. וקטור של תצוגה שמצביע הרחק מכדור הארץ יהיה מוטה ב-180 מעלות.
מאפיין HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
flyCameraAround
flyCameraAround(options)
פרמטרים: 
ערך מוחזר:  אין
השיטה הזו מקיפה את המצלמה סביב מיקום נתון למשך זמן נתון, ומבצעת את מספר הסיבובים הנתון בזמן הזה.

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

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

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

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

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

‫Map3DElementOptions interface

google.maps.maps3d.Map3DElementOptions ממשק

אובייקט Map3DElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Map3DElement.
bounds optional
Map3DElement.bounds.
center optional
Map3DElement.center.
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.
mode optional
סוג:  MapMode optional
Map3DElement.mode.
range optional
סוג:  number optional
Map3DElement.range.
roll optional
סוג:  number optional
Map3DElement.roll.
tilt optional
סוג:  number optional
Map3DElement.tilt.

MapMode constants

google.maps.maps3d.MapMode constants

מציין את המצב שבו המפה תוצג.

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

‫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
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 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. כדי למנוע את הצגת ה-popover שמוגדר כברירת מחדל, צריך להפעיל את השיטה preventDefault() באירוע הזה כדי למנוע את הטיפול בו על ידי 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" position="lat,lng" 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
המיקום של קצה הסמן. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי.
מאפיין HTML:
  • <gmp-marker-3d position="lat,lng"></gmp-marker-3d>
  • <gmp-marker-3d position="lat,lng,altitude"></gmp-marker-3d>
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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫Marker3DElementOptions interface

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 class

google.maps.maps3d.Marker3DInteractiveElement class

הצגת מיקום במפה תלת-ממדית. הערה: כדי שהשדה Marker3DInteractiveElement יוצג, צריך להגדיר את position. בניגוד ל-Marker3DElement, המערכת שולחת ל-Marker3DInteractiveElement אירוע gmp-click.

רכיב בהתאמה אישית:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>

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

במחלקה הזו מיושם Marker3DInteractiveElementOptions.

אפשר להתקשר אל const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
פרמטרים: 
יוצרת Marker3DInteractiveElement עם האפשרויות שצוינו.
gmpPopoverTargetElement
סוג:  PopoverElement optional
אם המאפיין מוגדר, רכיב ה-popover ייפתח כשלוחצים על הסמן הזה.
מאפיין HTML:
  • <gmp-marker-3d-interactive gmp-popover-target="popover-id"></gmp-marker-3d-interactive>
title
סוג:  string
טקסט לגלגול. אם מספקים טקסט נגישות (למשל לשימוש עם קוראי מסך), הוא יתווסף לרכיב Marker3DInteractiveElement עם הערך שסופק.
מאפיין HTML:
  • <gmp-marker-3d-interactive title="string"></gmp-marker-3d-interactive>
בירושה: 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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף על removeEventListener
gmp-click
function(clickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על רכיב Marker3DInteractiveElement.

Marker3DInteractiveElementOptions interface

google.maps.maps3d.Marker3DInteractiveElementOptions ממשק

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

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

gmpPopoverTargetElement optional
סוג:  PopoverElement optional
Marker3DInteractiveElement.gmpPopoverTargetElement.
title optional
סוג:  string optional
Marker3DInteractiveElement.title.
בירושה: 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" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></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
מתאר את הסיבוב של מערכת הקואורדינטות של מודל תלת-ממדי כדי למקם את המודל במפה התלת-ממדית.

הסיבובים מוחלים על המודל בסדר הבא: גלגול, הטיה ואז כיוון.
מאפיין HTML:
  • <gmp-model-3d orientation="heading,tilt,roll"></gmp-model-3d>
position
מגדיר את המיקום של Model3DElement. המערכת מתעלמת מהגובה במצבים מסוימים, ולכן הוא אופציונלי.
מאפיין HTML:
  • <gmp-model-3d position="lat,lng"></gmp-model-3d>
  • <gmp-model-3d position="lat,lng,altitude"></gmp-model-3d>
scale
סוג:  number|Vector3D|Vector3DLiteral optional
ברירת מחדל: 1
משנה את קנה המידה של המודל לאורך הצירים x,‏ y ו-z במרחב הקואורדינטות של המודל.
מאפיין HTML:
  • <gmp-model-3d scale="number"></gmp-model-3d>
  • <gmp-model-3d scale="x,y,z"></gmp-model-3d>
src
סוג:  string|URL optional
מציינת את כתובת ה-URL של המודל התלת-ממדי. בשלב הזה, יש תמיכה רק במודלים בפורמט .glb.

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

שימו לב: אם אתם מארחים את קובצי המודל שלכם באתר או בשרת אחרים מאלה של האפליקציה הראשית, הקפידו להגדיר את כותרות ה-HTTP הנכונות של CORS..glb כך האפליקציה יכולה לגשת לקבצים של המודל בצורה מאובטחת מהדומיין השני.
מאפיין HTML:
  • <gmp-model-3d src="url"></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
מסירה מהיעד event listener שנרשם קודם באמצעות 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.

Model3DInteractiveElement class

google.maps.maps3d.Model3DInteractiveElement class

מודל תלת-ממדי שמאפשר עיבוד של מודלים בפורמט gLTF. הערה: כדי שהשדה Model3DElement יוצג, צריך להגדיר את השדות position ו-src.

צריכה להיות תמיכה במאפייני הליבה של gLTF PBR. בשלב הזה אין תמיכה בתוספים או במאפייני תוספים.

בניגוד ל-Model3DElement, המערכת של Model3DInteractiveElement מקבלת אירוע gmp-click.

רכיב בהתאמה אישית:
<gmp-model-3d-interactive></gmp-model-3d-interactive>

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

במחלקה הזו מיושם Model3DInteractiveElementOptions.

אפשר להתקשר אל const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Model3DInteractiveElement
Model3DInteractiveElement([options])
פרמטרים: 
יוצרת Model3DInteractiveElement עם האפשרויות שצוינו.
בירושה: altitudeMode, orientation, position, scale, src
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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף על removeEventListener
gmp-click
function(clickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על רכיב Model3DInteractiveElement.

‫Model3DInteractiveElementOptions interface

google.maps.maps3d.Model3DInteractiveElementOptions ממשק

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

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

בירושה: altitudeMode, orientation, position, scale, src

‫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.CLAMP_TO_GROUND
מציינים איך לפרש את רכיבי הגובה בקואורדינטות.
מאפיין 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])
פרמטרים: 
  • ‫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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫Polyline3DElementOptions interface

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.

‫Polyline3DInteractiveElement class

google.maps.maps3d.Polyline3DInteractiveElement class

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

רכיב בהתאמה אישית:
<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>

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

במחלקה הזו מיושם Polyline3DInteractiveElementOptions.

אפשר להתקשר אל const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
פרמטרים: 
יוצרת Polyline3DInteractiveElement עם האפשרויות שצוינו.
בירושה: altitudeMode, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, strokeColor, strokeWidth, zIndex
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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף על removeEventListener
gmp-click
function(clickEvent)
ארגומנטים: 
  • ‫clickEvent:  LocationClickEvent אובייקט האירוע יכיל את המיקום של הקליק בפורמט latitude-longitude-altitude.
האירוע הזה מופעל כשלוחצים על רכיב Polyline3DInteractiveElement.

‫Polyline3DInteractiveElementOptions interface

google.maps.maps3d.Polyline3DInteractiveElementOptions ממשק

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

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

בירושה: altitudeMode, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, strokeColor, strokeWidth, zIndex

‫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.CLAMP_TO_GROUND
מציינים איך לפרש את רכיבי הגובה בקואורדינטות.
מאפיין 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])
פרמטרים: 
  • ‫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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫Polygon3DElementOptions interface

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.

‫Polygon3DInteractiveElement class

google.maps.maps3d.Polygon3DInteractiveElement class

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

רכיב בהתאמה אישית:
<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>

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

במחלקה הזו מיושם Polygon3DInteractiveElementOptions.

אפשר להתקשר אל const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
פרמטרים: 
יוצרת Polygon3DInteractiveElement עם האפשרויות שצוינו.
בירושה: altitudeMode, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, outerCoordinates, strokeColor, strokeWidth, zIndex
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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף על removeEventListener
gmp-click
function(clickEvent)
ארגומנטים: 
  • ‫clickEvent:  LocationClickEvent אובייקט האירוע יכיל את המיקום של הקליק בפורמט latitude-longitude-altitude.
האירוע הזה מופעל כשלוחצים על רכיב Polygon3DInteractiveElement.

Polygon3DInteractiveElementOptions interface

google.maps.maps3d.Polygon3DInteractiveElementOptions ממשק

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

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

בירושה: altitudeMode, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, outerCoordinates, strokeColor, strokeWidth, zIndex

PopoverElement class

google.maps.maps3d.PopoverElement class

רכיב HTML מותאם אישית שמציג חלון קופץ. הוא נראה כמו בועה ולרוב הוא מחובר לסמן.

רכיב בהתאמה אישית:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>

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

במחלקה הזו מיושם PopoverElementOptions.

אפשר להתקשר אל const {PopoverElement} = await google.maps.importLibrary("maps3d") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
PopoverElement
PopoverElement([options])
פרמטרים: 
altitudeMode
סוג:  AltitudeMode optional
ברירת מחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך רכיב הגובה של המיקום מתפרש.
מאפיין HTML:
  • <gmp-popover altitude-mode="absolute"></gmp-popover>
  • <gmp-popover altitude-mode="clamp-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-mesh"></gmp-popover>
lightDismissDisabled
סוג:  boolean optional
ברירת מחדל: false
קובע אם חלון הפופ-אפ הזה צריך להיסגר בלחיצה מחוץ לו או לא. ההתנהגות של 'סגירה קלה' דומה להגדרת המאפיין popover="auto" שהוא חלק מ-Popover API בדפדפן.
מאפיין HTML:
  • <gmp-popover light-dismiss-disabled></gmp-popover>
open
סוג:  boolean optional
ברירת מחדל: false
קובעת אם החלון הקופץ הזה צריך להיות פתוח או לא.
מאפיין HTML:
  • <gmp-popover open></gmp-popover>
positionAnchor
המיקום שבו יוצג הבועה הזו. אם התוכן הקופץ מעוגן לסמן אינטראקטיבי, המיקום של הסמן ישמש במקום זאת.
מאפיין HTML:
  • <gmp-popover position-anchor="lat,lng"></gmp-popover>
  • <gmp-popover position-anchor="lat,lng,altitude"></gmp-popover>
  • <gmp-popover position-anchor="marker-id"></gmp-popover>
default
התוכן שמוצב במשבצת מופיע בחלק הראשי של ה-popover.
header
התוכן שמוצב בחריץ מופיע בקטע הכותרת של הבועה.
--gmp-popover-max-width
הרוחב המקסימלי של חלון הקופץ, ללא קשר לרוחב התוכן.
--gmp-popover-min-width
הרוחב המינימלי של חלון הקופץ, ללא קשר לרוחב התוכן. כשמשתמשים במאפיין הזה, מומלץ מאוד להגדיר לו ערך שקטן מרוחב המפה (בפיקסלים).
--gmp-popover-pixel-offset-x
ההיסט בציר ה-x, בפיקסלים, של קצה ה-popover מהנקודה במפה שבה הקואורדינטות הגיאוגרפיות של ה-popover מעוגנות.
--gmp-popover-pixel-offset-y
ההיסט בציר ה-Y, בפיקסלים, של קצה ה-popover מהנקודה במפה שבה ה-popover מעוגן בקואורדינטות הגיאוגרפיות.
color-scheme
מציין את ערכת הצבעים שבה אפשר לעבד את הבועה הזו. פרטים נוספים זמינים בcolor-scheme מאמרי העזרה. אם לא מציינים את ערך ברירת המחדל, המערכת משתמשת בהעדפות של ערכת הצבעים של המשתמש.
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
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PopoverElementOptions interface

google.maps.maps3d.PopoverElementOptions ממשק

אובייקט PopoverElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-PopoverElement.
altitudeMode optional
סוג:  AltitudeMode optional
PopoverElement.altitudeMode.
lightDismissDisabled optional
סוג:  boolean optional
PopoverElement.lightDismissDisabled.
open optional
סוג:  boolean optional
PopoverElement.open.
positionAnchor optional
PopoverElement.positionAnchor.

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