地図での操作

リッスンしてプログラマティックに処理できるユーザー インターフェース イベントとエラー イベントについて説明します。

ユーザー インターフェース イベント

このセクションでは、3D 地図での操作をプログラマティックにリッスンして処理できるインタラクティブなイベントと状態変更通知の概要を説明します。ブラウザ内の JavaScript は「イベント駆動型」です。つまり、プログラムがリッスンしそれに応じてコードを実行するイベントを生成することでユーザー操作に応答します。

イベントには、主に以下の 2 つのタイプがあります。

  • ユーザー操作イベント（マウスのクリックなど）。3D 地図のビューポートからコードに伝播されます。このイベントにより、3D 地図環境内でユーザーの直接的なアクションに応答できます。サンプルを表示
  • 状態変更通知。基盤となる 3D 地図データモデルとレンダリング状態の更新が反映されます。その際には、従来の gmp-propertychange 命名規則が使用されます。

各 3D マッピング API オブジェクトは、一連の名前付きイベントを公開します。これらの名前付きイベントは、プログラムでイベント リスナーを登録し、それらのイベントが発生したときに、組み込みの addEventListener() 関数を使用してロジックを実行できます。

次のサンプルは、ユーザーが地図を操作したときにトリガーされるイベントを示しています。