ユーザーは、地図上のジェスチャーを使用して、カメラのズーム、傾斜、位置、回転を制御できます。 カメラはプログラムで構成することもできます。

カメラの位置
地図ビューは、空間内の特定の点を見ているカメラとしてモデル化されています。カメラの位置と向きは、緯度/経度/標高の座標(カメラが向いている「中心」として定義)、方角、傾斜、範囲、ロールによって定義されます。
中心(緯度、経度、標高)
中心 は、カメラが観察している 3D 空間内の特定の点を定義します。これは、緯度、経度、標高の値を組み合わせた LatLngAltitude クラスを使用して指定します。これにより、カメラの焦点の正確な位置を 3 次元で特定できます。
緯度は、-90 ~ 90 度の範囲で指定できます。経度は -180 ~ 180 度の範囲になります。標高は海抜メートルで指定します。
見出し
方角 は、真北から時計回りに測った角度で、地図のコンパス方位を指定します。北は 0 度、東は 90 度、南は 180 度、西は 270 度に対応します。
傾斜
傾斜 は、垂直軸に対するカメラの角度を度単位で指定します。傾斜が 0 度の場合は、カメラが 地球(天底)を真下に向いていることを意味します。傾斜が 90 度の場合は、カメラが方角で指定された方向に水平に向いていることを意味します。
範囲
範囲 は、カメラ自体の位置と地図の中心との間の距離をメートル単位で定義します。範囲は 0 メートル(非常に近い)から 6, 300 万メートルまで変化する可能性があり、非常に近い視点から真にグローバルな視点まで表示できます。これにより、地図の「ズームイン」または「ズームアウト」の表示を効果的に制御できます。
ロール
ロール は、水平線に対するカメラの角度を度単位で設定します。このパラメータを使用すると、フライト シミュレーション中のバンクなどの効果や、カメラの表示軸を中心とした完全なバレルロールを作成できます。
カメラの制御
次のコードサンプルは、 メソッドを呼び出して、カメラを プログラムで制御する方法を示しています。setCameraこのコードサンプルを使用するには、
アプリに 3D 地図を設定して追加するの手順に沿って、基本的な 3D 地図で Android Studio プロジェクトを設定します。次に、次のコードを 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
}
)