設定攝影機控制項

選取平台: Android iOS JavaScript

使用者可以在地圖上使用手勢,控制攝影機的縮放、傾斜、位置和旋轉角度。您也可以透過程式輔助設定攝影機。

3D 攝影機模型示意圖

The Camera Position

地圖檢視是模擬成一部鏡頭,對準空間中的特定點。攝影機的位置和方向是由經緯度/海拔高度座標、航向、傾斜度、範圍和滾動定義。

緯度、經度、海拔

設定經緯度和海拔高度,即可定義攝影機的初始位置。這些值會合併,以判斷攝影機的位置,而非攝影機指向或對焦的位置。

緯度可以介於正負 90 度 (含首尾)。經度的範圍介於正負 180 度 (含首尾)。海拔高度以高於海平面的公尺數表示。

只要超出這個範圍,都會調整為範圍內最接近的值。舉例來說,如果將緯度指定為 100,值就會設為 90。

標題

航向是指地圖的指南針方向,以度為單位,從正北算起,依順時針方向測量。北邊是 0 度,東邊是 90 度,南邊是 180 度,西邊則是 270 度。

傾斜

傾斜角度是指攝影機相對於垂直軸的角度,以度為單位。傾斜角度為 0 度時,攝影機鏡頭會朝向地球正下方 (天底)。傾斜角度為 90 度時,攝影機鏡頭會朝向航向指定的方向,並與地面平行。

範圍

範圍是指攝影機本身位置與地圖中心之間的距離 (以公尺為單位)。範圍從零公尺 (非常近) 到六千三百萬公尺不等,可讓您從極近的視角一路拉遠,直到看到全球全景。這項設定可有效控制地圖的「放大」或「縮小」程度。

向左/向右旋轉

滾動會設定攝影機相對於地平線的角度,以度為單位。這個參數可用於建立各種效果,例如飛行模擬期間的傾斜,甚至是完整的桶滾,讓攝影機繞著觀看軸旋轉。

控制相機

下列程式碼範例示範如何以程式輔助方式控制攝影機。

Swift


public static var sanFrancisco: Camera = .init(
  latitude: 37.7845812,
  longitude: -122.3660241,
  altitude: 585,
  heading: 288.0,
  tilt: 75.0,
  roll: 0.0,
  range: 100)