Draw on the map

המחלקה MarkerElement

google.maps.maps3d.MarkerElement class
extends HTMLElement
implements MarkerElementOptions
library "maps3d"

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

      
<gmp-marker
  altitude-mode="value-name"
  anchor-left="string"
  anchor-top="string"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  position="lat,lng"
  title="string">
</gmp-marker>
const {MarkerElement} = await google.maps.importLibrary("maps3d");
MarkerElement
MarkerElement([options])
פרמטרים:
יוצרת MarkerElement עם האפשרויות שצוינו.
altitudeMode
attr: altitude-mode
סוג הקלט: AltitudeMode optional
סוג הפלט: AltitudeMode
ברירת המחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך רכיב הגובה של המיקום מפורש.
מאפיין HTML: altitude-mode="value-name"
anchorLeft
attr: anchor-left
סוג הקלט: string optional
סוג הפלט: string
ברירת המחדל: ‎-50%
ערך CSS length-percentage שמשמש להסטת נקודת העיגון מהפינה השמאלית העליונה של הסמן. האפשרות הזו שימושית כשמשתמשים ברכיב חזותי עם נקודת עיגון שונה מהנקודה הרגילה במרכז התחתון של סמן ברירת המחדל.
מאפיין HTML: anchor-left="string"
anchorTop
attr: anchor-top
סוג הקלט: string optional
סוג הפלט: string
ברירת המחדל: ‎-100%
ערך CSS length-percentage שמשמש להסטת נקודת העיגון מהפינה השמאלית העליונה של הסמן. האפשרות הזו שימושית כשמשתמשים ברכיב חזותי עם נקודת עיגון שונה מהנקודה הרגילה במרכז התחתון של סמן ברירת המחדל.
מאפיין HTML: anchor-top="string"
AlphaautofitsCamera
attr: autofits-camera
סוג: boolean optional
ברירת המחדל: false
אם צוין סמן, הוא יוצג באזור התצוגה של המפה, לצד כל שאר הרכיבים שהוגדרו להצגה.
מאפיין HTML: autofits-camera
collisionBehavior
attr: collision-behavior
סוג הקלט: CollisionBehavior optional
סוג הפלט: CollisionBehavior
ברירת המחדל: CollisionBehavior.REQUIRED
רשימה שמציינת איך MarkerElement צריך להתנהג כשהוא מתנגש עם MarkerElement, Marker3DElement או עם התוויות של מפת הבסיס.
מאפיין HTML: collision-behavior="value-name"
collisionPriority
attr: collision-priority
סוג הקלט: number optional
סוג הפלט: number optional
מספר שמשמש לקביעת העדיפות היחסית בין סמני CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY (כולל Marker3DElement). ערך collisionPriority גבוה יותר מציין עדיפות גבוהה יותר.
מאפיין HTML: collision-priority="number"
position
attr: position
סוג הקלט: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
סוג הפלט: LatLngAltitude optional
המיקום של קצה הסמן. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
מאפיין HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
title
attr: title
סוג: string
טקסט שמופיע כשמעבירים את העכבר מעל התמונה. אם צוין טקסט נגישות (למשל, לשימוש עם קוראי מסך), הוא יתווסף ל-MarkerElement עם הערך שצוין.
מאפיין HTML: title="string"
default
כל רכיב בהתאמה אישית שנוסף ישירות ל-MarkerElement ימוקם.
z-index
ה-z-index של הסמן הזה. פרטים נוספים זמינים במסמכי התיעוד של z-index. סמנים חופפים עם ערך z-index גדול יותר מכסים את הסמנים עם ערך קטן יותר. כברירת מחדל, הסמנים מוצגים לפי המיקום שלהם ב-DOM. סמנים שנוספו ל-DOM בשלב מאוחר יותר מופיעים לפני סמנים שנוספו ל-DOM בשלב מוקדם יותר.
בירושה: addEventListener, removeEventListener

ממשק MarkerElementOptions

ממשק google.maps.maps3d.MarkerElementOptions

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

