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行ぶんほどの空白がありました。

店名はその空白の下から始まっています。

Googleマップの情報ウィンドウ(閉じるボタンの下に広い空白があり、その下に店名・電話番号・住所)

このときは、店名も電話番号も住所も、すべて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: 前後を比べて確かめる

変更後にマーカーを押し、変更前のスクリーンショットと比べました。

店名が閉じるボタンと同じ行に並び、閉じるボタンの下の空白がなくなっています。

headerContentを設定したGoogleマップの情報ウィンドウ(店名が閉じるボタンと同じ行に並ぶ)

ほかの方法との比較

ほかにも空白を消す方法はありますが、どれも一長一短です。

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

参考リンク