Function setMapTileLoadingProgressListener

地図タイルの描画進捗リスナーを登録・解除する — 詳細な使用例

地図タイル・注記・ベクタ地図それぞれの描画完了進捗（0.0〜1.0）を リスナー関数で受け取ります。ローディングインジケーターの制御に使います。

メソッド	対象
setMapTileLoadingProgressListener	地図タイル（背景地図）
removeMapTileLoadingProgressListener	同上 解除
setAnnotationLoadingProgressListener	注記（POIラベル等）
removeAnnotationLoadingProgressListener	同上 解除
setMapVectorLoadingProgressListener	ベクタ地図
removeMapVectorLoadingProgressListener	同上 解除

コールバック引数

LoadingProgressListener は (progress: number) => void の関数型です。 progress は 0.0（開始）〜 1.0（完了）の値が渡されます。

Warning

• ページを離れる前や地図を破棄する前に remove* を呼んでリスナーを解除してください。

Example: ローディングオーバーレイを地図タイル描画完了で非表示にする

import * as GIA from '@ntj/gaia';

map.setMapTileLoadingProgressListener((progress) => {
  loadingOverlay.style.opacity = String(1 - progress);
  if (progress >= 1.0) {
    loadingOverlay.hidden = true;
    map.removeMapTileLoadingProgressListener();
  }
});
Copy

Example: 注記の描画完了後にマーカーを追加する

import * as GIA from '@ntj/gaia';

map.setAnnotationLoadingProgressListener((progress) => {
  if (progress >= 1.0) {
    map.addGLMarkers(markers);
    map.removeAnnotationLoadingProgressListener();
  }
});
Copy

See

• setMapTileLoadingProgressListener
• removeMapTileLoadingProgressListener
• setAnnotationLoadingProgressListener
• removeAnnotationLoadingProgressListener
• setMapVectorLoadingProgressListener
• removeMapVectorLoadingProgressListener