マップ イベントを処理する

  • [アーティクル]

この記事では、マップ イベント クラスの使用方法を示します。 プロパティでは、マップ上とマップの異なるレイヤー上のイベントを強調表示します。 また、HTML マーカーを操作すると、イベントを強調表示することもできます。

マップの操作

マップ イベントのサンプルは、マップを操作するときに発生するイベントの名前を強調表示しています。 このサンプルのソース コードについては、マップ イベントのソース コードを参照してください。

A screenshot showing a map with a list of map events that are highlighted anytime your actions on the map trigger that event.

マップの連動

レイヤー イベントのサンプルは、シンボル レイヤーを操作するときに発生するイベントの名前を強調表示しています。 シンボル、バブル、線、および多角形レイヤーではすべて、同じ一連のイベントがサポートされます。 ヒート マップとタイル レイヤーでは、これらのどのイベントもサポートされていません。 このサンプルのソース コードについては、レイヤー イベントのソース コードを参照してください。

A screenshot showing a map with a list of layer events that are highlighted anytime you interact with the Symbol Layer.

HTML マーカーの操作

HTML マーカー レイヤー イベントのサンプルは、HTML マーカー レイヤーを操作するときに発生するイベントの名前を強調表示しています。 このサンプルのソース コードについては、HTML マーカー レイヤー イベントのソース コードを参照してください。

A screenshot showing a map with a list of HTML marker layer events that are highlighted anytime your actions on the map trigger that event.

次の表には、サポートされているマップ クラス イベントがすべてリストされています。

Event 説明
boxzoomend "ボックス ズーム" 操作が終了したときに発生します。
boxzoomstart "ボックス ズーム" 操作が開始されたときに発生します。
click ポインティング デバイスが、マップ上の同じポイントで押されて解放されたときに発生します。
close ポップアップが手動またはプログラムによって閉じられたときに発生します。
contextmenu マウスの右ボタンがクリックされたときに発生します。
data マップ データのどれかが読み込まれたか変更されたときに発生します。
dataadded DataSource に図形が追加されたときに発生します。
dataremoved DataSource から図形が削除されたときに発生します。
datasourceupdated DataSource オブジェクトが更新されたときに発生します。
dblclick マップ上の同じポイントでポインティング デバイスが 2 回クリックされたときに発生します。
drag マップ、ポップアップ、または HTML マーカーでの "ドラッグしてパン" 操作中に繰り返し発生します。
dragend マップ、ポップアップ、または HTML マーカーで "ドラッグしてパン" 操作が終了したときに発生します。
dragstart マップ、ポップアップ、または HTML マーカーで "ドラッグしてパン" 操作が開始されたときに発生します。
error エラーが発生したときに発生します。
idle

マップが "アイドル" 状態になる前にレンダリングされた最後のフレームの後に発生します。

  • カメラの切り替えが進行中ではありません。
  • 現在要求されているすべてのタイルが読み込まれました。
  • すべてのフェード/切り替えアニメーションが完了しました。
keydown キーが押されたときに発生します。
keypress 入力可能な文字を生成するキー (ANSI キー) が押されたときに発生します。
keyup キーが解放されたときに発生します。
layeradded レイヤーがマップに追加されたときに発生します。
layerremoved レイヤーがマップから削除されたときに発生します。
load 必要なリソースがすべてダウンロードされ、マップの最初の視覚的に完全なレンダリングが行われた直後に発生します。
mousedown マップ内で、または要素に重なっているときにポインティング デバイスが押されると発生します。
mouseenter ポインティング デバイスが最初にマップまたは要素に重なったときに発生します。
mouseleave ポインティング デバイスがマップまたは要素の外に移動したときに発生します。
mousemove ポインティング デバイスがマップまたは要素の中に移動したときに発生します。
mouseout ポイント デバイスがマップのキャンバスまたは要素から離れたときに発生します。
mouseover ポインティング デバイスがマップまたは要素の手前に移動したときに発生します。
mouseup マップ内で、または要素に重なっているときにポインティング デバイスが離されると発生します。
move ユーザーの操作またはメソッドの結果として、ビュー間でのアニメーション化された遷移中に繰り返し発生します。
moveend ユーザーの操作またはメソッドの結果として、マップでビュー間の遷移が完了した直後に発生します。
movestart ユーザーの操作またはメソッドの結果として、マップでビュー間の遷移が開始される直前に発生します。
open ポップアップが手動またはプログラムによって開かれたときに発生します。
pitch ユーザーの操作またはメソッドの結果として、マップのピッチ (傾斜) が変化するたびに発生します。
pitchend ユーザーの操作またはメソッドの結果として、マップのピッチ (傾斜) の変化が終了した直後に発生します。
pitchstart ユーザーの操作またはメソッドの結果として、マップのピッチ (傾斜) の変化が開始されるたびに発生します。
ready マップのプログラムによる操作の準備が整う前に、最小限必要なマップ リソースが読み込まれるときに発生します。
render

次の結果として、マップが画面に描画されるたびに発生します。

  • マップの位置、ズーム、ピッチ、またはベアリングに対する変更。
  • マップのスタイルの変更。
  • DataSource ソースに対する変更。
  • ベクター タイル、GeoJSON ファイル、グリフ、またはスプライトの読み込み。
resize マップのサイズが変更された直後に発生します。
rotate "ドラッグして回転" 操作中に繰り返し発生します。
rotateend "ドラッグして回転" 操作が終了したときに発生します。
rotatestart "ドラッグして回転" 操作が開始されたときに発生します。
shapechanged 図形オブジェクト プロパティが変更されたときに発生します。
sourcedata マップのソースのいずれかが読み込まれたか変更されたときに発生します。これには、ソースに属するタイルが読み込まれたか変更された場合も含まれます。
sourceadded DataSource または VectorTileSource がマップに追加されたときに発生します。
sourceremoved DataSource または VectorTileSource がマップから削除されたときに発生します。
styledata マップのスタイルが読み込まれたか、変更されたときに発生します。
styleimagemissing 存在しない画像スプライトからレイヤーが画像を読み込もうとしたときに発生します
tokenacquired Microsoft Entra アクセス トークンが取得されると発生します。
touchcancel マップ内で touchcancel イベントが発生したときに発生します。
touchend マップ内で touchend イベントが発生したときに発生します。
touchmove マップ内で touchmove イベントが発生したときに発生します。
touchstart マップ内で touchstart イベントが発生したときに発生します。
wheel マップ内でマウスの wheel イベントが発生したときに発生します。
zoom ユーザーの操作またはメソッドの結果として、ズーム レベル間のアニメーション化された遷移中に繰り返し発生します。
zoomend ユーザーの操作またはメソッドの結果として、マップでズーム レベル間の遷移が完了した直後に発生します。
zoomstart ユーザーの操作またはメソッドの結果として、マップでズーム レベル間の遷移が開始される直前に発生します。

次のステップ

完全なコードの例については、次の記事を参照してください。

Azure Maps サービス モジュールの使用

コード サンプル