altitudeMode
אופציונלי
סוג: AltitudeMode optional
anchorLeft
אופציונלי
סוג: string optional
anchorTop
אופציונלי
סוג: string optional
AlphaautofitsCamera
אופציונלי
סוג: boolean optional
collisionBehavior
אופציונלי
סוג: CollisionBehavior optional
collisionPriority
אופציונלי
סוג: number optional
position
אופציונלי
title
אופציונלי
סוג: string optional

המחלקה MarkerInteractiveElement

google.maps.maps3d.MarkerInteractiveElement class
extends MarkerElement
implements MarkerInteractiveElementOptions
library "maps3d"

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

<gmp-marker-interactive
  gmp-popover-target-element="popover-id">
</gmp-marker-interactive>
const {MarkerInteractiveElement} = await google.maps.importLibrary("maps3d");
MarkerInteractiveElement
MarkerInteractiveElement([options])
פרמטרים:
יוצרת MarkerInteractiveElement עם האפשרויות שצוינו.
gmpPopoverTargetElement
attr: gmp-popover-target-element
סוג הקלט: PopoverElement optional
סוג הפלט: PopoverElement optional
כשההגדרה הזו מופעלת, רכיב ה-popover ייפתח בלחיצה על הסמן הזה.
מאפיין HTML: gmp-popover-target-element="popover-id"
עברו בירושה: altitudeMode (מאפיין: altitude-mode), anchorLeft (מאפיין: anchor-left), anchorTop (מאפיין: anchor-top), AlphaautofitsCamera (מאפיין: autofits-camera), collisionBehavior (מאפיין: collision-behavior), collisionPriority (מאפיין: collision-priority), position (מאפיין: position), title (מאפיין: title)
בירושה: default
בירושה: z-index
בירושה: addEventListener, removeEventListener
gmp-click
function(clickEvent)
ארגומנטים:
האירוע הזה מופעל כשלוחצים על הרכיב MarkerInteractiveElement.

ממשק MarkerInteractiveElementOptions

google.maps.maps3d.MarkerInteractiveElementOptions interface
extends MarkerElementOptions

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

gmpPopoverTargetElement
אופציונלי
סוג: PopoverElement optional
‫עברו בירושה: altitudeMode, anchorLeft, anchorTop, AlphaautofitsCamera, collisionBehavior, collisionPriority, position, title

Marker3DElement class

google.maps.maps3d.Marker3DElement class
extends HTMLElement
implements Marker3DElementOptions
library "maps3d"

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

     
<gmp-marker-3d
  altitude-mode="value-name"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  draws-when-occluded
  extruded
  label="string"
  position="lat,lng"
  size-preserved
  z-index="number">
