iimon TECH BLOG

iimonエンジニアが得られた経験や知識を共有して世の中をイイモンにしていくためのブログです

Webアプリに地図機能を入れる方法を作ってた(Leaflet)

はじめに

こんにちは!iimonでエンジニアをしている〇〇です!

「Webアプリに地図を出したい」と思ったとき、最初にこう悩みました。

「地図のライブラリ、種類が多すぎて、どれを使えばいいの?」

いろいろ試した結果、まずは Leaflet が一番おすすめだと感じました。無料で、APIキーもいらず、すぐに動かせるからです。

この記事では、

  • 地図ライブラリにはどんな種類があるか
  • なぜ Leaflet がおすすめなのか
  • かんたんなコード(実際に動くデモつき)
  • Google Maps・MapLibre などほかの選択肢

を、やさしくまとめます。

地図と聞くとむずかしそうですが、やることは大きく3ステップだけです。

① 地図を出す  →  ② ピンを立てる  →  ③ ピンを押したら情報を出す

この3つを順番に見ていきます。

用語 意味
地図ライブラリ 地図を表示・操作するための部品
マーカー 地図に立てるピン。お店や施設の場所を表す
タイル 背景に表示される地図の画像そのもの

Leaflet とは?

Leaflet(リーフレット)は、Webページに地図を表示するための、オープンソースのJavaScriptライブラリです。

  • 2011年に登場し、世界中で広く使われている定番ライブラリ。
  • 軽い(本体が約40KBと小さい)ので、読み込みが速い。
  • スマホ・PC どちらのブラウザでも動く。
  • 地図の画像(タイル)は自分で用意せず、OpenStreetMap などの外部サービスから借りて表示する。だから地図データそのものを持つ必要がない。

ざっくり言うと、「地図の画像を並べて、その上にピンや吹き出しを乗せてくれる部品」です。地図データを作るのではなく、すでにある地図データをWebページ上でいい感じに見せてくれる役割だと考えると分かりやすいです。


なぜ Leaflet がおすすめなのか

地図ライブラリはいくつかありますが、最初の一歩には Leaflet が一番ラクでした。理由は3つです。

  1. 無料:使った分だけお金がかかる、といった心配がありません。
  2. APIキーがいらない:面倒な登録やクレジットカードの設定なしで、すぐ動かせます。
  3. かんたん:数行のコードで地図が出ます。学習コストが低いです。

実際、この記事のデモも Leaflet で作りましたが、あっという間に動きました。

「とりあえず地図を出してみたい」なら、まよわず Leaflet でOKだと思います。もっと高機能なものが必要になったら、あとで乗り換えれば大丈夫です(後半で紹介します)。


かんたんなコード(Leaflet)

Leaflet はこれだけで動きます。

npm install leaflet

① 地図を出す

import L from "leaflet";
import "leaflet/dist/leaflet.css"; // CSSの読み込みを忘れずに!

// 地図を初期化([緯度, 経度], 拡大の度合い)
const map = L.map("map").setView([35.6586, 139.7454], 15);

// 背景の地図(無料のOpenStreetMap。APIキー不要)
L.tileLayer("https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png", {
  attribution: "© OpenStreetMap contributors",
}).addTo(map);

やっていること: 地図を作って、背景の地図画像(タイル)を貼りつけています。 結果: 東京タワーを中心にした地図が表示されます。

💡 setView([緯度, 経度], 拡大) の数字が大きいほど近づきます(15くらいで街のレベル)。

⚠️ この OpenStreetMap のタイルは学習・デモには無料で使えますが、利用ポリシーがあり、アクセスの多い本番アプリでそのまま使うのはNGです。本番では自前のタイルサーバーや有料のタイル配信サービスを使いましょう。

② ピンを立てる

// 地図にピンを立てる
L.marker([35.6586, 139.7454]).addTo(map);

やっていること: 「どこに」ピンを立てるかを指定して、地図に追加します。 結果: 東京タワーの位置にピンが1本立ちます。

③ ピンを押したら吹き出しを出す

// ピンに吹き出し(popup)をつける
L.marker([35.6586, 139.7454])
  .addTo(map)
  .bindPopup("東京タワー🗼"); // ピンを押すと吹き出しが出る

やっていること: ピンに「押されたら出す吹き出し」をつけます。 結果: ピンを押すと「東京タワー🗼」の吹き出しが出ます。

これだけで「地図を出す → ピンを立てる → 押したら情報が出る」ができます。地図って意外とかんたんですね。

これだけで「地図・ピン・吹き出し」がそろいます。しかもAPIキーなし・無料で動いています。Leaflet の手軽さが伝わればうれしいです。


