通知：Google Maps Platform 即将推出全新基本地图样式。此次地图样式更新包括全新默认调色板、经过现代化改进的图钉，以及地图体验和易用性方面的改进。所有地图样式将于 2025 年 3 月自动更新。如需详细了解适用范围以及如何提前选择启用，请参阅全新 Google Maps Platform 地图样式。

此页面由 Cloud Translation API 翻译。

Controls

CameraControlOptions 接口

google.maps.CameraControlOptions 接口

相机控件的显示选项。

属性
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.INLINE_START_BLOCK_END` 位置 ID。用于指定控件在地图上的位置。

FullscreenControlOptions 接口

google.maps.FullscreenControlOptions 接口

用于渲染全屏控件的选项。

属性
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.INLINE_END_BLOCK_START` 位置 ID。用于指定控件在地图上的位置。

MapTypeControlOptions 接口

google.maps.MapTypeControlOptions 接口

用于渲染地图类型控件的选项。

属性
`mapTypeIds optional`	类型： `Array<MapTypeId\|string> optional` 要在控件中显示的地图类型的 ID。
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.BLOCK_START_INLINE_START` 位置 ID。用于指定控件在地图上的位置。
`style optional`	类型： `MapTypeControlStyle optional` 样式 ID。用于选择要显示的地图类型控件的样式。

MapTypeControlStyle 常量

google.maps.MapTypeControlStyle 常量

常见 MapTypesControls 的标识符。

通过调用 const {MapTypeControlStyle} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
`DEFAULT`	使用默认地图类型控件。`DEFAULT` 控件显示时，其大小会因窗口大小和其他因素而异。`DEFAULT` 控件在未来的 API 版本中可能会发生变化。
`DROPDOWN_MENU`	反映屏幕实际使用面积的下拉菜单。
`HORIZONTAL_BAR`	标准的水平单选按钮栏。

MotionTrackingControlOptions 接口

google.maps.MotionTrackingControlOptions 接口

用于渲染动作跟踪控件的选项。

属性
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.INLINE_END_BLOCK_END` 位置 ID。用于指定此控件在全景图中的位置。

PanControlOptions 接口

google.maps.PanControlOptions 接口

用于呈现平移控件的选项。

属性
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.INLINE_END_BLOCK_END` 位置 ID。用于指定控件在地图上的位置。

RotateControlOptions 接口

google.maps.RotateControlOptions 接口

用于呈现旋转控件的选项。

属性
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.INLINE_END_BLOCK_END` 位置 ID。用于指定控件在地图上的位置。

ScaleControlOptions 接口

google.maps.ScaleControlOptions 接口

用于渲染比例控件的选项。

属性
`style optional`	类型： `ScaleControlStyle optional` 样式 ID。用于选择要显示的缩放控件的样式。

ScaleControlStyle 常量

google.maps.ScaleControlStyle 常量

缩放控件 ID 的标识符。

常量
`DEFAULT`	标准缩放控件。

StreetViewControlOptions 接口

google.maps.StreetViewControlOptions 接口

用于在地图上呈现 Street View 街景小人控件的选项。

属性
`position optional`	类型： `ControlPosition optional` 位置 ID。用于指定控件在地图上的位置。默认位置已嵌入到导航（缩放和平移）控件中。如果此位置为空或与 `zoomControlOptions` 或 `panControlOptions` 中指定的位置相同，则街景控件将显示在导航控件中。其他情况下，该控件会单独显示。
`sources optional`	类型： `Iterable<StreetViewSource> optional` 默认值：[`StreetViewSource.DEFAULT`] 用于指定要搜索的全景图片来源。例如，您可以限制仅搜索官方 Google 全景图片。设置多个来源将被评估为这些来源的交集。注意：目前不支持 `StreetViewSource.OUTDOOR` 来源。

ZoomControlOptions 接口

google.maps.ZoomControlOptions 接口

用于呈现缩放控件的选项。

属性
`position optional`	类型： `ControlPosition optional` 默认值： `ControlPosition.INLINE_END_BLOCK_END` 位置 ID。用于指定控件在地图上的位置。

用于指定控件在地图上的位置的标识符。控件相对于同一布局位置中的其他控件而定位。首先添加的控件将定位在靠近地图边缘的位置。建议使用“逻辑值”（请参阅 https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values），以便自动支持从左到右 (LTR) 和从右到左 (RTL) 布局上下文。