</gmp-marker-3d>
const {Marker3DElement} = await google.maps.importLibrary("maps3d");
Marker3DElement
Marker3DElement([options])
פרמטרים:
יוצרת Marker3DElement עם האפשרויות שצוינו.
altitudeMode
attr: altitude-mode
סוג הקלט: AltitudeMode optional
סוג הפלט: AltitudeMode
ברירת המחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך רכיב הגובה של המיקום מפורש.
מאפיין HTML: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם צוין סמן, הוא יוצג באזור התצוגה של המפה, לצד כל שאר הרכיבים שהוגדרו להצגה.
מאפיין HTML: autofits-camera
collisionBehavior
attr: collision-behavior
סוג הקלט: CollisionBehavior optional
סוג הפלט: CollisionBehavior
ברירת המחדל: CollisionBehavior.REQUIRED
רשימה שמציינת איך Marker3DElement צריך להתנהג כשהוא מתנגש עם Marker3DElement אחר או עם התוויות של מפת הבסיס.
מאפיין HTML: collision-behavior="value-name"
collisionPriority
attr: collision-priority
סוג הקלט: number optional
סוג הפלט: number optional
עדיפות ההתנגשות שמשמשת לזיהוי התנגשויות.
מאפיין HTML: collision-priority="number"
drawsWhenOccluded
attr: draws-when-occluded
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם צריך לשרטט את הסמן הזה או לא כשהוא מוסתר. הסמן יכול להיות מוסתר על ידי גיאומטריה של המפה (למשל, בניינים).
מאפיין HTML: draws-when-occluded
extruded
attr: extruded
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציינת אם לחבר את הסמן לקרקע. כדי להבליט סמן, הערך של altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.
מאפיין HTML: extruded
label
attr: label
סוג הקלט: string optional
סוג הפלט: string optional
הטקסט שיוצג על ידי הסמן הזה.
מאפיין HTML: label="string"
position
attr: position
סוג הקלט: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
סוג הפלט: LatLngAltitude optional
המיקום של קצה הסמן. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
מאפיין HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
sizePreserved
attr: size-preserved
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם הסמן הזה צריך לשמור על הגודל שלו או לא, ללא קשר למרחק מהמצלמה. כברירת מחדל, הסמן משתנה בהתאם למרחק מהמצלמה או להטיה.
מאפיין HTML: size-preserved
zIndex
attr: z-index
סוג הקלט: number optional
סוג הפלט: number optional
ה-zIndex בהשוואה לסמנים אחרים.
מאפיין HTML: z-index="number"
default
כל רכיב בהתאמה אישית שנוסף ישירות אל Marker3DElement יוקצה, אבל רק רכיבים מהסוגים HTMLImageElement,‏ SVGElement ו-PinElement ישמשו לשרטוט סמנים, והמערכת תתעלם מרכיבים אחרים.
HTMLImageElement ו-SVGElement צריכים להיות תחומים ברכיב <template> לפני שמשייכים אותם למשבצת ברירת המחדל של Marker3DElement.

תמונות וקובצי SVG עוברים כרגע רסטריזציה לפני שהם מוצגים בסצנת התלת-ממד, כך שקובצי HTML בהתאמה אישית שמוטמעים בקובצי SVG או במחלקות CSS שנוספו לתמונות לא יופעלו, ויכול להיות שהם לא יופיעו כשהסמנים יוצגו במסך.
בירושה: addEventListener, removeEventListener

הממשק Marker3DElementOptions

ממשק google.maps.maps3d.Marker3DElementOptions

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

altitudeMode
אופציונלי
סוג: AltitudeMode optional
AlphaautofitsCamera
אופציונלי
סוג: boolean optional
collisionBehavior
אופציונלי
סוג: CollisionBehavior optional
collisionPriority
אופציונלי
סוג: number optional
drawsWhenOccluded
אופציונלי
סוג: boolean optional
extruded
אופציונלי
סוג: boolean optional
label
אופציונלי
סוג: string optional
position
אופציונלי
sizePreserved
אופציונלי
סוג: boolean optional
zIndex
אופציונלי
סוג: number optional

Marker3DInteractiveElement class

google.maps.maps3d.Marker3DInteractiveElement class
extends Marker3DElement
implements Marker3DInteractiveElementOptions
library "maps3d"

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

 
<gmp-marker-3d-interactive
  gmp-popover-target-element="popover-id"
  title="string">
</gmp-marker-3d-interactive>
const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
פרמטרים:
יוצרת Marker3DInteractiveElement עם האפשרויות שצוינו.
gmpPopoverTargetElement
attr: gmp-popover-target-element
סוג הקלט: PopoverElement optional
סוג הפלט: PopoverElement optional
כשההגדרה הזו מופעלת, רכיב ה-popover ייפתח בלחיצה על הסמן הזה.
מאפיין HTML: gmp-popover-target-element="popover-id"
title
attr: title
סוג: string
טקסט שמופיע כשמעבירים את העכבר מעל התמונה. אם צוין טקסט נגישות (למשל, לשימוש עם קוראי מסך), הוא יתווסף ל-Marker3DInteractiveElement עם הערך שצוין.
מאפיין HTML: title="string"
עברו בירושה: altitudeMode (מאפיין: altitude-mode), AlphaautofitsCamera (מאפיין: autofits-camera), collisionBehavior (מאפיין: collision-behavior), collisionPriority (מאפיין: collision-priority), drawsWhenOccluded (מאפיין: draws-when-occluded), extruded (מאפיין: extruded), label (מאפיין: label), position (מאפיין: position), sizePreserved (מאפיין: size-preserved), zIndex (מאפיין: z-index)
default
כל רכיב בהתאמה אישית שנוסף ישירות ל-Marker3DInteractiveElement ימוקם, אבל רק רכיבים מהסוג של PinElement ישמשו לשרטוט סמנים. המערכת תתעלם מרכיבים אחרים.
בירושה: addEventListener, removeEventListener
gmp-click
function(clickEvent)
ארגומנטים:
האירוע הזה מופעל כשלוחצים על הרכיב Marker3DInteractiveElement.

