Function getZoomLevel

  • ズームレベルの取得・設定・ズームイン/アウトを行う — 詳細な使用例

    現在のズームレベルを取得・設定するほか、ズームイン/アウト操作、 ズームレンジ(最小〜最大)の取得・設定、境界判定ができます。

    メソッド 用途
    getZoomLevel() 現在のズームレベルを取得
    setZoomLevel(n) ズームレベルを指定値に設定
    zoomIn() 1段階ズームイン
    zoomOut() 1段階ズームアウト
    getZoomRange() 現在のズームレンジを取得
    setZoomRange(range) 使用可能なズームレンジを制限
    isMaxZoomLevel() 最大ズームレベルか判定
    isMinZoomLevel() 最小ズームレベルか判定

    Returns void

    Warning

    • setZoomLevel の第2引数にアニメーション設定を渡せます: boolean または AnimationOption
    • ズームレベルの変化完了を検知するには addEventListener('zoomend', ...) を併用してください。

    Example: ボタンでズームイン/アウトし、現在値を表示する

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

    zoomInBtn.addEventListener('click', () => map.zoomIn(true));
    zoomOutBtn.addEventListener('click', () => map.zoomOut(true));

    map.addEventListener('zoomend', () => {
    console.log('現在のズームレベル:', map.getZoomLevel());
    });

    Example: ズームレベルをアニメーション付きで設定する

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

    // アニメーションあり(boolean)
    map.setZoomLevel(14, true);

    // アニメーションあり(AnimationOption でduration指定)
    map.setZoomLevel(14, new GIA.value.AnimationOption({ duration: 600 }));

    Example: ズームレンジを制限して最大/最小境界を検知する

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

    map.setZoomRange(new GIA.value.ZoomRange(10, 16));

    map.addEventListener('zoomend', () => {
    if (map.isMaxZoomLevel()) console.log('最大ズーム');
    if (map.isMinZoomLevel()) console.log('最小ズーム');
    });

    See