---
title: FreeCameraOptions
source: https://vjmap.com/en/doc/FreeCameraOptions.html
---

# FreeCameraOptions

用于访问底层相机实体的物理属性的选项。直接访问这些属性可以更灵活和精确地控制相机，同时还与 CameraOptions 完全兼容和可互换。所有字段都是可选的。参见`Map#setFreeCameraOptions`和`Map#getFreeCameraOptions`

### Parameters
- `position` **[MercatorCoordinate][300]**稍微修改过的 web 墨卡托坐标中的相机位置 - 1 个单位的大小是投影世界的宽度，而不是“墨卡托米”。坐标 \[0, 0, 0\] 是西北角，\[1, 1, 0\] 是东南角。
    - Z 坐标是共形的，必须遵守最小和最大缩放值。
    - 缩放是根据高度 (z) 自动计算的
- `orientation` **quat**相机的方向表示为左手坐标空间中的单位四元数 \[x, y, z, w\]。旋转方向是绕各自的轴顺时针旋转。相机的默认姿势是这样的，即前向矢量在 -Z 轴上查找，向上矢量与地图的北方向对齐： forward: \[0, 0, -1\] up: \[0, -1, 0\] right \[1, 0, 0\] 方向可以自由设置，但某些限制仍然适用 - 方向必须只能用俯仰和轴承表示。
    - 间距有上限

### lookAtPoint
通过在地图上定义焦点来设置相机方向的辅助功能。

#### Parameters
- `location` **[LngLatLike][284]**焦点在地图上的位置
- `up` **vec3？**在某些无法从观察方向推导出方位的情况下，相机的向上矢量是必要的。

### setPitchBearing
用于将相机的方向设置为俯仰和方位角的辅助函数。

#### Parameters
- `pitch` **`number`** 俯仰角（度）
- `bearing` **`number`** 以度为单位的轴承角