カメラの設定を構成する

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

カメラの位置

地図ビューは、空間内の特定のポイントを見ているカメラとしてモデル化されています。カメラの位置と向きは、緯度/経度/高度の座標、方角、傾斜、範囲、ロールで定義されます。

緯度、経度、高度

カメラの初期位置は、緯度、経度、高度を設定することで定義されます。これらの値を組み合わせることで、カメラが向いている場所や中心に配置されている場所ではなく、カメラが配置されている場所が決まります。

緯度は、-90 ～ 90 度の範囲で指定できます。経度は -180 ～ 180 度の範囲になります。高度は海抜からのメートル単位で指定します。

この範囲以外の値は、この範囲内の最も近い値に設定されます。たとえば、緯度を 100 に指定すると、値は 90 に設定されます。

見出し

方角 は、真北から時計回りに測った角度で、地図のコンパス方位を指定します。北は 0 度、東は 90 度、南は 180 度、西は 270 度に対応します。

傾斜

傾斜 は、垂直軸に対するカメラの角度を度単位で指定します。傾斜が 0 度の場合は、カメラが 地球（天底）を真下に向いていることを意味します。傾斜が 90 度の場合は、カメラが見出しで指定された方向に水平に向いていることを意味します。

範囲

範囲 は、カメラ自体の位置と地図の中心との間の距離をメートル単位で定義します。範囲は 0 メートル（非常に近い）から 6, 300 万メートルまで変化する可能性があり、非常に近いビューから真にグローバルな視点まで表示できます。これにより、地図の「ズームイン」または「ズームアウト」の表示を効果的に制御できます。

ロール

ロール は、水平線に対するカメラの角度を度単位で設定します。このパラメータを使用すると、フライト シミュレーション中のバンクなどの効果や、カメラを視野軸を中心に回転させる完全なバレルロールを作成できます。

カメラの制御

次のコードサンプルは、プログラムでカメラを制御する方法を示しています。