設定攝影機控制項

選取平台: Android iOS JavaScript

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

3D 攝影機模型示意圖

The Camera Position

地圖檢視是模擬看向 3D 空間中特定點的攝影機。攝影機的位置和方向(以及地圖的渲染)由以下屬性指定:中心(攝影機所面向的緯度/經度/海拔位置)、航向、傾斜、範圍和滾動。

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

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

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

標題

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

傾斜

傾斜角度是指攝影機相對於垂直軸的角度,以度為單位。傾斜角度為 0 度表示相機面對地球(nadir)。傾斜角度為 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
    }
)