LTR 中的逻辑值：

+----------------+ 
| BSIS BSIC BSIE | 
| ISBS      IEBS | 
|                | 
| ISBC      IEBC | 
|                | 
| ISBE      IEBE | 
| BEIS BEIC BEIE | 
+----------------+

在 RTL 中，逻辑值：

+----------------+ 
| BSIE BSIC BSIS | 
| IEBS      ISBS | 
|                | 
| IEBC      ISBC | 
|                | 
| IEBE      ISBE | 
| BEIE BEIC BEIS | 
+----------------+

旧版值：

+----------------+ 
| TL    TC    TR | 
| LT          RT | 
|                | 
| LC          RC | 
|                | 
| LB          RB | 
| BL    BC    BR | 
+----------------+

顶部或底部行的元素会向行中间流动。左侧或右侧列中的元素会流向列中间。

通过调用 const {ControlPosition} = await google.maps.importLibrary("core") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
`BLOCK_END_INLINE_CENTER`	在 LTR 和 RTL 中都等同于 BOTTOM_CENTER。
`BLOCK_END_INLINE_END`	相当于 LTR 中的 BOTTOM_RIGHT，或 RTL 中的 BOTTOM_LEFT。
`BLOCK_END_INLINE_START`	相当于 LTR 中的 BOTTOM_LEFT，或 RTL 中的 BOTTOM_RIGHT。
`BLOCK_START_INLINE_CENTER`	在 LTR 和 RTL 中都等同于 TOP_CENTER。
`BLOCK_START_INLINE_END`	相当于 LTR 中的 TOP_RIGHT 或 RTL 中的 TOP_LEFT。
`BLOCK_START_INLINE_START`	相当于 LTR 中的 TOP_LEFT，或 RTL 中的 TOP_RIGHT。
`BOTTOM_CENTER`	元素位于底行中间。请考虑改用 BLOCK_END_INLINE_CENTER。
`BOTTOM_LEFT`	元素定位在左下角并向中间流动。元素位于 Google 徽标的右侧。请考虑改用 BLOCK_END_INLINE_START。
`BOTTOM_RIGHT`	元素定位在右下角并向中间流动。元素位于版权信息的左侧。请考虑改用 BLOCK_END_INLINE_END。
`INLINE_END_BLOCK_CENTER`	相当于 LTR 中的 RIGHT_CENTER，或 RTL 中的 LEFT_CENTER。
`INLINE_END_BLOCK_END`	相当于 LTR 中的 RIGHT_BOTTOM，或 RTL 中的 LEFT_BOTTOM。
`INLINE_END_BLOCK_START`	相当于 LTR 中的 RIGHT_TOP 或 RTL 中的 LEFT_TOP。
`INLINE_START_BLOCK_CENTER`	相当于 LTR 中的 LEFT_CENTER，或 RTL 中的 RIGHT_CENTER。
`INLINE_START_BLOCK_END`	相当于 LTR 中的 LEFT_BOTTOM，或 RTL 中的 RIGHT_BOTTOM。
`INLINE_START_BLOCK_START`	相当于 LTR 中的 LEFT_TOP，或 RTL 中的 RIGHT_TOP。
`LEFT_BOTTOM`	元素位于左侧，位于左下角元素上方，并向上流动。请考虑改用 INLINE_START_BLOCK_END。
`LEFT_CENTER`	元素位于左侧的中心。请考虑改用 INLINE_START_BLOCK_CENTER。
`LEFT_TOP`	元素位于左侧，位于左上角元素下方，并向下流动。请考虑改用 INLINE_START_BLOCK_START。
`RIGHT_BOTTOM`	元素位于右侧，位于右下角元素上方，并向上流动。请考虑改用 INLINE_END_BLOCK_END。
`RIGHT_CENTER`	元素位于右侧的中心。请考虑改用 INLINE_END_BLOCK_CENTER。
`RIGHT_TOP`	元素位于右侧，位于右上角元素下方，并向下流动。请考虑改用 INLINE_END_BLOCK_START。
`TOP_CENTER`	元素位于顶行中间。请考虑改用 BLOCK_START_INLINE_CENTER。
`TOP_LEFT`	元素位于左上角，并向中间流动。请考虑改用 BLOCK_START_INLINE_START。
`TOP_RIGHT`	元素位于右上角，并向中间流动。请考虑改用 BLOCK_START_INLINE_END。