ממשק Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptions interface
extends Marker3DElementOptions

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

gmpPopoverTargetElement
אופציונלי
סוג: PopoverElement optional
title
אופציונלי
סוג: string optional
‫עברו בירושה: altitudeMode, AlphaautofitsCamera, collisionBehavior, collisionPriority, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

הכיתה Model3DElement

google.maps.maps3d.Model3DElement class
extends HTMLElement
implements Model3DElementOptions
library "maps3d"

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

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

    
<gmp-model-3d
  altitude-mode="value-name"
  orientation="heading,tilt,roll"
  position="lat,lng"
  scale="number"
  src="url">
</gmp-model-3d>
const {Model3DElement} = await google.maps.importLibrary("maps3d");
Model3DElement
Model3DElement([options])
פרמטרים:
יוצרת Model3DElement עם האפשרויות שצוינו.
altitudeMode
attr: altitude-mode
סוג הקלט: AltitudeMode optional
סוג הפלט: AltitudeMode
ברירת המחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך לפרש את הגובה במיקום.
מאפיין HTML: altitude-mode="value-name"
orientation
attr: orientation
סוג הקלט: Orientation3D|Orientation3DLiteral optional
סוג הפלט: Orientation3D optional
מתאר את הסיבוב של מערכת הקואורדינטות של מודל תלת-ממדי כדי למקם את המודל במפה התלת-ממדית.

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

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

הערה: אם קובצי המודל של .glb מתארחים באתר או בשרת שונים מהאפליקציה הראשית, חשוב להגדיר את כותרות ה-HTTP הנכונות של CORS. כך האפליקציה יכולה לגשת בצורה מאובטחת לקובצי המודל מהדומיין האחר.
מאפיין HTML: src="url"
בירושה: addEventListener, removeEventListener

ממשק Model3DElementOptions

ממשק google.maps.maps3d.Model3DElementOptions

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

altitudeMode
אופציונלי
סוג: AltitudeMode optional
orientation
אופציונלי
position
אופציונלי
scale
אופציונלי
סוג: number|Vector3D|Vector3DLiteral optional
src
אופציונלי
סוג: string|URL optional

Model3DInteractiveElement class

google.maps.maps3d.Model3DInteractiveElement class
extends Model3DElement
implements Model3DInteractiveElementOptions
library "maps3d"

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

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

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

<gmp-model-3d-interactive></gmp-model-3d-interactive>
const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Model3DInteractiveElement
Model3DInteractiveElement([options])
פרמטרים:
יוצרת Model3DInteractiveElement עם האפשרויות שצוינו.
עברו בירושה: altitudeMode (מאפיין: altitude-mode), orientation (מאפיין: orientation), position (מאפיין: position), scale (מאפיין: scale), src (מאפיין: src)
בירושה: addEventListener, removeEventListener
gmp-click
function(clickEvent)
ארגומנטים:
האירוע הזה מופעל כשלוחצים על הרכיב Model3DInteractiveElement.

ממשק Model3DInteractiveElementOptions

google.maps.maps3d.Model3DInteractiveElementOptions interface
extends Model3DElementOptions

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

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

הכיתה Polyline3DElement

google.maps.maps3d.Polyline3DElement class
extends HTMLElement
implements Polyline3DElementOptions
library "maps3d"

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

      
<gmp-polyline-3d
  altitude-mode="value-name"
  autofits-camera
  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>
