GoogleMapsJavaScriptAPIで現在地マーカーを表示する方法

自作の「氷点下コーラの全国マップ」をMaps JavaScript APIで作っていたとき、現在地の青い点と現在地ボタンを付けたくなりました。

ところが、Googleマップのアプリでおなじみのあの青い点も、押すと現在地に飛ぶボタンも、Maps JavaScript APIには用意されていませんでした。

相変わらず痒いところに手が届かないので、自前で作りました。

この記事では、青い点と周りの円の出し方と、現在地ボタンの置き方をまとめます。

忙しい人向け

Maps JavaScript APIには、現在地を表示する機能もボタンもありません。

公式の現在地のサンプル(Geolocation)でも、ブラウザのGeolocation APIで位置を取り、自分で作ったボタンを地図に置いています。

青い点は、google.maps.Markerのアイコンに組み込みの円の記号(SymbolPath.CIRCLE)を指定すれば作れます。

周りの薄い円はgoogle.maps.Circleで重ねます。

マーカーと円は別々の変数に入れておかないと、作り直すときに古いほうが地図に残ります。

前提条件

  • Maps JavaScript APIで地図を表示している
  • 現在地はブラウザのGeolocation APIで取る(HTTPSのページで、利用者が位置情報の利用を許可している)
  • 現在地ボタンの画像は自分で用意する

発生環境

  • macOS/Google Chrome
  • Vue: 3.4.30(Vue CLI 5で作成)
  • @googlemaps/js-api-loader: 1.16.6
  • Maps JavaScript API: weeklyチャネル

※ バージョンはマップのソースのpackage-lock.jsonで確かめた値です。

問題発生時のファイル構成(例)

src/
├─ App.vue                      # 地図の初期化・現在地ボタン・現在地マーカーをここで作っていた
└─ assets/
   └─ currentLocation.png      # 現在地ボタンの画像(フリー素材)

現在地の機能が無い理由

Maps JavaScript APIの地図に最初から付いてくるのは、ズーム・地図の種類の切り替え・全画面表示・ストリートビューなどのコントロールです(コントロールの一覧)。

現在地を表示するコントロールは、この中にありません。

Googleの公式サンプルも「Geolocation APIで位置を取る → 地図を動かす → 自作のボタンから呼ぶ」という形になっています。

対処手順

手順1: 現在地に青い点と円を描く

青い点の部分は、Qiitaの記事のコードをほぼそのまま使わせてもらいました。

navigator.geolocation.getCurrentPositionで位置が取れたら、地図をそこへ動かして、マーカーと円を置きます。

function moveToCurrentLocation() {
  navigator.geolocation.getCurrentPosition(
    (pos) => {
      const lat = pos.coords.latitude;
      const lng = pos.coords.longitude;

      // マップを現在地に移動
      vm.map.setCenter({ lat, lng });
      vm.map.setZoom(15);

      // 既存の現在地マーカーがある場合、削除する
      if (vm.currentLocationMarker) {
        vm.currentLocationMarker.setMap(null);
        vm.currentLocationMarker = null;
        vm.currentLocationCircle.setMap(null);
        vm.currentLocationCircle = null;
      }

      // 現在地を示すマーカー(青い円形)
      vm.currentLocationMarker = new google.maps.Marker({
        position: { lat, lng },
        map: vm.map,
        icon: {
          path: google.maps.SymbolPath.CIRCLE,
          fillColor: "#115EC3",
          fillOpacity: 1,
          strokeColor: "white",
          strokeWeight: 2,
          scale: 7,
        },
      });

      // 現在地の周りの薄い円(半径100m)
      vm.currentLocationCircle = new google.maps.Circle({
        strokeColor: "#115EC3",
        strokeOpacity: 0.2,
        strokeWeight: 1,
        fillColor: "#115EC3",
        fillOpacity: 0.2,
        map: vm.map,
        center: { lat, lng },
        radius: 100,
      });
    },
    (error) => {
      console.error("現在地を取得できませんでした:", error);
    }
  );
}

