Function setIsConstantAnimated

  • 地図の基本的な挙動(操作・アニメーション・3D表示)を制御する — 詳細な使用例

    メソッド 用途
    setIsConstantAnimated(flag) 恒常的なアニメーション(自動再描画)の有効/無効
    setWheelZoomEnable(flag) マウスホイールによるズームの有効/無効
    setKeyZoomEnable(flag) キーボード操作によるズームの有効/無効
    setDoubleClickZoomEnable(flag) ダブルクリックによるズームイン/アウトの有効/無効
    setMapLongTapMilliseconds(ms) ロングタップと見なす時間(ミリ秒)の設定
    withPausing(task) 描画更新を一時停止した状態でタスクをまとめて実行
    isMapRotationEnabled() 地図の回転操作が有効か取得
    isMapTiltEnabled() 地図の傾き操作が有効か取得
    setMapRotationEnabled(flag) 地図の回転操作の有効/無効を設定
    setMapTiltEnabled(flag) 地図の傾き操作の有効/無効を設定

    恒常的なアニメーション (setIsConstantAnimated)

    • true(デフォルト): 毎フレーム再描画し続けます。動的コンテンツ(アニメーション、UserLocation等)で必要。
    • false: 操作イベント発生時のみ再描画します。静的な表示のみの場合、CPU/GPU 負荷を削減できます。

    操作無効化 (setWheelZoomEnable / setKeyZoomEnable / setDoubleClickZoomEnable)

    • 特定の操作を無効化して意図しないズームを防ぎます。
    • 例: スクロール可能なページに埋め込んだ地図でホイール誤操作を防ぐ場合は setWheelZoomEnable(false)

    描画一時停止 (withPausing)

    • 複数の状態変更を一度にまとめて反映させるときに使います。
    • タスク関数の実行中は描画更新が停止し、終了後に1回だけ再描画されます。

    Returns void

    Example: ページ内埋め込み地図でホイールズームを無効化する

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

    map.setWheelZoomEnable(false); // ホイールズーム無効
    map.setDoubleClickZoomEnable(false); // ダブルクリックズーム無効

    Example: 静的表示のみの地図でアニメーションを止めてCPU負荷を下げる

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

    map.setIsConstantAnimated(false);

    Example: 複数の変更を描画一時停止でまとめて反映する

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

    map.withPausing(() => {
    map.setCenter(new GIA.value.LatLng(35.6762, 139.6503));
    map.setZoomLevel(15);
    map.setTilt(45);
    });

    Example: ロングタップ時間を延長する(雨天モード等で誤検知を抑制)

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

    // デフォルト(500ms程度)より長めに設定
    map.setMapLongTapMilliseconds(800);

    See