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を使っていた当時の記録です。



