設定攝影機控制項

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

The Camera Position

地圖檢視是模擬成一部攝影機，從 3D 空間中的特定點進行拍攝。攝影機的位置和方向 (以及連帶的地圖算繪方式) 是由下列屬性來指定：中心 (攝影機所對準的經緯度/海拔位置)、航向、傾斜角度、範圍和側滾。

中心 (緯度/經度/海拔高度)

中心定義攝影機觀察的 3D 空間特定點。 這是使用 LatLngAltitude 類別指定，該類別會合併經度、緯度和海拔高度的值。這項功能可精確定位攝影機在三維空間中的焦點。

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

標題

攝影機航向是指攝影機所指的方向，以正北方為基準，依順時針方向測量的角度，以度為單位。北邊對應 0 度，東邊對應 90 度，南邊對應 180 度，西邊則對應 270 度。這會決定攝影機繞中心點垂直軸的方向。

傾斜

傾斜角度是指攝影機相對於垂直軸的角度，以度為單位。傾斜角度為 0 度時，攝影機鏡頭會朝向正下方 (天底)。傾斜角度為 90 度表示攝影機水平指向航向指定的方向。

範圍

範圍是指攝影機本身位置與中心點之間的距離 (單位為公尺)。範圍從零公尺 (極近距離) 到六千三百萬公尺不等，可讓您從極近距離一路看到真正的全球視野。這項屬性可有效控制地圖的「放大」或「縮小」程度。

旋轉

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

控制相機

下列程式碼範例示範如何呼叫 setCamera 方法，以程式輔助方式控制攝影機。如要使用這個程式碼範例，請按照「設定」和「在應用程式中加入 3D 地圖」中的操作說明，在 Android Studio 專案中設定基本 3D 地圖。然後，將下列程式碼新增至 MainActivity.kt 檔案：

// Add imports
import com.google.android.gms.maps3d.model.latLngAltitude

...

// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.setCamera(
    camera {
        center = latLngAltitude {
            latitude = 38.743502
            longitude = -109.499374
            altitude = 1467.0
        }
        heading = 350.0
        tilt = 58.1
        range = 138.2
        roll = 0.0
    }
)