Leaflet でできること(応用)

基本の3ステップが分かると、よく見かける地図の機能も、その延長だと分かります。

  • たくさんのピンを表示: ②のピンを、データの数だけくり返し立てるだけです(店舗一覧・施設一覧など)。
  • ピンを押すと詳細カードが出る: ③の吹き出しの中に、写真や説明などの情報を表示できます。
  • ピンが多すぎるときはまとめる: leaflet.markercluster というプラグインで、近いピンを1つに丸められます。

やっていることは違って見えても、土台は「地図・ピン・吹き出し」の3つです。


ほかの選択肢(Google Maps・MapLibre)

Leaflet で足りないときは、次の2つが候補になります。

① Google Maps

Googleが作っている地図。地図が正確で、機能がとにかく豊富です。

  • いいところ: 経路検索・住所検索(住所→緯度経度)・ストリートビューなどが標準でそろっている。みんな見慣れている。
  • 苦手なこと: APIキーが必要。使った分だけお金がかかる(無料枠あり)。
  • 向いている場面: 経路検索や住所検索など、リッチな機能が必要なとき。

書き方は少し違いますが、考え方(3ステップ)は同じです。

② MapLibre

動きがなめらかで、見た目がリッチな地図。ピンがたくさんあっても速いのが特徴です。

  • いいところ: 拡大・回転・傾き(3D)がぬるぬる動く。大量のピンに強い。無料。
  • 苦手なこと: Leaflet より少しむずかしい。
  • 向いている場面: きれいな地図や3D表現をしたいとき。

かんたん比較表

Leaflet MapLibre Google Maps
おすすめ度(最初の一歩) ◎ ○ ○
料金 無料 無料 有料(無料枠あり)
APIキー いらない いらない いる
かんたんさ ◎ ○ ○
機能の多さ △ ○ ◎
見た目のなめらかさ △ ◎ ◎

選び方: まず Leaflet → もっと機能がほしい → 経路・住所検索なら Google Maps、見た目重視なら MapLibre。


つまずいたこと

① 地図が真っ白になる

コードは合っているのに、地図が真っ白のまま。原因は入れ物の <div> に高さ(height)を指定していなかったことでした。

// ❌ これだと真っ白(高さがない)
<div id="map" />

// ⭕️ 高さを指定すると出る
<div id="map" style={{ height: "400px" }} />

地図は「箱の大きさ」に合わせて表示されるので、箱の高さが0だと何も見えなかった、というわけです。

② CSSの読み込みを忘れる

Leaflet は CSSを読み込まないと表示が崩れます(ボタンやピンがずれる)。import "leaflet/dist/leaflet.css"; を忘れずに。

③ ピンの画像が出ない(Vite/webpack)

npm install leaflet して Vite や webpack で使うと、コードは合っているのにピンの画像だけ出ないことがあります。Leaflet が読み込もうとするピン画像(marker-icon.png)のパスが、バンドラーの都合でズレてしまうのが原因です。次のように画像を import して教えてあげると直ります。

import icon from "leaflet/dist/images/marker-icon.png";
import iconShadow from "leaflet/dist/images/marker-shadow.png";

// デフォルトのピン画像を差し替える
L.Marker.prototype.options.icon = L.icon({
  iconUrl: icon,
  shadowUrl: iconShadow,
});

「コードは正しいのにピンが見えない…」となったら、まずここを疑ってください(よくハマります)。

④ 緯度・経度の順番

Leaflet は [緯度, 経度] の順です。一方 Google Maps は { lat, lng }、MapLibre は [経度, 緯度] と、ライブラリごとに違います。行き来すると混乱するので注意です。


学んだこと

  • 地図ライブラリは Leaflet・MapLibre・Google Maps の3つを覚えておけばOK
  • 最初の一歩は Leaflet がおすすめ。無料・APIキー不要・かんたん
  • もっと機能がほしくなったら乗り換える。やりたいこと(要件)で選ぶ
  • どのライブラリも土台は「地図・ピン・吹き出し」の3ステップ

おわりに

最初は「地図ってむずかしそう」と思っていましたが、①地図を出す ②ピンを立てる ③吹き出しを出す、と分けて考えたら意外とかんたんでした。Leaflet なら準備もほとんどいらないので、気になった方はぜひ試してみてください。

最後まで読んでくださりありがとうございました。

現在弊社ではエンジニアを募集しています! 少しでも興味を持ってくださった方は、ぜひカジュアル面談でお話ししましょう!

iimon採用サイト / Wantedly / Green


参考文献