カメラの設定を構成する

プラットフォームを選択: Android iOS JavaScript

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

3D カメラモデルを示す図

カメラの位置

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

緯度、経度、高度

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

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

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

見出し

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

傾斜

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

範囲

範囲は、カメラの位置と地図の中心との間の距離をメートル単位で定義します。範囲は 0 メートル(非常に近い距離)から 6, 300 万メートルまで変化し、非常に近い距離から地球全体を見渡す視点まで、さまざまな視点での表示が可能です。これにより、地図の拡大 / 縮小の度合いを効果的に制御できます。

ロール

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

カメラの制御

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

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)