const {Polyline3DElement} = await google.maps.importLibrary("maps3d");
Polyline3DElement
Polyline3DElement([options])
פרמטרים:
יוצרת Polyline3DElement עם האפשרויות שצוינו.
altitudeMode
attr: altitude-mode
סוג הקלט: AltitudeMode optional
סוג הפלט: AltitudeMode
ברירת המחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך רכיבי הגובה בקואורדינטות מפורשים.
מאפיין HTML: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם מציינים קו פוליגוני, הוא יוצג באזור התצוגה של המפה, לצד כל שאר הרכיבים שהביעו הסכמה.
מאפיין HTML: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם חלקים מהקו הפוליגוני שעלולים להיות מוסתרים משורטטים או לא. יכול להיות שחלקים מהקווים הפוליגוניים יוסתרו על ידי צורות גיאומטריות במפה (למשל, מבנים).
מאפיין HTML: draws-occluded-segments
extruded
attr: extruded
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם לחבר את הקו הפוליגוני לקרקע. כדי להרחיב קו פוליגוני, הערך של altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.
מאפיין HTML: extruded
geodesic
attr: geodesic
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
כשהערך הוא true, הקצוות של הקו הפוליגוני מפורשים כגאודזיים והם יתאימו לקימור של כדור הארץ. כשהערך הוא false, הקצוות של הקו הפוליגוני מוצגים כקווים ישרים במרחב המסך.
מאפיין HTML: geodesic
outerColor
attr: outer-color
סוג הקלט: string optional
סוג הפלט: string optional
הצבע החיצוני. יש תמיכה בכל הצבעים של CSS3.
מאפיין HTML: outer-color="string"
outerWidth
attr: outer-width
סוג הקלט: number optional
סוג הפלט: number optional
הרוחב החיצוני הוא בין 0.0 ל-1.0. זהו אחוז מתוך strokeWidth.
מאפיין HTML: outer-width="number"
path
attr: path
סוג הקלט: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
סוג הפלט: Array<LatLngAltitude> optional
הרצף המסודר של הקואורדינטות של הקו הפוליגוני. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
מאפיין HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
סוג הקלט: string optional
סוג הפלט: string optional
צבע הקו. יש תמיכה בכל הצבעים של CSS3.
מאפיין HTML: stroke-color="string"
strokeWidth
attr: stroke-width
סוג הקלט: number optional
סוג הפלט: number optional
רוחב הקו בפיקסלים.
מאפיין HTML: stroke-width="number"
zIndex
attr: z-index
סוג הקלט: number optional
סוג הפלט: number optional
ה-zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML: z-index="number"
coordinates
הרצף המסודר של הקואורדינטות של הקו הפוליגוני. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
בירושה: addEventListener, removeEventListener

ממשק Polyline3DElementOptions

ממשק google.maps.maps3d.Polyline3DElementOptions

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

altitudeMode
אופציונלי
סוג: AltitudeMode optional
AlphaautofitsCamera
אופציונלי
סוג: boolean optional
coordinates
אופציונלי
drawsOccludedSegments
אופציונלי
סוג: boolean optional
extruded
אופציונלי
סוג: boolean optional
geodesic
אופציונלי
סוג: boolean optional
outerColor
אופציונלי
סוג: string optional
outerWidth
אופציונלי
סוג: number optional
path
אופציונלי
strokeColor
אופציונלי
סוג: string optional
strokeWidth
אופציונלי
סוג: number optional
zIndex
אופציונלי
סוג: number optional

הכיתה Polyline3DInteractiveElement

google.maps.maps3d.Polyline3DInteractiveElement class
extends Polyline3DElement
implements Polyline3DInteractiveElementOptions
library "maps3d"

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

<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
פרמטרים:
יוצרת Polyline3DInteractiveElement עם האפשרויות שצוינו.
עברו בירושה: altitudeMode (מאפיין: altitude-mode), AlphaautofitsCamera (מאפיין: autofits-camera), drawsOccludedSegments (מאפיין: draws-occluded-segments), extruded (מאפיין: extruded), geodesic (מאפיין: geodesic), outerColor (מאפיין: outer-color), outerWidth (מאפיין: outer-width), path (מאפיין: path), strokeColor (מאפיין: stroke-color), strokeWidth (מאפיין: stroke-width), zIndex (מאפיין: z-index), coordinates
בירושה: addEventListener, removeEventListener
gmp-click
function(clickEvent)
ארגומנטים:
  • ‫clickEvent: LocationClickEvent optional אובייקט האירוע יכיל את מיקום הקליק בקו רוחב, קו אורך וגובה.
