マップ イベントを処理する
この記事では、マップ イベント クラスの使用方法を示します。 プロパティでは、マップ上とマップの異なるレイヤー上のイベントを強調表示します。 また、HTML マーカーを操作すると、イベントを強調表示することもできます。
マップの操作
マップ イベントのサンプルは、マップを操作するときに発生するイベントの名前を強調表示しています。 このサンプルのソース コードについては、マップ イベントのソース コードを参照してください。
マップの連動
レイヤー イベントのサンプルは、シンボル レイヤーを操作するときに発生するイベントの名前を強調表示しています。 シンボル、バブル、線、および多角形レイヤーではすべて、同じ一連のイベントがサポートされます。 ヒート マップとタイル レイヤーでは、これらのどのイベントもサポートされていません。 このサンプルのソース コードについては、レイヤー イベントのソース コードを参照してください。
HTML マーカーの操作
HTML マーカー レイヤー イベントのサンプルは、HTML マーカー レイヤーを操作するときに発生するイベントの名前を強調表示しています。 このサンプルのソース コードについては、HTML マーカー レイヤー イベントのソース コードを参照してください。
次の表には、サポートされているマップ クラス イベントがすべてリストされています。
| 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 |
次の結果として、マップが画面に描画されるたびに発生します。
|
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 |
ユーザーの操作またはメソッドの結果として、マップでズーム レベル間の遷移が開始される直前に発生します。 |
次のステップ
完全なコードの例については、次の記事を参照してください。