Map3DElement 类
google.maps.maps3d.Map3DElement 类
Map3DElement 是 3D 地图视图的 HTML 接口。
自定义元素：
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>
此类扩展了 HTMLElement。
此类实现了 Map3DElementOptions。
通过调用 const {Map3DElement} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Map3DElement |
Map3DElement([options])参数：
|
属性 | |
|---|---|
bounds |
类型：
LatLngBounds|LatLngBoundsLiteral optional设置后，会将相机的位置限制在指定的 lat/lng 边界内。请注意，边界之外的对象仍会呈现。边界可以同时限制经度和纬度，也可以仅限制纬度或经度。对于仅限纬度的边界，请分别使用 -180 和 180 的西经和东经。对于仅包含经度的边界，请分别使用 90 和 -90 的北纬和南纬。 |
center |
类型：
LatLngAltitude|LatLngAltitudeLiteral optional地图中心，以 LatLngAltitude 的形式给出，其中海拔高度以米为单位。请注意，这不一定是相机所在的位置，因为
range 字段会影响相机与地图中心的距离。如果未设置，则默认为 {lat: 0, lng: 0, altitude: 63170000}。63170000 米是允许的最大海拔高度（地球半径乘以 10）。HTML 属性：
|
defaultLabelsDisabled |
类型：
boolean optional默认值：
false如果设置为
true，则不会渲染默认地图标签。HTML 属性：
|
defaultUIDisabled |
类型：
boolean optional默认值：
false设置为
true 时，所有默认界面按钮都会停用。不会停用键盘和手势控件。HTML 属性：
|
heading |
类型：
number optional地图的罗盘航向角（以度为单位），其中正北为 0。当没有倾斜时，任何滚动都会被解读为航向。
HTML 属性：
|
maxAltitude |
类型：
number optional地图上显示的海拔高度上限。有效值介于
0 和 63170000 米之间（地球半径乘以 10）。HTML 属性：
|
maxHeading |
类型：
number optional地图的航向（旋转）最大角度。有效值应介于
0 到 360 度之间。minHeading 和 maxHeading 表示允许使用标题手势的间隔（小于等于 360 度）。minHeading = 180 和 maxHeading = 90 将允许在 [0, 90] 中使用标题，并在 [180, 360] 中使用标题。minHeading = 90 和 maxHeading = 180 将允许在 [90, 180] 中使用标题。HTML 属性：
|
maxTilt |
类型：
number optional地图的最大入射角。有效值应介于
0 和 90 度之间。HTML 属性：
|
minAltitude |
类型：
number optional地图上显示的海拔高度下限。有效值介于
0 和 63170000 米之间（地球半径乘以 10）。HTML 属性：
|
minHeading |
类型：
number optional地图航向（旋转）的最小角度。有效值应介于
0 到 360 度之间。minHeading 和 maxHeading 表示允许使用标题手势的间隔（小于等于 360 度）。minHeading = 180 和 maxHeading = 90 将允许在 [0, 90] 中使用标题，并在 [180, 360] 中使用标题。minHeading = 90 和 maxHeading = 180 将允许在 [90, 180] 中使用标题。HTML 属性：
|
minTilt |
类型：
number optional地图的最小入射角。有效值应介于
0 和 90 度之间。HTML 属性：
|
range |
类型：
number optional摄像头到地图中心的距离（以米为单位）。
HTML 属性：
|
roll |
类型：
number optional相机绕视图矢量旋转的滚动角度（以度为单位）。为了解决模糊性问题，当没有倾斜度时，任何滚动都会被解读为航向。
HTML 属性：
|
tilt |
类型：
number optional相机视图矢量的倾斜度（以度为单位）。直接向下看地球的视图矢量的倾斜度为 0 度。指向地球以外的视图矢量的倾斜度为
180 度。HTML 属性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])参数：
返回值：
void设置一个函数，以便在有指定事件传送到目标时调用该函数。请参阅 addEventListener |
flyCameraAround |
flyCameraAround(options)参数：
返回值：None
此方法会让相机在指定时长内围绕给定位置旋转，并在该时间内完成指定的圈数。 默认情况下，相机会顺时针旋转。如果为轮次数指定负数，摄像头将改为逆时针方向绕圈。 该方法是异步的，因为动画只能在地图加载到最小量后开始。动画启动后，该方法会返回。 如果轮次数为零，则不会旋转，并且动画会在开始后立即完成。 |
flyCameraTo |
flyCameraTo(options)参数：
返回值：None
此方法会在给定时长内将相机以抛物线的方式从当前位置移动到给定的终点位置。 该方法是异步的，因为动画只能在地图加载到最小量后开始。动画启动后，该方法会返回。 |
|
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前使用 addEventListener 注册的事件监听器。请参阅 removeEventListener |
stopCameraAnimation |
stopCameraAnimation()参数：无
返回值：None
此方法会停止可能正在运行的任何飞入动画。相机会保持在动画播放过程中所在的位置，不会瞬移到终点。 该方法是异步的，因为动画只能在地图加载到最小量后开始或停止。动画停止后，该方法会返回。 |
事件 | |
|---|---|
gmp-animationend |
function(animationEndEvent)参数：
此事件会在飞行动画结束时触发。此事件会通过 DOM 树向上冒泡。 |
gmp-centerchange |
function(centerChangeEvent)参数：
当 Map3DElement 的 center 属性发生变化时，系统会触发此事件。 |
gmp-click |
function(clickEvent)参数：
当用户点击 Map3DElement 元素时，系统会触发此事件。 |
gmp-headingchange |
function(headingChangeEvent)参数：
当 Map3DElement 的 heading 属性发生变化时，系统会触发此事件。 |
gmp-rangechange |
function(rangeChangeEvent)参数：
当 Map3DElement 的 range 属性发生变化时，系统会触发此事件。 |
gmp-rollchange |
function(rollChangeEvent)参数：
当 Map3DElement 的滚动属性发生变化时，系统会触发此事件。 |
gmp-steadychange |
function(steadyChangeEvent)参数：
当 Map3DElement 的稳态发生变化时，系统会触发此事件。 |
gmp-tiltchange |
function(tiltChangeEvent)参数：
当 Map3DElement 的 tilt 属性发生变化时，系统会触发此事件。 |
Map3DElementOptions 接口
google.maps.maps3d.Map3DElementOptions 接口
Map3DElementOptions 对象，用于定义可在 Map3DElement 上设置的属性。
属性 | |
|---|---|
bounds optional |
类型：
LatLngBounds|LatLngBoundsLiteral optional请参阅 Map3DElement.bounds。 |
center optional |
类型：
LatLngAltitude|LatLngAltitudeLiteral optional请参阅 Map3DElement.center。 |
defaultLabelsDisabled optional |
类型：
boolean optional |
defaultUIDisabled optional |
类型：
boolean optional |
heading optional |
类型：
number optional请参阅 Map3DElement.heading。 |
maxAltitude optional |
类型：
number optional |
maxHeading optional |
类型：
number optional |
maxTilt optional |
类型：
number optional请参阅 Map3DElement.maxTilt。 |
minAltitude optional |
类型：
number optional |
minHeading optional |
类型：
number optional |
minTilt optional |
类型：
number optional请参阅 Map3DElement.minTilt。 |
range optional |
类型：
number optional请参阅 Map3DElement.range。 |
roll optional |
类型：
number optional请参阅 Map3DElement.roll。 |
tilt optional |
类型：
number optional请参阅 Map3DElement.tilt。 |
FlyAroundAnimationOptions 接口
google.maps.maps3d.FlyAroundAnimationOptions 接口
FlyCameraAround 动画的自定义选项。
属性 | |
|---|---|
camera |
类型：
CameraOptions相机在环绕动画期间应注视的中心点。请注意，随着相机围绕此中心点旋转，地图朝向将会发生变化。 |
durationMillis optional |
类型：
number optional动画的时长（以毫秒为单位）。这是动画的总时长，而不是单次旋转的时长。 |
rounds optional |
类型：
number optional在指定时长内围绕中心旋转的圈数。这用于控制旋转的整体速度。向 rounds 传递负数会导致相机逆时针旋转，而不是默认的顺时针旋转。 |
FlyToAnimationOptions 接口
google.maps.maps3d.FlyToAnimationOptions 接口
FlyCameraTo 动画的自定义选项。
属性 | |
|---|---|
endCamera |
类型：
CameraOptions相机在动画结束时应指向的位置。 |
durationMillis optional |
类型：
number optional动画的时长（以毫秒为单位）。时长为 0 表示将相机直接瞬移到结束位置。 |
CameraOptions 接口
google.maps.maps3d.CameraOptions 接口
CameraOptions 对象用于定义可在相机对象上设置的属性。摄像头对象可以是具有摄像头位置的任何内容，例如当前的地图状态或未来请求的动画状态。
属性 | |
|---|---|
center optional |
类型：
LatLngAltitude|LatLngAltitudeLiteral optional请参阅 Map3DElement.center。 |
heading optional |
类型：
number optional请参阅 Map3DElement.heading。 |
range optional |
类型：
number optional请参阅 Map3DElement.range。 |
roll optional |
类型：
number optional请参阅 Map3DElement.roll。 |
tilt optional |
类型：
number optional请参阅 Map3DElement.tilt。 |
SteadyChangeEvent 类
google.maps.maps3d.SteadyChangeEvent 类
此事件是通过监控 Map3DElement 的稳定状态创建的。此事件会通过 DOM 树向上冒泡。
此类扩展了 Event。
通过调用 const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
isSteady |
类型：
boolean指示 Map3DElement 是否稳定（即当前场景的所有渲染是否已完成）。 |
LocationClickEvent 类
google.maps.maps3d.LocationClickEvent 类
此事件是通过点击 Map3DElement 创建的。
此类扩展了 Event。
通过调用 const {LocationClickEvent} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
position |
类型：
LatLngAltitude optional事件发生时位于光标下方的纬度/经度/海拔。请注意，在较粗的级别下，返回的数据准确性会降低。此外，如果从更高相机位置点击水面，系统可能会将海底海拔高度作为海拔值返回。此事件会通过 DOM 树向上冒泡。 |
PlaceClickEvent 类
google.maps.maps3d.PlaceClickEvent 类
此事件是通过点击 Map3DElement 创建的。
此类扩展了 LocationClickEvent。
通过调用 const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
属性 | |
|---|---|
placeId |
类型：
string地图项的地点 ID。 |
继承：
position
| |
方法 | |
|---|---|
fetchPlace |
fetchPlace()参数：无
为此地点 ID 提取 Place。在生成的 Place 对象中，系统会填充 id 属性。您可以随后通过 Place.fetchFields() 请求其他字段，前提是您已正常启用 Google 地图 API 并完成结算。如果提取 Place 时出现错误，则 promise 会被拒绝。 |
Marker3DElement 类
google.maps.maps3d.Marker3DElement 类
显示 3D 地图上的位置。请注意，必须设置 position，才能显示 Marker3DElement。
自定义元素：
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>
此类扩展了 HTMLElement。
此类实现了 Marker3DElementOptions。
通过调用 const {Marker3DElement} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Marker3DElement |
Marker3DElement([options])参数：
使用指定的选项创建 Marker3DElement。 |
属性 | |
|---|---|
altitudeMode |
类型：
AltitudeMode optional指定如何解读位置的海拔组件。
HTML 属性：
|
collisionBehavior |
类型：
CollisionBehavior optional一个枚举，用于指定 Marker3DElement 与其他 Marker3DElement 或底图标签发生碰撞时的行为方式。
HTML 属性：
|
drawsWhenOccluded |
类型：
boolean optional默认值：
false指定此标记在被遮挡时是否应绘制。标记可能会被地图几何图形（例如建筑物）遮挡。
HTML 属性：
|
extruded |
类型：
boolean optional默认值：
false指定是否将标记连接到地面。如需拉伸标记，
altitudeMode 必须为 RELATIVE_TO_GROUND 或 ABSOLUTE。HTML 属性：
|
label |
类型：
string optional此标记要显示的文本。
HTML 属性：
|
position |
类型：
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional标记尖端的位置。在某些模式下，系统会忽略海拔，因此海拔是可选的。 |
sizePreserved |
类型：
boolean optional默认值：
false指定此标记是否应保持其大小（无论相机距离如何）。默认情况下，标记会根据相机距离/倾斜度进行缩放。
HTML 属性：
|
zIndex |
类型：
number optional与其他标记相比的 zIndex。
HTML 属性：
|
槽数 | |
|---|---|
default |
直接添加到 Marker3DElement 的任何自定义元素都将被开槽，但是只有 HTMLImageElement、SVGElement 和 PinElement 类型的元素将用于绘制标记，其他元素将被忽略。 HTMLImageElement 和 SVGElement 必须先封装在 <template> 元素中，然后才能分配给 Marker3DElement 的默认槽位。图片和 SVG 目前会先进行光栅化，然后再在 3D 场景中呈现，因此嵌入 SVG 中的自定义 HTML 或添加到图片中的 CSS 类不会应用，并且在屏幕上显示标记时可能不会反映出来。 |
方法 | |
|---|---|
|
addEventListener(type, listener[, options])参数：
返回值：
void设置一个函数，以便在有指定事件传送到目标时调用该函数。请参阅 addEventListener |
|
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前使用 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 |
类型：
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
sizePreserved optional |
类型：
boolean optional |
zIndex optional |
类型：
number optional |
Marker3DInteractiveElement 类
google.maps.maps3d.Marker3DInteractiveElement 类
显示 3D 地图上的位置。请注意，必须设置 position，才能显示 Marker3DInteractiveElement。与 Marker3DElement 不同，Marker3DInteractiveElement 会收到 gmp-click 事件。
自定义元素：
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>
此类扩展了 Marker3DElement。
此类实现了 Marker3DInteractiveElementOptions。
通过调用 const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options])参数：
使用指定的选项创建 Marker3DInteractiveElement。 |
属性 | |
|---|---|
继承：
altitudeMode、collisionBehavior、drawsWhenOccluded、extruded、label、position、sizePreserved、zIndex
|
槽数 | |
|---|---|
default |
直接添加到 Marker3DInteractiveElement 的任何自定义元素都会槽中，但只有 PinElement 类型的元素会用于绘制标记，其他元素将被忽略。 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])参数：
返回值：
void设置一个函数，以便在有指定事件传送到目标时调用该函数。请参阅 addEventListener |
removeEventListener |
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前使用 addEventListener 注册的事件监听器。请参阅 removeEventListener |
事件 | |
|---|---|
gmp-click |
function(clickEvent)参数：
当用户点击 Marker3DInteractiveElement 元素时，系统会触发此事件。 |
Marker3DInteractiveElementOptions 接口
google.maps.maps3d.Marker3DInteractiveElementOptions 接口
Marker3DInteractiveElementOptions 对象，用于定义可在 Marker3DInteractiveElement 上设置的属性。
此接口扩展了 Marker3DElementOptions。
属性 | |
|---|---|
继承：
altitudeMode、collisionBehavior、drawsWhenOccluded、extruded、label、position、sizePreserved、zIndex
|
Model3DElement 类
google.maps.maps3d.Model3DElement 类
允许渲染 gLTF 模型的 3D 模型。请注意，必须设置 position 和 src，才能显示 Model3DElement。
应支持 gLTF PBR 的核心属性。目前不支持任何扩展程序或扩展程序属性。
自定义元素：
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>
此类扩展了 HTMLElement。
此类实现了 Model3DElementOptions。
通过调用 const {Model3DElement} = await google.maps.importLibrary("maps3d") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Model3DElement |
Model3DElement([options])参数：
使用指定的选项创建 Model3DElement。 |
属性 | |
|---|---|
altitudeMode |
类型：
AltitudeMode optional指定如何解读位置中的海拔。
HTML 属性：
|
orientation |
类型：
Orientation3D|Orientation3DLiteral optional介绍了如何旋转 3D 模型的坐标系，以便在 3D 地图上放置模型。 旋转会按以下顺序应用于模型：滚动、倾斜和航向。 |
position |
类型：
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional设置 Model3DElement 的位置。在某些模式下，系统会忽略海拔，因此海拔是可选的。 |
scale |
类型：
number|Vector3D|Vector3DLiteral optional默认值：
1沿模型坐标空间中的 x、y 和 z 轴缩放模型。 |
src |
类型：
string|URL optional指定 3D 模型的网址。目前仅支持
.glb 格式的模型。所有相对 HTTP 网址都将解析为相应的绝对网址。 请注意，如果您将 .glb 模型文件托管在与主应用不同的网站或服务器上，请务必设置正确的 CORS HTTP 标头。这样，您的应用就可以安全地访问其他网域中的模型文件。HTML 属性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])参数：
返回值：
void设置一个函数，以便在有指定事件传送到目标时调用该函数。请参阅 addEventListener |
|
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前使用 addEventListener 注册的事件监听器。请参阅 removeEventListener |
Model3DElementOptions 接口
google.maps.maps3d.Model3DElementOptions 接口
Model3DElementOptions 对象，用于定义可在 Model3DElement 上设置的属性。
属性 | |
|---|---|
altitudeMode optional |
类型：
AltitudeMode optional |
orientation optional |
类型：
Orientation3D|Orientation3DLiteral optional |
position optional |
类型：
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
scale optional |
类型：
number|Vector3D|Vector3DLiteral optional请参阅 Model3DElement.scale。 |
src optional |
类型：
string|URL optional请参阅 Model3DElement.src。 |
Polyline3DElement 类
google.maps.maps3d.Polyline3DElement 类
3D 多段线是 3D 地图上相连线段的线性叠加层。
自定义元素：
<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指定如何解读坐标中的海拔组件。
HTML 属性：
|
coordinates |
类型：
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional折线坐标的有序序列。在某些模式下，系统会忽略海拔，因此海拔是可选的。 |
drawsOccludedSegments |
类型：
boolean optional默认值：
false指定是否绘制多段线可能被遮挡的部分。多段线可能会被地图几何图形（例如建筑物）遮挡。
HTML 属性：
|
extruded |
类型：
boolean optional默认值：
false指定是否将多段线连接到地面。如需拉伸多段线，
altitudeMode 必须为 RELATIVE_TO_GROUND 或 ABSOLUTE。HTML 属性：
|
geodesic |
类型：
boolean optional默认值：
false当
true 时，多段线的边会被解读为测地线，并会遵循地球的曲率。当 false 时，多段线的边缘会在屏幕空间中渲染为直线。HTML 属性：
|
outerColor |
类型：
string optional外部颜色。支持所有 CSS3 颜色。
HTML 属性：
|
outerWidth |
类型：
number optional外部宽度介于
0.0 和 1.0 之间。这是 strokeWidth 的百分比。HTML 属性：
|
strokeColor |
类型：
string optional笔触颜色。支持所有 CSS3 颜色。
HTML 属性：
|
strokeWidth |
类型：
number optional笔触宽度（以像素为单位）。
HTML 属性：
|
zIndex |
类型：
number optional相对于其他折线的 zIndex。
HTML 属性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])参数：
返回值：
void设置一个函数，以便在有指定事件传送到目标时调用该函数。请参阅 addEventListener |
|
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前使用 addEventListener 注册的事件监听器。请参阅 removeEventListener |
Polyline3DElementOptions 接口
google.maps.maps3d.Polyline3DElementOptions 接口
Polyline3DElementOptions 对象，用于定义可在 Polyline3DElement 上设置的属性。
属性 | |
|---|---|
altitudeMode optional |
类型：
AltitudeMode optional |
coordinates optional |
类型：
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
drawsOccludedSegments optional |
类型：
boolean optional |
extruded optional |
类型：
boolean optional |
geodesic optional |
类型：
boolean optional |
outerColor optional |
类型：
string optional |
outerWidth optional |
类型：
number optional |
strokeColor optional |
类型：
string optional |
strokeWidth optional |
类型：
number optional |
zIndex optional |
类型：
number optional |
Polygon3DElement 类
google.maps.maps3d.Polygon3DElement 类
3D 多边形（如 3D 多段线）定义了一系列有序排列的连接坐标。此外，多边形会形成闭合环路并定义填充区域。
自定义元素：
<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指定如何解读坐标中的海拔组件。
HTML 属性：
|
drawsOccludedSegments |
类型：
boolean optional默认值：
false指定是否绘制多边形可能被遮挡的部分。多边形可能会被地图几何图形（例如建筑物）遮挡。
HTML 属性：
|
extruded |
类型：
boolean optional默认值：
false指定是否将多边形连接到地面。如需拉伸多边形，
altitudeMode 必须为 RELATIVE_TO_GROUND 或 ABSOLUTE。HTML 属性：
|
fillColor |
类型：
string optional填充色。支持所有 CSS3 颜色。
HTML 属性：
|
geodesic |
类型：
boolean optional默认值：
false当
true 时，多边形的边会被解释为测地线，并会遵循地球的曲率。当 false 时，多边形的边缘会在屏幕空间中渲染为直线。HTML 属性：
|
innerCoordinates |
类型：
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional用于指定闭合环的坐标的有序序列。与多段线不同，多边形可以由一个或多个路径组成，这些路径会在多边形内创建多个切口。 |
outerCoordinates |
类型：
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional用于指定闭合环的坐标的有序序列。在某些模式下，系统会忽略海拔，因此海拔是可选的。 |
strokeColor |
类型：
string optional笔触颜色。支持所有 CSS3 颜色。
HTML 属性：
|
strokeWidth |
类型：
number optional笔触宽度（以像素为单位）。
HTML 属性：
|
zIndex |
类型：
number optional相对于其他折线的 zIndex。
HTML 属性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])参数：
返回值：
void设置一个函数，以便在有指定事件传送到目标时调用该函数。请参阅 addEventListener |
|
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前使用 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 |
类型：
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional |
outerCoordinates optional |
类型：
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
strokeColor optional |
类型：
string optional |
strokeWidth optional |
类型：
number optional |
zIndex optional |
类型：
number 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 |
允许相对于地面+建筑物+水面的最高点来表示对象。在水上时，此值为水面；在地面上时，此值为建筑物表面（如果有）或地面（如果没有建筑物）。 |