ユーザー インターフェース イベント
このページでは、3D 地図での操作をプログラマティックにリッスンして処理できるインタラクティブなイベントと状態変更通知の概要を説明します。ブラウザ内の JavaScript は「イベント駆動型」です。つまり、プログラムがリッスンしそれに応じてコードを実行するイベントを生成することでユーザー操作に応答します。
イベントには、主に以下の 2 つのタイプがあります。
- ユーザー操作イベント(マウスのクリックなど)。3D 地図のビューポートからコードに伝播されます。このイベントにより、3D 地図環境内でユーザーの直接的なアクションに応答できます。
- 状態変更通知。基盤となる 3D 地図データモデルとレンダリング状態の更新が反映されます。その際には、従来の
property_changed
命名規則が使用されます。
3D マッピング API の各オブジェクトは、一連の名前付きイベントを公開します。これらのイベントに対し、プログラムで組み込みの addEventListener()
関数を使用してイベント リスナーを登録し、イベントが発生したときにロジックを実行できます。次の例は、ユーザーが 3D 地図を操作したときにトリガーされる一般的なイベントを示しています。
次の例は、ユーザーが地図を操作したときにトリガーされるイベントを示しています。
カメラの制限
カメラのパンや最大高度をコントロールするか、特定の地図内でのユーザーの移動を制限する緯度 / 経度の境界を作成することをおすすめします。これには、カメラの制限を使用します。
カメラの制限の仕組みと実装の例については、デモをご覧ください。