GoogleMapsJavaScriptAPIのInfoWindowの余白を消す方法

自作の「氷点下コーラの全国マップ」をMaps JavaScript APIで作っていました。
店舗のマーカーを押すとInfoWindow(情報ウィンドウ)が開くのですが、その上のほうに、やたらと広い空白ができていました。
調べてみると、2024年5月のバージョンアップでInfoWindowに「ヘッダー行」が追加されていて、何も設定しないとそのヘッダー行が空のまま残るのが原因でした。
この記事では、空白ができた理由と、headerContentで店名をヘッダー行に入れて空白をなくした手順をまとめます。
忙しい人向け
-
InfoWindowのタイトルを
contentではなくheaderContentに入れると、閉じるボタンと同じ行にタイトルが並び、上の空白が消えます(公式リファレンス) -
headerContentに文字列を渡すと、HTMLではなく書式なしのテキストとして扱われます。見出しのスタイルを付けたいときは、DOM要素(
Element)を作って渡します
前提条件
- Maps JavaScript APIで地図を表示し、マーカーのクリックでInfoWindowを開いている
- InfoWindowの
contentに、店名・電話番号・住所をまとめたHTMLを渡している - APIの読み込みで
weeklyチャネルを使っている
発生環境
- macOS/Google Chrome
- Vue:
3.4.30(Vue CLI 5で作成) @googlemaps/js-api-loader:1.16.6- Maps JavaScript API:
weeklyチャネル - マーカー:
google.maps.marker.AdvancedMarkerElement - 気づいた時期: 2024年10月
※ バージョンはマップのソースのpackage-lock.jsonで確かめた値です。
問題発生時のファイル構成(例)
src/
└─ App.vue # 地図の初期化・マーカーとInfoWindowの作成をここで行っていた
症状
マーカーを押すと、右上の閉じるボタン(×)の下に1行ぶんほどの空白がありました。
店名はその空白の下から始まっています。

このときは、店名も電話番号も住所も、すべてcontentに入れていました。
const infoWindow = new google.maps.InfoWindow({
content: `<div><h2>XXXXX店</h2><p>電話番号:XXXXX</p><p>住所:XXXXX</p></div>`,
});
原因
空白の消し方を色々調べていたら、GOGAさんのブログにInfoWindowの仕様が変わったという記事がありました。
公式のリリースノートでも確かめると、新しい閉じるボタンと任意のヘッダーは、2024年5月28日の3.57.2でweeklyチャネルに入っていました。
氷点下コーラの全国マップはweeklyを読み込んでいたので、作り始めた時点ですでに新しい見た目になっていたわけです。
新しいInfoWindowは、上から「ヘッダー行」と「本文(content)」の2段になっています。
ヘッダー行には、headerContentで指定した内容と閉じるボタンが並びます。
headerContentを指定しないと、ヘッダー行は閉じるボタンだけの行として残り、本文はその下から始まります。
スクリーンショットの空白は、この「閉じるボタンだけのヘッダー行」でした。
対処手順
手順1: タイトルをheaderContentに移す
店名をcontentから外し、headerContentに渡します。
// タイトル用のDOM要素を作成
const headerElement = document.createElement("h2");
headerElement.textContent = "XXXXX店"; // タイトルテキストを設定
headerElement.style.margin = "0";
headerElement.style.padding = "0";
headerElement.style.fontSize = "16px";
const infoWindow = new google.maps.InfoWindow({
headerContent: headerElement,
content: `
<div style="margin: 0; padding: 0;">
<p style="margin: 0; padding: 0;">電話番号:XXXXX</p>
<p style="margin: 0; padding: 0;">住所:XXXXX</p>
</div>`,
});
headerElementのmarginとpaddingを0にしているのは、h2の既定の余白でヘッダー行が縦に広がらないようにするためです。
本文側のpも、同じ理由で余白を消しています。
手順2: 文字列ではなくDOM要素を渡す
最初はheaderContentに"<h2>XXXXX店</h2>"のようなHTMLの文字列を渡しましたが、うまく反映されませんでした(そのときの表示は記録していません)。
公式リファレンスを読み直すと、headerContentの型はstring|Element|Textで、「HTML要素か、書式なしテキストの文字列を指定できる」と書かれていました。
つまり、文字列はHTMLとして解釈されず、ただのテキストとして扱われます。
見出しのタグやスタイルを効かせたいときは、上のコードのようにdocument.createElementで要素を作って渡すのが正しい使い方でした。
店名だけで良ければ、headerContent: "XXXXX店"と文字列で渡してもかまいません。
手順3: Vueのコンポーネントに組み込む
氷点下コーラの全国マップでは、App.vueの中でLoaderを使ってAPIを読み込み、店舗ごとにマーカーとInfoWindowを作っていました。
手順1のコードは、次のforEachの中に入れています。
loader.load().then((google) => {
vm.map = new google.maps.Map(document.getElementById("map"), { /* 省略 */ });
shopList.forEach((shop) => {
const marker = new google.maps.marker.AdvancedMarkerElement({
position: { lat: parseFloat(shop.Lat), lng: parseFloat(shop.Lng) },
map: vm.map,
title: shop.ShopName,
});
// ここで headerElement と infoWindow を作る(手順1のコード)
marker.addListener("click", () => {
infoWindow.open(vm.map, marker);
});
});
});
手順4: 前後を比べて確かめる
変更後にマーカーを押し、変更前のスクリーンショットと比べました。
店名が閉じるボタンと同じ行に並び、閉じるボタンの下の空白がなくなっています。

ほかの方法との比較
ほかにも空白を消す方法はありますが、どれも一長一短です。
-
headerDisabled: trueを指定するヘッダー行ごと消えるので、空白はなくなります。
ただし閉じるボタンも消えるので、閉じる処理を自分で作る必要があります。
-
CSSでヘッダー行の高さを詰める
Google側が付けているクラス名に頼ることになるので、次のバージョンアップで効かなくなるおそれがあります。
-
APIのバージョンを古いものに固定する
当時は
3.56を指定すれば、2025年2月までは従来の見た目のまま使えました(GOGAさんのブログ)。
ヘッダー行を「消す」のではなく「使う」のが、APIの意図に沿った直し方だと思います。
まとめ
InfoWindowの上の空白は、2024年5月にweeklyチャネルへ入ったヘッダー行が、空のまま残っていたものでした。
weeklyを読み込んでいると、こうした見た目の変更がコードを変えなくても入ってきます。
同じマップでは、その後カメラコントロールでも同じことが起きました(GoogleMapsJavaScriptAPIでCameraControlを無効にする方法)。
InfoWindowを1つだけ開く実装は、GoogleMapsJavaScriptAPIでInfoWindowを1つだけ開く方法に書いています。
なお、氷点下コーラの全国マップは、その後2025年8月にOpenStreetMapへ移行し、2026年9月に閉鎖しました。
この記事は、Google Mapsを使っていた当時の記録です。