האירוע הזה מופעל כשלוחצים על הרכיב Polyline3DInteractiveElement.

ממשק Polyline3DInteractiveElementOptions

google.maps.maps3d.Polyline3DInteractiveElementOptions interface
extends Polyline3DElementOptions

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

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

מחלקה Polygon3DElement

google.maps.maps3d.Polygon3DElement class
extends HTMLElement
implements Polygon3DElementOptions
library "maps3d"

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

    
<gmp-polygon-3d
  autofits-camera
  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>
const {Polygon3DElement} = await google.maps.importLibrary("maps3d");
Polygon3DElement
Polygon3DElement([options])
פרמטרים:
יוצרת Polygon3DElement עם האפשרויות שצוינו.
altitudeMode
סוג הקלט: AltitudeMode optional
סוג הפלט: AltitudeMode
ברירת המחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך רכיבי הגובה בקואורדינטות מפורשים.
AlphaautofitsCamera
attr: autofits-camera
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם צוין פוליגון, הוא יוצג באזור התצוגה של המפה, לצד כל שאר האלמנטים שהביעו הסכמה.
מאפיין HTML: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם חלקים מהפוליגון שעלולים להיות מוסתרים משורטטים או לא. הגיאומטריה של המפה (למשל, מבנים) יכולה להסתיר פוליגונים.
מאפיין HTML: draws-occluded-segments
extruded
attr: extruded
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם לחבר את הפוליגון לקרקע. כדי להוסיף נפח לפוליגון, הערך של altitudeMode צריך להיות RELATIVE_TO_GROUND או ABSOLUTE.
מאפיין HTML: extruded
fillColor
attr: fill-color
סוג הקלט: string optional
סוג הפלט: string optional
צבע המילוי. יש תמיכה בכל הצבעים של CSS3.
מאפיין HTML: fill-color="string"
geodesic
attr: geodesic
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
כשהערך הוא true, קצוות הפוליגון מפורשים כגיאודזיים והם יתאימו לקימור של כדור הארץ. כשהערך הוא false, הקצוות של הפוליגון מוצגים כקווים ישרים במרחב המסך.
מאפיין HTML: geodesic
innerPaths
סוג הקלט: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional
סוג הפלט: Array<Array<LatLngAltitude>> optional
רצף הקואורדינטות המסודר שמציין לולאה סגורה. בניגוד לקווים פוליגוניים, פוליגון יכול להיות מורכב ממסלול אחד או יותר, שיוצרים כמה חיתוכים בתוך הפוליגון.
path
attr: path
סוג הקלט: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
סוג הפלט: Array<LatLngAltitude> optional
רצף הקואורדינטות המסודר שמציין לולאה סגורה. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
מאפיין HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
סוג הקלט: string optional
סוג הפלט: string optional
צבע הקו. יש תמיכה בכל הצבעים של CSS3.
מאפיין HTML: stroke-color="string"
strokeWidth
attr: stroke-width
סוג הקלט: number optional
סוג הפלט: number optional
רוחב הקו בפיקסלים.
מאפיין HTML: stroke-width="number"
zIndex
attr: z-index
סוג הקלט: number optional
סוג הפלט: number optional
ה-zIndex בהשוואה לפוליגונים אחרים.
מאפיין HTML: z-index="number"
outerCoordinates
רצף הקואורדינטות המסודר שמציין לולאה סגורה. במצבים מסוימים המערכת מתעלמת מהגובה, ולכן הוא אופציונלי.
innerCoordinates
רצף הקואורדינטות המסודר שמציין לולאה סגורה. בניגוד לקווים פוליגוניים, פוליגון יכול להיות מורכב ממסלול אחד או יותר, שיוצרים כמה חיתוכים בתוך הפוליגון.
בירושה: addEventListener, removeEventListener

