Function setTrackingMode

自位置トラッキングモードを設定・取得し、変更を検知する — 詳細な使用例

地図の自位置マーカーが GPS に追従する「トラッキングモード」を制御します。 モードの変更完了を通知するリスナーを設定・削除することもできます。

メソッド	用途
setTrackingMode(mode)	トラッキングモードを設定
getTrackingMode()	現在のトラッキングモードを取得
setUserLocationTrackingModeChangeListener(fn)	モード変更リスナーを設定
clearUserLocationTrackingModeChangeListener()	モード変更リスナーを削除

UserLocationTrackingMode の主な値

値	挙動
None	トラッキングなし
Follow	地図が自位置に追従して移動
FollowWithHeading	自位置追従かつ進行方向に地図を回転

Warning

• トラッキングを有効にするには setUserLocationData で位置情報を更新し続ける必要があります。
• ユーザーが地図をドラッグすると自動的に None に切り替わる場合があります。 リスナーで変化を検知しUIを更新してください。

Example: トラッキングON/OFFボタンを実装する

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

map.setUserLocationTrackingModeChangeListener((mode) => {
  console.log('トラッキングモード変更:', mode);
  trackingBtn.textContent =
    mode === GIA.UserLocationTrackingMode.Follow ? 'トラッキング中' : 'トラッキングOFF';
});

trackingBtn.addEventListener('click', () => {
  const current = map.getTrackingMode();
  map.setTrackingMode(
    current === GIA.UserLocationTrackingMode.Follow
      ? GIA.UserLocationTrackingMode.None
      : GIA.UserLocationTrackingMode.Follow
  );
});

// 不要になったらリスナーを削除
map.clearUserLocationTrackingModeChangeListener();
Copy

See

• setTrackingMode
• getTrackingMode
• setUserLocationTrackingModeChangeListener
• clearUserLocationTrackingModeChangeListener