Draw on the map

Marker3DElement class

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

הצגת מיקום במפה תלת-ממדית. שימו לב שצריך להגדיר את position כדי ש-Marker3DElement יוצג.

רכיב בהתאמה אישית:
<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 שנוספו לתמונות לא יופעלו, ויכול להיות שהם לא יופיעו כשהסמנים יוצגו במסך.
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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

הממשק Marker3DElementOptions

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

הצגת מיקום במפה תלת-ממדית. שימו לב שצריך להגדיר את position כדי ש-Marker3DInteractiveElement יוצג. בניגוד ל-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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
gmp-click
function(clickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על הרכיב Marker3DInteractiveElement.

ממשק Marker3DInteractiveElementOptions

ממשק google.maps.maps3d.Marker3DInteractiveElementOptions

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

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

gmpPopoverTargetElement optional
סוג:  PopoverElement optional
title optional
סוג:  string optional
‫עברו בירושה: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

הכיתה Model3DElement

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

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

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

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

Model3DInteractiveElement class

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

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

צריך לתמוך במאפייני הליבה של 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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
gmp-click
function(clickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על הרכיב Model3DInteractiveElement.

ממשק Model3DInteractiveElementOptions

ממשק google.maps.maps3d.Model3DInteractiveElementOptions

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

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

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

הכיתה Polyline3DElement

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

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

רכיב בהתאמה אישית:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." 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>
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>
path
הרצף המסודר של הקואורדינטות של הקו הפוליגוני. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
מאפיין HTML:
  • <gmp-polyline-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></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>
coordinates
הרצף המסודר של הקואורדינטות של הקו הפוליגוני. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק Polyline3DElementOptions

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

הכיתה Polyline3DInteractiveElement

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

קו פוליגוני תלת-ממדי הוא שכבת-על לינארית של מקטעי קווים מחוברים במפה תלת-ממדית. בניגוד ל-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, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, path, strokeColor, strokeWidth, zIndex, coordinates
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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
gmp-click
function(clickEvent)
ארגומנטים: 
  • ‫clickEvent:  LocationClickEvent אובייקט האירוע יכיל את מיקום הקליק בקו רוחב, קו אורך וגובה.
האירוע הזה מופעל כשלוחצים על הרכיב Polyline3DInteractiveElement.

ממשק Polyline3DInteractiveElementOptions

ממשק google.maps.maps3d.Polyline3DInteractiveElementOptions

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

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

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

מחלקה Polygon3DElement

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

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

רכיב בהתאמה אישית:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." 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>
innerPaths
רצף הקואורדינטות המסודר שמציין לולאה סגורה. בניגוד לקווים פוליגוניים, פוליגון יכול להיות מורכב ממסלול אחד או יותר, שיוצרים כמה חיתוכים בתוך הפוליגון.
path
רצף הקואורדינטות המסודר שמציין לולאה סגורה. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
מאפיין HTML:
  • <gmp-polygon-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polygon-3d>
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>
outerCoordinates
רצף הקואורדינטות המסודר שמציין לולאה סגורה. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
innerCoordinates
רצף הקואורדינטות המסודר שמציין לולאה סגורה. בניגוד לקווים פוליגוניים, פוליגון יכול להיות מורכב ממסלול אחד או יותר, שיוצרים כמה חיתוכים בתוך הפוליגון.
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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק Polygon3DElementOptions

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

Polygon3DInteractiveElement class

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

פוליגון תלת-ממדי (כמו קו פוליגוני תלת-ממדי) מגדיר סדרה של קואורדינטות מחוברות ברצף מסודר. בנוסף, פוליגונים יוצרים לולאה סגורה ומגדירים אזור מלא. בניגוד ל-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, innerPaths, path, strokeColor, strokeWidth, zIndex, outerCoordinates, innerCoordinates
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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
gmp-click
function(clickEvent)
ארגומנטים: 
  • ‫clickEvent:  LocationClickEvent אובייקט האירוע יכיל את מיקום הקליק בקו רוחב, קו אורך וגובה.
האירוע הזה מופעל כשלוחצים על הרכיב Polygon3DInteractiveElement.

ממשק Polygon3DInteractiveElementOptions

ממשק google.maps.maps3d.Polygon3DInteractiveElementOptions

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

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

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

המחלקה PopoverElement

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

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

רכיב בהתאמה אישית:
<gmp-popover altitude-mode="absolute" auto-pan-disabled 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>
autoPanDisabled
סוג:  boolean optional
ברירת המחדל: false
אם הערך הוא True, המפה לא תזוז כדי להציג את החלון הקופץ במלואו כשהוא נפתח.
מאפיין HTML:
  • <gmp-popover auto-pan-disabled></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
ממקם את התוכן המוגדר בחלק הראשי של החלון הקופץ.
header
מציב את התוכן המוגדר בקטע הכותרת של ה-popover.
--gmp-popover-max-width
הרוחב המקסימלי של החלון הקופץ, בלי קשר לרוחב התוכן.
--gmp-popover-min-width
הרוחב המינימלי של החלון הקופץ, בלי קשר לרוחב התוכן. כשמשתמשים במאפיין הזה, מומלץ מאוד להגדיר לו ערך קטן יותר מרוחב המפה (בפיקסלים).
--gmp-popover-pixel-offset-x
ההיסט בציר ה-X, בפיקסלים, של קצה החלונית הקופצת מהנקודה במפה שבה החלונית הקופצת מעוגנת בקואורדינטות הגיאוגרפיות.
--gmp-popover-pixel-offset-y
ההיסט בציר ה-Y, בפיקסלים, של קצה החלונית הקופצת מהנקודה במפה שבה החלונית הקופצת מעוגנת בקואורדינטות הגיאוגרפיות שלה.
background-color
צבע הרקע של החלון הקופץ. פרטים נוספים זמינים במסמכי התיעוד של background-color. חשוב לדעת שהמאפיין הזה משפיע גם על חלון הקופץ של המקום שמוגדר כברירת מחדל. כדי להימנע מעיצוב של חלון ברירת המחדל הקופץ של המקום, השתמשו במחלקות CSS מטורגטות או בסגנונות מוטבעים בחלונות קופצים בהתאמה אישית.
border-radius
רדיוס הגבול של חלון הפופ-אובר. פרטים נוספים זמינים במסמכי התיעוד של border-radius. חשוב לדעת שהמאפיין הזה משפיע גם על חלון הקופץ של המקום שמוגדר כברירת מחדל. כדי להימנע מעיצוב של חלון ברירת המחדל הקופץ של המקום, השתמשו במחלקות CSS מטורגטות או בסגנונות מוטבעים בחלונות קופצים בהתאמה אישית.
box-shadow
הצללית של תיבת הפופ-אובר. פרטים נוספים זמינים במסמכי התיעוד של box-shadow. חשוב לדעת שהמאפיין הזה משפיע גם על חלון הקופץ של המקום שמוגדר כברירת מחדל. כדי להימנע מעיצוב של חלון ברירת המחדל הקופץ של המקום, השתמשו במחלקות CSS מטורגטות או בסגנונות מוטבעים בחלונות קופצים בהתאמה אישית.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את החלון הקופץ הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. אם לא מציינים ערך, ברירת המחדל היא ערכת הצבעים שהמשתמש מעדיף.
padding
המרווח הפנימי של החלון הקופץ. פרטים נוספים זמינים במסמכי התיעוד של padding. חשוב לדעת שהמאפיין הזה משפיע גם על חלון הקופץ של המקום שמוגדר כברירת מחדל. כדי להימנע מעיצוב של חלון ברירת המחדל הקופץ של המקום, השתמשו במחלקות CSS מטורגטות או בסגנונות מוטבעים בחלונות קופצים בהתאמה אישית.
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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק PopoverElementOptions

ממשק google.maps.maps3d.PopoverElementOptions

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

altitudeMode optional
סוג:  AltitudeMode optional
autoPanDisabled optional
סוג:  boolean optional
lightDismissDisabled optional
סוג:  boolean optional
open optional
סוג:  boolean optional
positionAnchor optional

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