ממשק Polygon3DElementOptions

ממשק google.maps.maps3d.Polygon3DElementOptions

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

altitudeMode
אופציונלי
סוג: AltitudeMode optional
AlphaautofitsCamera
אופציונלי
סוג: boolean optional
drawsOccludedSegments
אופציונלי
סוג: boolean optional
extruded
אופציונלי
סוג: boolean optional
fillColor
אופציונלי
סוג: string optional
geodesic
אופציונלי
סוג: boolean optional
innerCoordinates
אופציונלי
innerPaths
אופציונלי
outerCoordinates
אופציונלי
path
אופציונלי
strokeColor
אופציונלי
סוג: string optional
strokeWidth
אופציונלי
סוג: number optional
zIndex
אופציונלי
סוג: number optional

Polygon3DInteractiveElement class

google.maps.maps3d.Polygon3DInteractiveElement class
extends Polygon3DElement
implements Polygon3DInteractiveElementOptions
library "maps3d"

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

<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
פרמטרים:
יוצרת Polygon3DInteractiveElement עם האפשרויות שצוינו.
עברו בירושה: altitudeMode, AlphaautofitsCamera (מאפיין: autofits-camera), drawsOccludedSegments (מאפיין: draws-occluded-segments), extruded (מאפיין: extruded), fillColor (מאפיין: fill-color), geodesic (מאפיין: geodesic), innerPaths, path (מאפיין: path), strokeColor (מאפיין: stroke-color), strokeWidth (מאפיין: stroke-width), zIndex (מאפיין: z-index), outerCoordinates, innerCoordinates
בירושה: addEventListener, removeEventListener
gmp-click
function(clickEvent)
ארגומנטים:
  • ‫clickEvent: LocationClickEvent optional אובייקט האירוע יכיל את מיקום הקליק בקו רוחב, קו אורך וגובה.
האירוע הזה מופעל כשלוחצים על הרכיב Polygon3DInteractiveElement.

ממשק Polygon3DInteractiveElementOptions

google.maps.maps3d.Polygon3DInteractiveElementOptions interface
extends Polygon3DElementOptions

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

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

המחלקה FlattenerElement

google.maps.maps3d.FlattenerElement class
extends HTMLElement
implements FlattenerElementOptions
library "maps3d"

רכיב יישור משמש ליישור של אזור מסוים במפה.

<gmp-flattener
  path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ...">
</gmp-flattener>
const {FlattenerElement} = await google.maps.importLibrary("maps3d");
FlattenerElement
FlattenerElement([options])
פרמטרים:
innerPaths
סוג הקלט: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional
סוג הפלט: Array<Array<LatLngAltitude>> optional
רצף הקואורדינטות המסודר שמציין לולאה סגורה. הנתיבים האלה מגדירים חורים להחרגה בתוך הנתיב הראשי של הפוליגון, שהוא אזור ההשטחה. אזורים בתוך innerPath פטורים מהשטחה.
path
attr: path
סוג הקלט: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
סוג הפלט: Array<LatLngAltitude> optional
רצף הקואורדינטות המסודר שמציין לולאה סגורה. הלולאה הזו מגדירה את אזור ההשטחה.
מאפיין HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
בירושה: addEventListener, removeEventListener

ממשק FlattenerElementOptions

ממשק google.maps.maps3d.FlattenerElementOptions

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

innerPaths
אופציונלי
path
אופציונלי

המחלקה PopoverElement

google.maps.maps3d.PopoverElement class
extends HTMLElement
implements PopoverElementOptions
library "maps3d"

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

<gmp-popover
  auto-pan-disabled
  light-dismiss-disabled
  open
  position-anchor="lat,lng">
