カメラの設定を構成する

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

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

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

カメラの位置

地図ビューは、3D 空間内の特定のポイントを見ているカメラとしてモデル化されています。カメラの位置と向き(したがって地図のレンダリング)は、center(カメラが向いている緯度/経度/高度の位置)、heading、tilt、range、roll の各プロパティで指定されます。

中心(緯度/経度/高度)

center は、カメラが観測している 3D 空間内の特定の点を定義します。これは、緯度、経度、高度の値を使用して指定します。これにより、カメラの焦点の 3 次元での正確な位置決めが可能になります。

緯度は、-90 ~ 90 度の範囲で指定できます。この範囲以外の値は、この範囲内の最も近い値に設定されます。たとえば、緯度 100 を指定した場合は、値が 90 に設定されます。経度は -180~180 度の範囲になります。高度は海抜からのメートル単位で指定します。

見出し

カメラの見出しは、カメラが向く方向を真北からの時計回りの角度で指定します。北は 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)