SymbolPath.CIRCLEは、画像を用意しなくても使える組み込みの記号です。

scaleで大きさを、strokeColorとstrokeWeightで白いふちを付けています。

Circleのradiusはメートル単位なので、ズームしても地図の上で半径100mの円のままです。

手順2: マーカーと円は別の変数に入れる

最初は、マーカーも円もcurrentLocationMarkerという1つの変数に入れていました。

ところが、ボタンを押し直したときにsetMap(null)で消そうとすると、うまく消えませんでした。

1つの変数には1つのオブジェクトしか入らないので、あとから円を入れた時点で、マーカーへの参照は上書きされて無くなります。

その状態でsetMap(null)を呼んでも消えるのは円だけで、マーカーは地図に残ったままでした。

そこで、マーカーはcurrentLocationMarker、円はcurrentLocationCircleと分けて持ち、それぞれsetMap(null)で消してから作り直すようにしました。

手順3: 地図の右下に現在地ボタンを置く

青い点と円はサンプルがあったので簡単でしたが、現在地ボタンのほうは面倒でした。

といっても、ChatGPTに作らせたので、そこまで手間ではありませんでした。

フリー素材から現在地ボタンっぽい画像を持ってきて、divの背景にしています。

大きさは、既定のズームボタンに合わせて40pxの四角にしました。

// 画像をインポート
import currentLocationIcon from "@/assets/currentLocation.png";

const locationButton = document.createElement("div");
locationButton.style.width = "40px"; // ボタンのサイズを画像に合わせる
locationButton.style.height = "40px";
locationButton.style.backgroundImage = `url(${currentLocationIcon})`;
locationButton.style.backgroundSize = "cover"; // 画像がボタンにフィットするよう調整
locationButton.style.backgroundColor = "#fff";
locationButton.style.border = "none";
locationButton.style.borderRadius = "0%"; // 四角にする
locationButton.style.boxShadow = "0 2px 6px rgba(0, 0, 0, 0.3)";
locationButton.style.cursor = "pointer";
locationButton.style.margin = "10px";
locationButton.title = "現在地を表示";

// ボタンをクリックしたときに現在地に移動
locationButton.addEventListener("click", () => {
  moveToCurrentLocation();
});

// ボタンをマップ右下に追加
vm.map.controls[google.maps.ControlPosition.RIGHT_BOTTOM].push(locationButton);

map.controls[位置]に要素をpushすると、自作の要素を既定のコントロールと同じ場所に並べられます。

この書き方は、公式ガイドのカスタムコントロールの説明どおりです。

ズームボタンもzoomControlOptionsでRIGHT_BOTTOMに置いていたので、右下にズームボタンと現在地ボタンが並びます。

手順4: 地図の上で確かめる

右下の現在地ボタンを押すと、地図が現在地へ移動して、青い点と薄い円が表示されました。

氷点下コーラの全国マップに現在地を表示したところ(青い点と周りの薄い円)

ボタンの画像はフリー素材で、再配布にあたるおそれがあるので、ボタンが写った画像は載せていません。

補足: google.maps.Markerは非推奨になっている

この記事のコードはgoogle.maps.Markerを使っていますが、google.maps.Markerは2024年2月に非推奨になりました(非推奨の機能の一覧)。

作った当時も動いてはいましたが、いま新しく作るならgoogle.maps.marker.AdvancedMarkerElementに置き換えるのがよさそうです。

まとめ

Maps JavaScript APIに現在地の機能は無いので、Geolocation APIで位置を取り、マーカーと円とボタンを自分で用意する必要がありました。

位置情報の取得に時間がかかることがあるのは、最後まで気になっていたところです。

同じマップのInfoWindowの空白の話はGoogleMapsJavaScriptAPIのInfoWindowの余白を消す方法に、増えたカメラコントロールを消した話はGoogleMapsJavaScriptAPIでCameraControlを無効にする方法に書いています。

なお、氷点下コーラの全国マップはその後OpenStreetMapへ移行し、今は閉鎖しています。

この記事はGoogle Mapsを使っていた当時の記録です。

参考リンク