</gmp-popover>
const {PopoverElement} = await google.maps.importLibrary("maps3d");
PopoverElement
PopoverElement([options])
פרמטרים:
altitudeMode
סוג הקלט: AltitudeMode optional
סוג הפלט: AltitudeMode
ברירת המחדל: AltitudeMode.CLAMP_TO_GROUND
מציין איך רכיב הגובה של המיקום מפורש.
autoPanDisabled
attr: auto-pan-disabled
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם הערך הוא True, המפה לא תזוז כדי להציג את החלון הקופץ במלואו כשהוא נפתח.
מאפיין HTML: auto-pan-disabled
lightDismissDisabled
attr: light-dismiss-disabled
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם צריך לסגור את החלון הקופץ הזה בלחיצה מחוץ לחלון או לא. ההתנהגות של "סגירה קלה" דומה להגדרת המאפיין popover="auto", שהוא חלק מ-Popover API של הדפדפן.
מאפיין HTML: light-dismiss-disabled
open
attr: open
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
מציין אם החלון הקופץ הזה צריך להיות פתוח או לא.
מאפיין HTML: open
positionAnchor
attr: position-anchor
המיקום שבו תוצג התיבה הקופצת. אם החלונית הקופצת מעוגנת לסמן אינטראקטיבי, המערכת תשתמש במיקום של הסמן.
מאפיין HTML:
  • position-anchor="lat,lng"
  • position-anchor="lat,lng,altitude"
  • position-anchor="marker-id"
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, removeEventListener

ממשק PopoverElementOptions

ממשק google.maps.maps3d.PopoverElementOptions

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

altitudeMode
אופציונלי
סוג: AltitudeMode optional
autoPanDisabled
אופציונלי
סוג: boolean optional
lightDismissDisabled
אופציונלי
סוג: boolean optional
open
אופציונלי
סוג: boolean optional
positionAnchor
אופציונלי

קבועים של AltitudeMode

google.maps.maps3d.AltitudeMode קבועים
ספרייה "maps3d"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג AltitudeModeString.

const {AltitudeMode} = await google.maps.importLibrary("maps3d");
ABSOLUTE מאפשרת לבטא אובייקטים ביחס לגובה הממוצע של פני הים. זה גם אומר שאם רמת הפירוט של פני השטח משתנה מתחת לאובייקט, המיקום המוחלט שלו יישאר זהה.
CLAMP_TO_GROUND מאפשרת להציג אובייקטים שמונחים על הקרקע. הם יישארו בגובה הקרקע בהתאם לתוואי השטח, בלי קשר לגובה שצוין. אם האובייקט ממוקם מעל גוף מים גדול, הוא יוצב בגובה פני הים.
RELATIVE_TO_GROUND מאפשרת להציג אובייקטים ביחס לפני הקרקע. אם רמת הפירוט של פני השטח משתנה, מיקום האובייקט יישאר קבוע ביחס לקרקע. כשהמיקום הוא מעל מים, הגובה יפורש כערך במטרים מעל פני הים.
RELATIVE_TO_MESH מאפשרת להציג אובייקטים ביחס לנקודה הגבוהה ביותר של הקרקע, המבנה או פני המים. מעל מים, זה יהיה פני המים. מעל פני השטח, זה יהיה פני השטח של המבנה (אם יש מבנה) או פני הקרקע (אם אין מבנים).

המחלקה CirclePathElement

google.maps.maps3d.CirclePathElement class
extends HTMLElement
implements CirclePathElementOptions
library "maps3d"

שכבת-על של מעגל תלת-ממדי על מפה תלת-ממדית.

 
<gmp-circle-path
  center="lat,lng,altitude"
  radius="number">
</gmp-circle-path>
const {CirclePathElement} = await google.maps.importLibrary("maps3d");
CirclePathElement
CirclePathElement([options])
פרמטרים:
יוצרת CirclePathElement עם האפשרויות שצוינו.
center
attr: center
סוג הקלט: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional
סוג הפלט: LatLngAltitude optional
מרכז המעגל.
מאפיין HTML: center="lat,lng,altitude"
radius
attr: radius
סוג הקלט: number optional
סוג הפלט: number optional
רדיוס המעגל במטרים.
מאפיין HTML: radius="number"
בירושה: addEventListener, removeEventListener

ממשק CirclePathElementOptions

ממשק google.maps.maps3d.CirclePathElementOptions

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

center
אופציונלי
radius
אופציונלי
סוג: number optional